6.2. Working with Directory Server Instances

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 Administration 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.


Note: This documentation is provided {and copyrighted} by Red Hat®, Inc. and is released via the Open Publication License. The copyright holder has added the further requirement that Distribution of substantively modified versions of this document is prohibited without the explicit permission of the copyright holder. The CentOS project redistributes these original works (in their unmodified form) as a reference for CentOS-5 because CentOS-5 is built from publicly available, open source SRPMS. The documentation is unmodified to be compliant with upstream distribution policy. Neither CentOS-5 nor the CentOS Project are in any way affiliated with or sponsored by Red Hat®, Inc.