Installation guide
/usr/sbin/migrate-ds-admin.pl --cross --oldsroot
server2:/migration/opt/redhat-ds --actualsroot /opt/redhat-ds
General.ConfigDirectoryAdminPwd=password
8. T he migration process starts. T he legacy Directory Server is migrated, and a new Directory Server
8.2 instance is installed using the configuration information from the legacy Directory Server.
9. After the migration process ends, then the Windows Synchronization service has to be manually
resynchronized.
a. Reboot the Windows machine.
b. In the Directory Server Console, open the Configuration tab.
c. Expand the Replication folder, and select the database.
d. Right-click the synchronization agreement, and select Initialize Full Re-synchronization
from the drop down menu.
10. Verify the Directory Server settings.
IMPORTANT
Always verify the Directory Server configuration after migrating from 7.1 to 8.2. Some
configuration settings, like passwordMinLength for a global password policy, are not
migrated.
Review all policy settings in the new 8.2 instance and make any changes before putting the
system into production.
5.3. Upgrading 8.1 Servers
For Directory Server 8.1 servers, it is possible to perform an in-place upgrade. This is significantly
simpler than a migration. An in-place upgrade updates the Red Hat Directory Server packages on the
system, and then the setup script is used to update the server configuration.
IMPORTANT
If there are any duplicate entries (based on duplicate DNs), then the upgrade process makes a
copy of the database. It is possible, in an extreme case, that the upgraded database could be
twice the size of the original database, until the duplicate antries are resolved. As a precaution,
make sure there is enough disk space available for the upgrade, meaning that there is twice the
current database size available.
If there is not enough disk space available, the upgrade process files with the error message
Failed to back up backend instance 'instance_name'.
Section 5.3.1, “Upgrading a Server”
Section 5.3.2, “Upgrading Servers in Replication”
Section 5.3.3, “Migrating an 8.1 Directory Server to 8.2 on Another Machine”
Section 5.3.4, “Upgrading Directory Server on Solaris”
5.3.1. Upgrading a Server
An in-place upgrade means that the packages for the Red Hat Directory Server are simply updated. No
other migration process is necessary. In-place upgrade is supported for Directory Server 8.1.
Chapter 5. Migrating from Previous Versions
75