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

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 Red Hat Enterprise Linux Virtualization Server 5.

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.