Installation guide

The m igrate-ds-adm in 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 exam ple:
# /usr/sbin/migrate-ds-admin.pl --oldsroot server2:/migration/opt/redhat-ds
--actualsroot /opt/redhat-ds --instance exam ple
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-adm in.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. 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.
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 Section 8.4.3, “Migrating a Directory Server
from One Machine to Another”, the migration script uses the actualsroot and oldsroot parameters to
migrate across machines and the cross parameter to signal that the migration is cross-platform.
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.
The command format to move from one platform to another is similar to the following:
Chapter 8. Migrating from Previous Versions
105