Installation guide

SELinux Considerations

The upgrade process could require you to create files or directories that are outside the usual setup

procedures, which could affect SELinux labels. Follow SELinux directions or references whenever they

are given.

5.3.3. Migrating an 8.x Directory Server to 9.1

To upgrade Directory Server and move the instance from one machine to another, the 8.x information

must be copied to the new machine manually.

WARNING

Migration cannot change the hostname used by the Directory Server and Admin Server. T he old

machine must have the same hostname as your new machine. T o commission a new machine on

which to run Directory Server 9.1, first rename the old machine (for example, change

ldap.example.com to ldap_old.exam ple.com ), then give the new machine the original

name of the old machine (ldap.exam ple.com ). Because of the large number of configuration

issues based on the Directory Server's hostname — including the Console, replication, T LS/SSL,

and Kerberos — it is extremely difficult to rename the server. Red Hat strongly recommends that

you do not attempt to change the Directory Server hostname.

1. Upgrade 8.0 and 8.1 servers to 8.2 on the local machine.

NOTE

Upgrade is only supported from 8.2 to 9.1.

2. If the new machine is a different architecture than the original machine, meaning the original

machine is 32-bit and the new machine is 64-bit, export all of the Directory Server 8.2 databases

to LDIF.

The LDIF files must be the same as the database with a .upgrade.ldif appended, and they

must be located in the /var/lib/dirsrv/slapd-instance_name/ldif directory for the

Directory Server instance. For example, the LDIF file for the userRoot database would be

userRoot.upgrade.ldif.

This script can be used to export all databases, automatically, in the correct format.

service dirsrv stop # shutdown all directory servers

for instdir in /var/lib/dirsrv/slapd-* ; do

inst=`basename $ instdir`

for dbdir in /var/lib/dirsrv/$ inst/db/* ; do

if ! [ -d $dbdir ] ; then continue ; fi # skip non-directories

dbname=`basename $dbdir`

/usr/lib/dirsrv/$inst/db2ldif -n $dbnam e -a

/var/lib/dirsrv/$inst/ldif/$ dbnam e.upgrade.ldif

# note - use lib64 above if going from old 64-bit to new 32-bit

machine

done

3. Stop the Directory Server and Admin Server.

Chapter 5. Migrating from Previous Versions