Migrating A Directory Server From One Platform To Another - Red Hat DIRECTORY SERVER 8.0 Installation Manual

Chapter 8. Migrating from Previous Versions
The oldsroot can also specify a local directory on the target machine that was created from
a tarball. In that case, create a tarball of your old server root directory, and untar it on the target
machine. In this example, a tarball was created of /opt/redhat-ds on the source machine, and it
was untarred under /migration on the target machine:
# /usr/sbin/migrate-ds-admin.pl --oldsroot /migration/opt/redhat-ds
--actualsroot /opt/redhat-ds General.ConfigDirectoryAdminPwd=password
The migrate-ds-admin command automatically migrates every Directory Server instance
configured. As with migrating Directory Server on the same machine, using the instance parameter
allows you to set the specific instance to migrate. For example, this command migrated a Directory
Server instance named example:
# /usr/sbin/migrate-ds-admin.pl --oldsroot server2:/migration/opt/redhat-ds
--actualsroot /opt/redhat-ds --instance example General.ConfigDirectoryAdminPwd=password
1. Stop all Directory Server instances and the Administration Server.
2. Back up all the Directory Server user and configuration data.
3. Install the Directory Server 8.0 packages on the new machine which will host Directory Server.
4. Make the old Directory Server accessible to the new machine, either through an NFS-mounted
drive or tarball.
5. Run the migration script as root. Specify the current physical location of the Directory Server with
the oldsroot parameter and the location on the old machine with the actualsroot parameter.
IMPORTANT
Do not set up the new Directory Server instances with setup-ds-admin.pl before
running the migration script.
For example:
# /usr/sbin/migrate-ds-admin.pl --oldsroot server2:/migration/opt/redhat-ds
--actualsroot /opt/redhat-ds General.ConfigDirectoryAdminPwd=password
The migration process starts. The legacy Directory Server is migrated, and a new Directory Server 8.0
instance is installed using the configuration information from the legacy Directory Server.

8.4.4. Migrating a Directory Server from One Platform to Another

To migrate a Directory Server installation from one platform to another is similar to migrating from
one machine to another. The difference between a migration between platforms and other migration
scenarios is the information migrated from the old Directory Server. The databases are in an
architecture-dependent binary format and can be migrated only after they are exported to LDIF. Other
data, such as the changelog, is not migrated. As explained in
Server from One Machine to
100
Another", the migration script uses the actualsroot and oldsroot
Section 8.4.3, "Migrating a Directory