Sun Microsystems 8190994 manual Automated Migration Using the dsmig Command

C 2H A P T E R 2

Automated Migration Using the dsmig

Command

Directory Server 6.0 provides a command-line migration tool to help you migrate from a Directory Server 5.2 instance to a Directory Server 6.0 instance. You can only use the migration tool if your deployment satisfies the requirements for automatic migration described in “Deciding on Automatic or Manual Migration” on page 28.

The migration tool provides migration per instance. If several instances exist within the same server root, the migration tool must be run for each individual instance.

This chapter explains how to use the migration tool and covers the following topics:

■“About the Automatic Migration Tool” on page 29

■“Prerequisites for Running dsmig” on page 30

■“Using dsmig to Migrate the Schema” on page 30

■“Using dsmig to Migrate Security Data” on page 31

■“Using dsmig to Migrate Configuration Data” on page 31

■“Using dsmig to Migrate User Data” on page 35

■“Tasks to be Performed After Automatic Migration” on page 35

About the Automatic Migration Tool

The migration tool, dsmig, is delivered with the Directory Server 6.0 packages. When these packages have been installed, dsmig is located in install-path/ds6/bin.

dsmig must be run on the machine on which the new Directory Server instance will be located. When the command is run, a migration directory is created within the new instance directory (new-instance-path/migration). This directory is a repository for data produced by the migration, including log files and migration status files.

dsmig includes a set of sub-commands and options, that map to the individual migration steps described in “Outline of Migration Steps” on page 27. For information about the usage of dsmig, see dsmig(1M).

29

Sun Confidential: Registered