HP-UX Directory Server 8.1 configuration, command, and file reference

• “start-slapd (Starts the Directory Server)”
• “stop-slapd (Stops the Directory Server)”
• “suffix2instance (Maps a suffix to a backend name)”
• “vlvindex (Creates virtual list view indexes)”
Some of the shell scripts can be executed while the server is running. For others, the server must
be stopped. The description of each script below indicates whether the server must be stopped
or if it can continue to run while executing the script.
When a shell script has a Perl equivalent, there is a cross-reference to the section describing the
equivalent Perl script.
7.3.1 bak2db (Restores a database from backup)
Restores the database from the most recent archived backup. To run this script, the server must
be stopped.
Syntax
bak2db [ backupDirectory ] [ -n backend ]
Options
Table 7-4 bak2db options
DescriptionOption
Gives the backup directory path.
backupDirectory
Optional. Specifies the backend name, such as userRoot, which is being restored. This
option is only used for filesystem replica initialization or to restore a single database; it is
not necessary to use the -n option to restore the entire directory.
-n
backendInstance
For information on the equivalent Perl script, see “bak2db.pl (Restores a database from backup)”.
For more information on restoring databases, see the "Populating directory databases" chapter
in the HP-UX Directory Server administrator guide. For more information on using filesystem
replica initialization, see the "Managing replication" chapter in the HP-UX Directory Server
administrator guide.
7.3.2 cl-dump (Dumps and decodes the changelog)
Troubleshoots replication-related problems. cl-dump is a shell script wrapper of the cl-dump.pl
tool to set the appropriate library path.
Syntax
cl-dump [-h host ] [-p port ] [-D bindDn ] [[ -w bindPassword ] | [ -P bindCert ]] [ -r
replicaRoots ] [ -o outputFile ] [-c ] [-v ]
cl-dump [ -i changelogFile ] [ -o outputFile ] [ -c ]
Options Without the -i option, the script must be run when the Directory Server is running
from a location from which the server's changelog directory is accessible.
Table 7-5 cl-dump options
DescriptionOption
Dumps and interprets CSN only. This option can be used with or without the -i option.
-c
Specifies the Directory Server's bind DN. Defaults to cn=Directory Manager if the option
is omitted.
-D bindDn
Specifies the Directory Server's host. This defaults to the server where the script is running.
-h host
Specifies the path to the changelog file. If there is a changelog file and if certain changes in
that file are base-64 encoded, use this option to decode that changelog.
-i changelogFile
7.3 Shell scripts 217