Installation guide

NOTE

The Directory Server requires the fully-qualified domain name to set up the servers, as described

in Section 1.2.1, “Resolving the Fully-qualified Domain Name”. T he setup script uses the system's

gethostnam e() function to obtain the hostname (such as ldap) and the /etc/resolv.conf

file to identify the domain name (such as example.com ).

Therefore, if there are aliases in the /etc/hosts file that do not match the specified domains in

the /etc/resolv.conf settings, the setup script cannot correctly generate the fully-qualified

domain name as it is used by DNS, and the default options in the prompts are wrong.

WARNING

If Directory Server is already installed on your machine, it is extremely important that you perform

a migration, not a fresh installation. Migration is described in Chapter 5, Migrating from Previous

Versions.

1. After the Directory Server packages are installed as described in Section 3.2, “Installing the

Directory Server Packages”, then launch the setup-ds-admin.pl script.

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

This script allows parameters to be passed with it or to specify configuration files to use. The

options are described more in Section 1.3, “About the setup-ds-admin.pl Script”.

NOTE

Run the setup-ds-adm in.pl script as root.

2. Select y to accept the Red Hat licensing terms.

3. T he dsktune utility runs. Select y to continue with the setup.

dsktune checks the available disk space, processor type, physical memory, and other system

data and settings such as T CP/IP ports and file descriptor settings. If your system does not meet

these basic Red Hat Directory Server requirements, dsktune returns a warning. dsktune

warnings do not block the setup process; simply enter y to go to the next step.

4. Next, choose the setup type. Enter 1 to perform an express setup.

5. T he next step allows you to register your Directory Server with an existing Directory Server

instance, called the Configuration Directory Server. T his registers the new instance so it can be

managed by the Console. If this is the first Directory Server instance set up on your network, it is

not possible to register it with another directory. Select n to set up this Directory Server as a

Configuration Directory Server and move to the next express install step, setting up the

administrator user.

Chapter 3. Setting up Red Hat Directory Server on Red Hat Enterprise Linux