Installation guide

IMPORTANT
When resetting the Directory Manager's password from the command line, do not use curly
braces ({}) in the password. The root password is stored in the format {password-storage-
scheme}hashed_password. Any characters in curly braces are interpreted by the server as the
password storage scheme for the root password. If that text is not a valid storage scheme or if
the password that follows is not properly hashed, then the Directory Manager cannot bind to the
server.
This script can also be run in silent mode, which means the setup program never opens; the Directory
Server instance values are taken from a specified file. For example:
setup-ds-adm in.pl -s -f file.inf
-s runs the script in silent mode, and -f file.inf specifies the setup file to use. Silent instance
setup and .inf files are described in Section 4.5, “Silent Setup”.
NOTE
New Directory Server instances can be created through the Directory Server Console; this is
described in the Directory Server Administrator's Guide.
4.2.2. Installing Only the Directory Server
The setup-ds.pl command creates an instance of Directory Server without installing the Admin Server
or Directory Server Console (so it is not managed by the Directory Server Console). It works exactly the
same way as setup-ds-adm in.pl, except that the questions about the Configuration Directory Server
and Admin Server are omitted. Using this command to create a Directory Server instance means that the
instance has to be managed through the command line or other tools, or it can be registered with the
Configuration Directory Server to manage it with the Console. See Section 4.3.2, “Registering an Existing
Directory Server Instance with the Configuration Directory Server” for more information.
4.3. Registering Servers Using register-ds-admin.pl
Each instance of Directory Server is, or can be, registered with another Configuration Directory Server
instance and with an Admin Server instance. This registration can be changed using the register-
ds-adm in.pl script.
IMPORTANT
The register-ds-adm in.pl script does not support external LDAP URLs, so the Directory
Server instance must be registered against a local Admin Server.
4.3.1. register-ds-admin.pl Options
Running register-ds-adm in.pl creates a default instance of the Admin Server and Configuration
Directory Server if they do not already exist, then registers any existing Directory Servers with the
Configuration Directory Server.
Chapter 4. Advanced Setup and Configuration
4 5