Red Hat NETSCAPE DIRECTORY SERVER 7.0 - DEPLOYMENT Installation Guide download pdf (Page 72)

Chapter 5. Migrating from Previous Versions

For Red Hat Directory Server 8.x servers, an upgrade updates all of the Directory Server packages and

then uses the setup script to update the server configuration.

Because Red Hat Directory Server 8.x and Red Hat Directory Server 9.1 are supported on different

platforms — Red Hat Enterprise Linux 5.x and Red Hat Enterprise Linux 6.x, respectively — it is not

possible to do an in-place upgrade. The data must be exported from the original machine and imported

into the new server. T hen the upgrade script (setup-ds-adm in.pl -u) to upgrade the settings.

5.1. Important Considerations

The migration process does not and cannot change the hostname. If you are migrating a Directory

Server instance from one machine to another, the new machine must have the same hostname of the old

machine.

There are a number of reasons why the hostname cannot change because of the number of

configuration areas that are not touched by migration and require the hostname of the Directory Server

in order to function:

The Configuration Directory Server must have the same hostname before and after migration or

console clients will fail to connect.

Replication and synchronization will break because both replication agreements and replication

metadata (RUV) contain the hostname.

Changing the hostname breaks SSL/TLS because server certificates use the fully-qualified domain

name in the subject DN.

SASL GSS-API connections will fail. T he Kerberos principal for the server is tied to the fully-qualified

domain name. Changing the hostname will break GSSAPI clients.

Even though the old host must be renamed before migration is complete, the old machine should still be

available on the network so that its data are available to the new Directory Server instance. This is

required for a 7.1 migration for the migration script, but it is a convenience for a cross-platform upgrade

process.

5.2. Migrating Red Hat Directory Server 7.1 to Red Hat Directory

Server 9.1

There is no direct migration path from Red Hat Directory Server 7.1 to Red Hat Directory Server 9.1, but

it is possible to migrate the data.

1. Install Red Hat Directory Server 8.2.

2. Use the migration script, m igrate-ds-adm in.pl, to migrate from 7.1 to 8.2. T his is described in

the migration chapter of the 8.2 Installation Guide.

3. Install Red Hat Enterprise Linux 6 on the target system.

4. Install Red Hat Directory Server 9.0 on the target system.

5. Perform an upgrade, as described in Section 5.3, “Upgrading 8.x Servers”.

Chapter 5. Migrating from Previous Versions

1 2 ... 67 68 69 70 71 72 73 74 75 76 77 ... 114 115

No comments

Red Hat NETSCAPE DIRECTORY SERVER 7.0 - DEPLOYMENT Installation Guide Page 72