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

Installing and configuring Red Hat Directory Server on Red Hat Enterprise Linux has three major steps:
  1. Install OpenJDK 1.6.0.
  2. Install the Directory Server packages.
  3. Run the setup-ds-admin.pl script. This is where all of the information about the new Directory Server instance is supplied.

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.

NOTE

Before beginning the installation process, make sure that your system meets the requirements in Section 2.3, “Red Hat Enterprise Linux Operating System Requirements”.

NOTE

Red Hat Directory Server is also supported running on a virtual guest on a Red Hat Enterprise Linux 5 virtual server.
There are three interactive ways of setting up Directory Server: express, typical, and custom. These setup types provide different levels of control over the configuration settings, such as port numbers, directory suffixes, and users and groups for the Directory Server processes. Express has the least amount of input, meaning it uses more default or randomly-generated settings, while custom allows the most control over the configuration by having the user supply a lot of configuration information. These setup types are described more in Table 1.2, “Comparison of Setup Types”. For most deployments, the typical installation type is recommended.

NOTE

There is a fourth setup option called a silent installation. This provides two ways of performing the setup without user interaction, either by passing arguments in the command-line with the setup-ds-admin.pl script or to use a file with settings already defined. This is extremely useful for doing large numbers of Directory Server instances, since it does not require any user involvement after the packages are installed. Silent installations are explained more in Section 4.5.1, “Silent Setup for Directory Server and Admin Server”.
This chapter describes the complete procedure to install Red Hat Directory Server on Red Hat Enterprise Linux 5 (64-bit), including both OpenJDK and Directory Server packages, and the different setup options.

3.1. Installing OpenJDK

Necessary Java libraries are not bundled with Directory Server. They must be downloaded and extracted separately before installing the Directory Server packages.
Directory Server 8.2 requires Sun JDK 1.6.0 or OpenJDK 1.6.0.

IMPORTANT

When the new JDK is installed for Directory Server 8.2, it is no longer possible to manage older instances of Directory Server using the Directory Server Console because the required JDKs for the different Directory Server versions are different. You must migrate any older instance to Directory Server 8.2 if you need to manage that instance with the Directory Server Console.
To install OpenJDK:
yum install java-1.6.0-openjdk
OpenJDK is also available from http://openjdk.java.net/install/.
After installing the JDK, run /usr/sbin/alternatives as root to insure that the proper JDK is available:
/usr/sbin/alternatives --config java

There are 3 programs which provide 'java'.

  Selection    Command
-----------------------------------------------
   1           /usr/lib/jvm/jre-1.4.2-gcj/bin/java
   2           /usr/lib/jvm/jre-1.6.0-openjdk/bin/java
*+ 3           /usr/lib/jvm/jre-1.6.0-sun.x86_64/bin/java
After installing the JDK, install the Directory Server packages, as described in Section 3.2, “Installing the Directory Server Packages”.