•“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 ] [ -nbackend ] Options

Table 7-4 bak2db options

Option

Description

backupDirectory

Gives the backup directory path.

 

 

-n

Optional. Specifies the backend name, such as userRoot, which is being restored. This

backendInstance

option is only used for filesystem replica initialization or to restore a single database; it is

 

not necessary to use the -noption to restore the entire directory.

 

 

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-dumpis a shell script wrapper of the cl-dump.pltool to set the appropriate library path.

Syntax

cl-dump[-hhost ] [-pport ] [-DbindDn ] [[ -wbindPassword ] [ -PbindCert ]] [ -rreplicaRoots ] [ -ooutputFile ] [-c ] [-v ]

cl-dump[ -ichangelogFile ] [ -ooutputFile ] [ -c ]

Options Without the -ioption, 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

Option

Description

-c

Dumps and interprets CSN only. This option can be used with or without the -ioption.

 

 

-DbindDn

Specifies the Directory Server's bind DN. Defaults to cn=Directory Manager if the option

 

is omitted.

 

 

-hhost

Specifies the Directory Server's host. This defaults to the server where the script is running.

 

 

-ichangelogFile

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.

 

 

7.3 Shell scripts 217