Product SiteDocumentation Site

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

3.1. Installing the JRE
3.2. Installing the Directory Server Packages
3.3. Express Setup
3.4. Typical Setup
3.5. Custom Setup
Installing and configuring Red Hat Directory Server on Red Hat Enterprise Linux has three major steps:
  1. Install the required version of the Java® Runtime Environment (JRE).
  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 8, Migrating from Previous Versions.

NOTE

Before beginning the installation process, make sure that your system meets the requirements in Section 2.2.2, “Red Hat Enterprise Linux 4 and 5”.

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 6.3.1, “Silent Setup for Directory Server and Administration Server”.
This chapter describes the complete procedure to install Red Hat Directory Server on Red Hat Enterprise Linux, including both the JRE and Directory Server packages, and the different setup options.

3.1. Installing the JRE

Necessary Java JRE libraries are not bundled with Directory Server. They must be downloaded and extracted separately before installing the Directory Server packages.

NOTE

Directory Server 8.0 requires JRE version 1.5.0.
Any Red Hat Enterprise Linux customer can download the required JRE packages from the RHEL Extras or Supplemental channel in Red Hat Network, and then use native Red Hat tools to install the package. For example, to install the JRE on Red Hat Enterprise Linux 4, use the up2date command: 
up2date java-1.5.0-ibm
On Red Hat Enterprise Linux 5, use the yum command: 
yum install java-1.5.0-ibm
Using yum or up2date is the preferred and recommended way to install Java. However, it is also possible to download the JRE from the Java site.
  1. Download the Java libraries from http://www.java.com.
  2. Log in as root, and install the JRE. For example: 
    rpm -Uvh java-1.5.0-ibm-1.5.0.5-1jpp.2.el4.i386.rpm
After installing the JRE, install the Directory Server packages, as described in Section 3.2, “Installing the Directory Server Packages”.