Red Hat CERTIFICATE SYSTEM 7.3 - ADMINISTRATION, Administration Manual

Page: 90 / 554

Chapter 3. Administrative Basics
68
An ASCII file, named
CS.cfg
, is created and populated with the appropriate configuration parameters
when a subsystem is first installed. The way the instance functions are modified is by making changes
through the subsystem console, which is the recommended method. The changes made in the
administrative console are reflected in the configuration file.
It is also possible to edit the
CS.cfg
configuration file directly. Since the TPS subsystem does not
use an administrative console, all configuration changes must be made by editing the
CS.cfg
file
manually.
3.6.1. Locating the Configuration File
Each instance of a Certificate System subsystem has its own configuration file,
CS.cfg
. The file
for the subsystem is different depending on the installation choices and on which subsystem type is
installed.
The
CS.cfg
file is located in the
/var/lib/
instance_ID
/conf
directory.
3.6.2. Editing the Configuration File
WARNING
Do not edit the configuration file directly without being familiar with the configuration
parameters or without being sure that the changes are acceptable to the server. The
Certificate System fails to start if the configuration file is modified incorrectly. Incorrect
configuration can also result in data loss.
To modify the configuration file:
1. Stop the subsystem instance.
The configuration file is stored in the cache when the instance is started. Any changes made to
the instance through the Console are changed in the cached version of the file. When the server
is stopped or restarted, the configuration file stored in the cache is written to disk. Stop the server
before editing the configuration file or the changes will be overwritten by the cached version when
the server is stopped.
2. Open the
/var/lib/
instance_ID
/conf
directory.
3. Open the
CS.cfg
file in a text editor.
4. Edit the parameters in the file, and save the changes.
5. Start the subsystem instance.
3.6.3. Guidelines for Editing the Configuration File
This section covers information and tips about the configuration file.
• The format for parameters is as follows:
#comment
[parameter]=value