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 two primary steps:
  1. Install the Directory Server packages.
  2. 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 Chapter 2, System Requirements and Section 1.2, “Considerations Before Setting Up Directory 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.6.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 6.2 (64-bit), including both OpenJDK and Directory Server packages, and the different setup options.

3.1. Installing the Directory Server Packages

There are two main packages to install: the base server package (redhat-ds) and the console package (redhat-ds-console). After the packages are installed, then the setup script must be run to create the server instance.

3.1.1. Installing Using yum

The simplest method to install the packages is using the native tools (yum) on Red Hat Enterprise Linux.
  1. A system has to be registered to Red Hat (or to an on-premise application such as Subscription Asset Manager) to be able to download content. Additionally, the appropriate subscriptions must be attached to the system.
    This is done using the subscription-manager client tools.
    1. Register the system. Use the --auto-attach option to apply subscriptions for the operating system automatically. The Red Hat Directory Server subscriptions are children of the Red Hat Enterprise Linux subscriptions, so if the Red Hat Enterprise Linux subscriptions are attached and Red Hat Directory Server is included in the account, then Red Hat Directory Server is covered.
      # subscription-manager register --auto-attach
      Username: admin@example.com
      Password:
      The system has been registered with id: 9cd02c51-2b91-4b57-85d7-7d2fefaa0c58
      
      Installed Product Current Status:
      Product Name:           Red Hat Enterprise Linux Server
      Status:                 Subscribed
    2. Enable the Directory Server repository. This repository is available with the active subscription, but it is not enabled by default.
      This is done using the subscription-manager command. The repository name is rhel-server-6-rhds-9-rpms.
      # subscription-manager repos --enable rhel-server-6-rhds-9-rpms
      Repo rhel-server-6-rhds-9-rpms is enabled for this system.
  2. Run the yum command. This installs all of the Directory Server packages, Directory Server Console packages, and dependencies.
    # yum install redhat-ds

    Note

    yum may install or require additional packages if dependencies are missing or out-of-date.
  3. Verify that subscription status for Directory Server, with the validity period of the subscription:
    # subscription-manager list --installed
    
    ....
    
    Product Name:           Red Hat Directory Server
    Product ID:             200
    Version:                9.0
    Arch:                   x86_64
    Status:                 Subscribed
    Starts:                 08/14/2013
    Ends:                   01/01/2022
    
    ...

3.1.2. Installing from an ISO Image

  1. A system has to be registered to Red Hat (or to an on-premise application such as Subscription Asset Manager) to be able to download content. Additionally, the appropriate subscriptions must be attached to the system.
    This is done using the subscription-manager client tools.
    Use the --auto-attach option to apply subscriptions for the operating system automatically. The Red Hat Directory Server subscriptions are children of the Red Hat Enterprise Linux subscriptions, so if the Red Hat Enterprise Linux subscriptions are attached and Red Hat Directory Server is included in the account, then Red Hat Directory Server is covered.
    # subscription-manager register --auto-attach
    Username: admin@example.com
    Password:
    The system has been registered with id: 9cd02c51-2b91-4b57-85d7-7d2fefaa0c58
    
    Installed Product Current Status:
    Product Name:           Red Hat Enterprise Linux Server
    Status:                 Subscribed
  2. Downloading packages from Red Hat Network requires specific entitlements for the account for the 9.1 release.
  3. Click Downloads at the top of the page.
  4. Select Red Hat Directory Server from the product list.
  5. Select the architecture.
  6. Download the packages from Red Hat Network, and burn them to CD or DVD.
  7. Insert the media; the system should automatically recognize and mount the disc.
  8. There is no autorun feature with the Directory Server packages, so open the directory on the disc containing the Directory Server packages. For example:
    # cd /media/cdrecorder/RedHat/RPMS/
  9. Install everything in the directory using rpm:
    # ls *.rpm | egrep -iv -e devel -e debuginfo | xargs rpm -ivh
  10. Verify that subscription status for Directory Server, with the validity period of the subscription:
    # subscription-manager list --installed
    
    ....
    
    Product Name:           Red Hat Directory Server
    Product ID:             200
    Version:                9.0
    Arch:                   x86_64
    Status:                 Subscribed
    Starts:                 08/14/2013
    Ends:                   01/01/2022
    
    ...