Migrating Directories From Earlier Releases - Red Hat ENTERPRISE LINUX 3 Reference Manual

Chapter 13. Lightweight Directory Access Protocol (LDAP)
The job of migrating a user database into a format that is LDAP readable falls to a group of migration
scripts installed in the same directory. Using Table 13-1, decide which script to run to migrate the user
database.
Run the appropriate script based on the existing name service.
The and the
README
directory provide more details on how to migrate the information.
Existing name service
flat files
/etc
flat files
/etc
NetInfo
NetInfo
NIS (YP)
NIS (YP)
Table 13-1. LDAP Migration Scripts

13.8. Migrating Directories from Earlier Releases

Beginning with the release of Red Hat Linux 9, OpenLDAP uses Sleepy Cat Software's Berkeley
DB system as its on-disk storage format for directories. Earlier versions of OpenLDAP used GNU
Database Manager (gdbm). For this reason, before upgrading an LDAP implementation to Red Hat
Enterprise Linux 3 from Red Hat Enterprise Linux 2.1 or Red Hat Linux 7.x through 8, perform the
following steps:
1. Before upgrading the operating system, run the command
ldif-output
LDAP directory.
2. Upgrade the operating system, being careful not to reformat the partition containing the LDIF
file.
3. Re-import the LDAP directory to the upgraded Berkeley DB format by executing the command
/usr/sbin/slapadd -l ldif-output
Important
If an LDAP directory is not exported before upgrading to Red Hat Enterprise Linux 3 from Red Hat
Enterprise Linux 2.1 or Red Hat Linux 7.x through 8, use the command
-l ldif-output
LDIF output). This command creates an LDIF file suitable for importing with the
migration-tools.txt
Is LDAP
running?
yes
no
yes
no
yes
no
. This outputs an LDIF file called
to extract the older directory (replacing ldif-output with the file name for the
files in the
/usr/share/openldap/migration/
Script to Use
migrate_all_online.sh
migrate_all_offline.sh
migrate_all_netinfo_online.sh
migrate_all_netinfo_offline.sh
migrate_all_nis_online.sh
migrate_all_nis_offline.sh
ldif-output
.
/usr/sbin/slapcat -l
containing the entries from the
/usr/sbin/slapcat-gdbm
command.
slapadd
209