Installation guide

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. This 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. T herefore, 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-

instancenam e/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.

8.2. About migrate-ds-admin.pl

The migration script, m igrate-ds-adm in.pl, has flexible options that allow a variety of different

migration scenarios, including migrating between different different platforms. T his options are listed in

Table 8.1, “migrate-ds-admin Options”.

There is one required option with the migration script, oldsroot, which gives the directory path to the

old Directory Server. There is also one required argument, General.ConfigDirectoryAdminPwd,

which gives the password of the directory administrator for the old Directory Server. If either of these are

not supplied, the migration script will exit.

/usr/sbin/migrate-ds-admin.pl --oldsroot /opt/redhat-ds

General.ConfigDirectoryAdminPwd=password

NOTE

On Red Hat Enterprise Linux and Solaris machines, the m igrate-ds-adm in tool is in the

/usr/sbin/ directory. On HP-UX machines, the m igrate-ds-adm in is in the

/opt/dirsrv/sbin/ directory.

Chapter 8. Migrating from Previous Versions