Installation guide

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 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 T able 1.2, “Comparison of Setup T ypes”. For most deployments, the
typical installation type is recommended.
NOTE
There is a fourth setup option called a silent installation. T his 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. T his 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.
Red Hat Directory Server 8.0 Installation Guide
34