Sun Microsystems 8190994 manual Using dsmig to Migrate User Data

Tasks to be Performed After Automatic Migration

Using dsmig to Migrate User Data

In Directory Server 5.2, data is stored in serverRoot/slapd-instance-name/db. Directory Server 6.0 stores user data in instance-path/db.

To migrate data automatically, run the following command:

$dsmig migrate-dataold-instance-path new-instance-path

All suffixes are migrated by default, except theo=netscapeRoot suffix.dsmig copies the data, the indexes, and the transaction logs. The database context, that is, the state of the database, is not migrated.

In the new Directory Server administration model, there is no Configuration Directory Server. This means that the o=netscapeRoot suffix is no longer relevant, unless your deployment includes Identity Synchronization for Windows. By default, dsmig does not migrate the o=netscapeRoot database, unless specifically requested. To migrate the o=netscapeRoot database, use the -N option with the migrate-data subcommand.

For more information, see dsmig(1M).

Note – During data migration, Directory Server checks whether nested group definitions exceed 30 levels. Deep nesting can signify a circular group definition, where a nested group contains a group that is also its parent. When a group with more than 30 nesting levels is encountered, Directory Server stops calculating the isMemberOf attributes for additional levels.

Each time this happens, Directory Server logs an error. You safely ignore these errors, although you should examine the definition of the group mentioned in the error message for potential circular definitions.

Tasks to be Performed After Automatic Migration

If you have used dsmig to migrate your server automatically, only the following two post-migration tasks must be completed:

■If you have customized user plug-ins, these need to be recompiled and added to the new server manually.

■If the migrated server was part of a replicated topology, see “Issues Related to Migrating Replicated Servers” on page 52.

Chapter 2 • Automated Migration Using the dsmig Command 35

Sun Confidential: Registered