6.2. Working with Directory Server Instances

6.2.1. Creating a New Directory Server Instance

Additional instances of the Directory Server can be created from the command line using the setup-ds-admin.pl command. This offers the setup choices (express, typical, and custom) that are described in Chapter 3, Setting up Red Hat Directory Server on Red Hat Enterprise Linux, Chapter 4, Setting up Red Hat Directory Server on HP-UX 11i, and Chapter 5, Setting up Red Hat Directory Server on Sun Solaris.

It is also possible to provide Directory Server parameters on the command line, so that the instance is created with pre-defined defaults. For example:

setup-ds-admin.pl slapd.ServerPort=1100 slapd.RootDNPwd=itsasecret

When the installer runs, the Directory Server port default is 1100, and the Directory Manager password is itsasecret.

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-admin.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 6.3, “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.

6.2.2. (Alternate) Installing Directory Server with setup-ds

There is also a command called setup-ds.pl. This command creates an instance of Directory Server that is not managed by the Directory Server Console. It works exactly the same way as setup-ds-admin.pl except that the questions about the Configuration Directory Server and Administration 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 6.2.3, “Registering an Existing Directory Server Instance with the Configuration Directory Server” for more information.

6.2.3. Registering an Existing Directory Server Instance with the Configuration Directory Server

The Configuration Directory Server uses the o=NetscapeRoot database to store information about the Directory Servers and Administration Servers in your network. This is used by the Console and the Administration Servers. This database can belong to a separate Directory Server instance, called the Configuration Directory Server. There is an option when an instance is first set up to register it with a Configuration Directory Server. It is possible to register an existing Directory Server instance with a Configuration Directory Server using the register-ds-admin script.

/usr/sbin/register-ds-admin.pl

IMPORTANT

Running register-ds-admin creates a default instance of the Administration Server and Configuration Directory Server if they do not already exist, then registers any existing Directory Servers with the Configuration Directory Server.

6.2.4. Updating and Re-registering Directory Server Instances

If the Directory Server instances become broken or outdated, the packages can be updated using the -u option. This command looks for every local Directory Server instance, prompts for the Configuration Directory information, then re-registers each instance with the Configuration Directory. The update and registration process replaces any missing or outdated packages.

/usr/sbin/setup-ds-admin.pl -u