Installation guide

NOTE
Manually restarting the server should only be required for Red Hat Enterprise Linux 4
systems. Other systems should restart automatically.
5. Verify that the packages have been properly updated by checking the version number on one of
the Directory Server packages. For example:
rpm -qf /usr/sbin/setup-ds-admin.pl
redhat-ds-admin-8.2.0-0.el5dsrv
Also restart the Directory Server Console to make sure that the version and build numbers are
appropriately updated.
6. As part of migration, the DNs are encoded and updated to comply with RFC 4514. Verify that the
databases were correctly updated by searching for an entry which could contain escaped
characters; the DNs should be updated. For example, for a DN which was previously
cn="a=abc,x=xyz":
/usr/lib64/m ozldap/ldapsearch -b "dc=example,dc=com " '(cn=\"* \")' entrydn
dn: cn=a\3Dabc\2Cx\3Dxyz,dc=example,dc=com
entrydn: cn=a\3dabc\2cx\3dxyz,dc=example,dc=com
If the search results are correctly escaped, the database backups can be removed.
7. Any entries with duplicate DNs are processed and the duplicates are renamed with their unique ID
in the new RDN. Check the error log for any warnings of duplicate entries (which will have the term
Duplicated entrydn or Duplicated entry in the error messages), and then manually delete any
duplicate entries.
The procedure for this is described in Section 2.2, “No Longer Allowing Duplicate DNs”.
4.4. Migrating to Directory Server 8.2
Upgrading from Red Hat Directory Server 7.1 to Directory Server 8.2 requires migration. The migration
process has a special script, m igrate-ds-admin.pl, which copies the data and configuration from
the 7.1 instance to the new 8.2 instance. For example, to migrate all 7.1 instances to 8.2 on the same
machine:
migrate-ds-admin.pl --oldsroot /opt/redhat-ds
General.ConfigDirectoryAdm inPwd=password
Additional migration scenarios are covered in the Red Hat Directory Server Installation Guide.
NOTE
Because of a known issue, Bugzilla #573889, remove any deprecated schema files from th Red
Hat Directory Server 7.1 schem a directory before running the migration script.
Migrated instances may encounter entries which had duplicate entry DNs with slightly different DN
formats, related to Section 2.2, “No Longer Allowing Duplicate DNs”. After running the migration script,
check the error logs for any warning messages that indicate duplicate entries:
Red Hat Directory Server 8.2 Red Hat Directory Server 8.2 Release Notes
12