2.3. Configuration Preparation
When the Certificate System subsystems are configured, some outside information must be available. This includes the following:
Login PIN.
There is a randomly-generated PIN in the preop.pin parameter in the CS.cfg file in the instance conf/ directory. This is used to log into the configuration wizard.
Security domain information.
CAs can create a new security domain, which requires a unique name and a username and password for the CA agent who administers the domain.
All other subsystems must join an existing security name. Have the username and password of the CA agent who administers the domain.
CA information.
If the subsystem is not a CA, then it is necessary to select a CA from a drop-down menu or add an external CA. If a Certificate System CA is selected, then supply the CA agent username and password.
Subsystem information.
When installing a TPS, the CA and TKS subsystems must be installed and configured before installing the TPS; a DRM subsystem must also be installed and configured if server-side key generation is selected. When configuring the TPS, the TKS and DRM to connect with the TPS are selected from a drop-down list of all subsystems within the security domain. The bind information for the selected subsystems must be available.
Directory Server hostname and port number.
The Certificate System uses the user database of the Directory Server to store its information, and the hostname and port number of the LDAP directory is required for the Certificate System to access the database.
Directory Manager DN and password.
The Certificate System must be able to bind to the user database, so a user ID and password must be supplied to bind to the Directory Server. This user is normally the Directory Manager. The default Directory Manager DN is cn=Directory Manager.
Certificate and key recovery files.
If the subsystem being configured is a clone of another subsystem, then the backup files for the master subsystem must be locally accessible.
The ports and file directories in Table 2.16, “Default Subsystem Instance Ports and File Locations” show the default installation and configuration information.
| Susbsystem | SSL Port | Non-SSL Port | Instance Directory |
|---|---|---|---|
| CA | 9443 | 9080 | /var/lib/rhpki-ca |
| DRM | 10443 | 10080 | /var/lib/rhpki-kra |
| OCSP | 11443 | 11080 | /var/lib/rhpki-ocsp |
| TKS | 13443 | 13080 | /var/lib/rhpki-tks |
| TPS | 7889 | 7888 | /var/lib/rhpki-tps |
Table 2.16. Default Subsystem Instance Ports and File Locations
The following certificates are created by default when any of the following subsystem instances are installed:
Certificate Manager
CA signing certificate
OCSP signing certificate (for the CA's internal OCSP service)
SSL server certificate
Subsystem certificate
The subsystem certificate is always issued by the security domain so that domain-level operations that require client authentication are based on this subsystem certificate.
DRM
Transport certificate
Storage certificate
SSL server certificate
Subsystem certificate
OCSP
OCSP signing certificate
SSL server certificate
Subsystem certificate
TKS
SSL server certificate
Subsystem certificate
TPS
SSL server certificate
Subsystem certificate