6.4. Upgrading from Directory Server 7.x Versions

Instead of migrating the Directory Server, you can install an instance of Directory Server 7.1 on top of the Directory Server 7.0 by installing Directory Server 7.1 into the same server root directory. This updates all the server files while preserving your entries and custom schema. These sections explain the upgrade process:

6.4.1. Before You Begin

Before you begin the upgrade process, back up your entire 7.0 Directory Server. For instructions, check backing up and exporting in "Populating Directory Databases" in the Red Hat Directory Server Administration Guide.

6.4.2. Upgrading

The steps below show how to perform an upgrade using Typical installation:

  1. On your Directory Server 7.0 host machine, log in as root or superuser (su).

  2. Stop the server.

    serverRoot/slapd-serverID/stop-server
  3. Create a new directory for the new 7.1 Directory Server. For example:

    mkdir ds71
    cd ds71
  4. Download the Directory Server product binaries file to the directory you created.

  5. Unpack the product binaries file using the following command:

    gunzip -dc filename.tar.gz | tar -xvof -

    where filename corresponds to the product binaries that you want to unpack.

  6. In the list of files, locate the setup program.

  7. Run the setup program by issuing the following command from the installation directory:

    ./setup

    The setup program asks if you would like to proceed with the setup.

  8. Press [Enter] to respond with the default (the default for this prompt is Yes) or press n if you would like to exit the setup program.

  9. Next, the setup program asks you if you agree to the license terms. Press y to agree with the license terms.

  10. When you are asked what you would like to install, press Enter to select the default, Red Hat Servers.

  11. When you are asked what type of installation you would like to perform, press Enter to select the default, Typical Installation.

  12. When prompted to enter the server root (or the installation directory), enter the full path to the location where your Directory Server 7.0 is installed.

    By default, the setup program provides the following path:

    /opt/redhat-ds/servers

    If your 7.0 Directory Server is installed in a different path, be sure to select that path. Once you supply the correct path, press [Enter].

  13. The setup program starts upgrading your server. Follow the prompts, and complete the upgrade process.

6.4.3. After You Upgrade

To verify that the upgrade process was successful, check the upgraded server for data consistency and any custom schema.