Self-Test Logging; Self-Test Configuration; Modifying Self-Test Configuration - Red Hat CERTIFICATE SYSTEM 7.3 - ADMINISTRATION Administration Manual

Chapter 3. Administrative Basics
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
Section 3.10.3, "Modifying Self-Test Configuration"
CS.cfg file. See

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
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
92
Section 3.9.4, "Buffered Versus Unbuffered
for details.
Logging". Once the buffer