Locating The Configuration File; Editing The Configuration File; Guidelines For Editing The Configuration File - Red Hat CERTIFICATE SYSTEM 7.3 - ADMINISTRATION Administration Manual

Chapter 3. Administrative Basics
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
68