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.
To migrate a replicated site, do the following:
1. Stop all old Directory Server instances and the Administration Server.
2. Back up all the Directory Server user and configuration data.
3. Stop directory writes to the master or hub server being migrated.
4. On the machine where your legacy Directory Server is installed, install the Directory Server 8.0
packages.
Make the first migrated master the configuration instance since it is not replicated. T hen,
register other master and hub servers with the first master Directory Servers configuration
instance.
This instance needs to listen on your standard port, usually 389.
5. Run the migration script, as root.
IMPORTANT
Do not set up the new Directory Server instances with setup-ds-adm in.pl before
running the migration script.
# /usr/sbin/migrate-ds-admin.pl --oldsroot /opt/redhat-ds/
General.ConfigDirectoryAdminPwd=password
/opt/redhat-ds/ is the directory where the old Directory Server is installed.
6. The migration process starts. T he legacy Directory Server is migrated, and a new Directory Server
8.0 instance is installed using the configuration information from the legacy Directory Server.
7. Once the old Directory Server instance is migrated, test replication to make sure it is working
correctly.
8. After you finish this process for all of the master server, repeat the steps for the hub servers and
then for the replicas.
Chapter 8. Migrating from Previous Versions
103