17.Restart the Directory Server. The server must be restarted from the command line.

/opt/dirsrv/slapd-example/restart-slapd

When the server restarts, it prompts for the PIN or password to unlock the key database. This is the same password used when the server certificate and key were imported into the database.

Using a pin.txt file to store the token database passwords allows the Directory Server to restart without prompting for the password. This is covered in “Creating a password file for the Directory Server”.

18.Restart the Administration Server. The server must be restarted from the command line.

/opt/dirsrv/sbin/restart-ds-admin

When the server restarts, it prompts for the PIN or password to unlock the key database. This is the same password used when the server certificate and key were imported into the database.

Using a password.conf file to store the token database passwords allows the Administration Server to restart without prompting for the password. This is covered in “Creating a password file for the Administration Server”.

NOTE:

After configuring SSL/TLS for the Administration Server, be certain that the address reads https when next logging into the Administration Server or Directory Console. With SSL/TLS, all connections to the Administration Server must be over HTTPS. Otherwise, the operation will time out, unable to find the server since it is running on a secure connection. After successfully connecting, a dialog box appears to accept the certificate. Click OK to accept the certificate (either only for that current session or permanently).

6.4 Creating password files

If SSL/TLS is enabled for the Directory Server or Administration Server, the server prompts for a password to access the certificate and key databases every time the server is restarted. The servers can restart silently if that password is supplied in a password file which the start scripts can access.

6.4.1 Creating a password file for the Directory Server

It is possible to store the certificate password in a password file. By placing the certificate database password in a file, the server can be started from the Directory Server Console and also restarted automatically when running unattended.

CAUTION:

This password is stored in clear text within the password file, so its usage represents a significant security risk. Do not use a password file if the server is running in an unsecured environment.

The password file must be in the same directory where the other key and certificate databases for Directory Server are stored. This is usually the main configuration directory, /etc/opt/dirsrv/slapd-instance_name. The file should be named pin.txt.

Include the token name and password in the file. For example:

Internal (Software) Token:secret

For the NSS software crypto module (the default software database), the token is always called internal.

The PIN file should be owned by the Directory Server user and set to read-only by the Directory Server user, with no access to anyone other user (mode 0400).

76 Using SSL/TLS with the Console