Installation guide

5.2. Migrating 7.1 Servers
Red Hat Directory Server 7.1 servers are migrated to a new Directory Server 8.2 instance. This uses a
special script which carries over the user and configuration data to the new instance.
The migration scenario differs depending on the type of Directory Server 7.1 configuration. It is possible
to migrate a single Directory Server instance, all Directory Server instances on a machine or replicated
servers and to migrate the Directory Server to a different machine, or to a different platform. The
migration script has different options available to facilitate migration; the different usage scenarios are
explained in the following sections.
IMPORTANT
Before beginning to migrate a Red Hat Directory Server instance, first perform all of the
preparatory steps in Section 5.2.2, “Before Migration”.
Section 5.2.1, “About migrate-ds-admin.pl”
Section 5.2.2, “Before Migration”
Section 5.2.3, “Migrating a Server or Single Instance”
Section 5.2.4, “Migrating Replicated Servers”
Section 5.2.5, “Migrating a Directory Server from One Machine to Another”
Section 5.2.6, “Migrating a Directory Server from One Platform to Another”
WARNING
If Directory Server databases have been moved from their default location (/opt/redhat-
ds/slapd-instancenam e/db), migration will not copy these databases, but will use the
directly. T his means that if you run migration, you may not be able to go back to the old version.
Migration will not remove or destroy the data, but may change the format in such a way that you
cannot use the older version of the Directory Server. Therefore, make a database backup using
db2bak and an LDIF dump using db2ldif of the databases to make sure everything can be
recovered.
The most common reason for using a non-default database location is the performance for large
databases. For example, if a Directory Server instance has several gigabytes of data, the index
files and transaction logs can be moved to a separate disk device to improve the Directory Server
performance, especially if there are high update rates. In this case, migration will not attempt to
move the databases to the new default location,
/var/lib/dirsrv/slapd-instance_name/db, but will instead assume that the databases
should be in their non-standard location and configure the new server to use the databases in
the old location.
This issue does not occur in cross-platform migrations or migrating using LDIF files instead of the
binary databases because these already work with an LDIF copy of the database.
5.2.1. About migrate-ds-admin.pl
The migration script, migrate-ds-admin.pl, has flexible options that allow a variety of different
migration scenarios, including migrating between different different platforms. This options are listed in
Table 5.1, “migrate-ds-admin Options”.
There is one required option with the migration script, oldsroot, which gives the directory path to the
Red Hat Directory Server 8.2 Installation Guide
64