Installation guide

WARNING

The required migration scripts, m igrate-ds.pl and m igrate-ds-adm in.pl, are still

available in Red Hat Directory Server 9.1. It is possible to use those scripts to perform a cross-

platform migration directly from 7.1 to 9.0.

However, this migration path is not fully supported. Please contact Red Hat Support Services

before attempting to perform a direct 7.1 to 9.1 migration.

5.3. Upgrading 8.x Servers

For Directory Server 8.x servers, the upgrade process copies existing files over to a new system and

then re-runs the setup to refresh the existing configuration and data in the new server.

5.3.1. About Red Hat Directory Server Packaging Changes

In Red Hat Directory Server 8.x versions, the Red Hat Directory Server packages used a redhat-*

naming scheme. In Red Hat Directory Server 9.1, there are 389-* base packages which provide the

core functionality of the Directory Server, in addition to the redhat-ds-* , which provide configuration

information.

To provide a smooth upgrade path from the base 389 packages to Red Hat Directory Server or between

8.x and 9.1, the redhat-* packages in Red Hat Directory Server 9.1 are essentially skins that use the

389-* packages as dependencies. Whenever an administrator uses yum to update the redhat-*

packages, it automatically pulls in any required 389-* package. T his means that systems

administrators only need to deal with the redhat-ds* packages, as with previous releases.

Table 5.1. Red Hat Directory Server and 389 Directory Server Package Names

Red Hat Directory Server Package 389 Directory Server Package

redhat-ds 389-ds

redhat-ds-base 389-ds-base

redhat-ds-admin 389-admin

redhat-idm-console 389-console

redhat-admin-console 389-admin-console

redhat-ds-console 389-ds-console

5.3.2. Upgrade Prerequisites

System Users and Groups

The new system must use the same user and group names for the Directory Server user as the old

system.

Check the system user for Directory Server on the old system, and note the user and group names used

for the slapd-* directory.

ls -ald /etc/dirsrv/slapd-*

If necessary, create these same users and groups on the new system.

Red Hat Directory Server Red Hat Directory Server 9 Installation Guide