Red Hat CERTIFICATE SYSTEM 7.3 - ADMINISTRATION, Administration Manual

Page: 114 / 554

Chapter 3. Administrative Basics
92
5. The
On-Demand Self Tests Results
window appears, showing the logged events for this run of
the self-tests.
3.10.1. Self-Test Logging
A new log,
selftest.log
, is added to the log directory that contains reports for both the start up
self-tests and the on-demand self-tests. This log is configured by changing the setting for the log in the
CS.cfg
file. See
Section 3.10.3, “Modifying Self-Test Configuration”
for details.
3.10.2. Self-Test Configuration
The self-tests feature and individual self-tests are registered and configured in the
CS.cfg
file. If a
self-test is enabled, that self-test is listed for either on-demand or start up and is either empty or set as
critical
.
Critical self-tests have a semi-colon and the word
critical
after the name of the self-test.
Otherwise, nothing is in this place. The server shuts down when a critical self-test fails during on
demand self-tests; the server will not start when a critical self-test fails during start up.
The implemented self-tests are automatically registered and configured when the instance was
installed. The self-tests that are registered and configured are those associated with the subsystem
type.
Self-tests are turned off or the criticality is changed by changing those setting in the
CS.cfg
file. To
turn a self-test off, remove is from the list of self-tests.
3.10.3. Modifying Self-Test Configuration
To modify the configuration settings for self-tests:
1. Stop the subsystem instance.
2. Open the
CS.cfg
file located in the instance's
conf/
directory.
3. To edit the settings for the self-test log, edit the entries that begin with
selftests.container.logger
. These include the following parameters:
•
bufferSize
. Specify the buffer size in kilobytes (KB) for the log. The default size is 512 KB. For
more information, see
Section 3.9.4, “Buffered Versus Unbuffered Logging”
. Once the buffer
reaches this size, the contents of the buffer are flushed out and copied to the log file.
•
enable
. Specify
true
to enable;
false
to disable. Only enabled logs actually record events.
•
fileName
. Specify the full path, including the filename, to the file to write messages. The server
must have read/write permission to the file.
•
flushInterval
. Specify the interval, in seconds, to flush the buffer to the file. The default interval
is 5 seconds. The
flushInterval
is the amount of time before the contents of the buffer are
flushed out and added to the log file.
•
level
. The default selection is 1; this log is not set up for any level beside 1.
•
maxFileSize
. Specify the file size in kilobytes (KB) for the error log. The default size is 100
KB. The
maxFileSize
determines how large a log file can become before it is rotated. Once