Sun Microsystems 8190994 manual Prerequisites for Running dsmig, Using dsmig to Migrate the Schema

Prerequisites for Running dsmig

Prerequisites for Running dsmig

In this section, old instance refers to the 5.2 instance and new instance refers to the Directory Server 6.0 instance.

Before you use dsmig to migrate an instance, ensure that the following tasks have been performed:

■The Directory Server 6.0 packages (either zip, or native packages) have been installed.

The Directory Server 6.0 packages can be installed on the same machine that holds the Directory Server 5.2 instance, or on a different machine.

■The old instance must have been stopped correctly.

A disorderly shutdown of the old instance will cause problems during the migration. Even if the old and new instance are on different machines, the old instance must be stopped before the migration is started.

■dsmig has access to the old instance files.

■If the old and new instances are on different machines, a complete image of the old instance must be created on the machine that hosts the new instance.

The complete image includes all the files required for migration of the instance (schema, configuration, security and database files). The complete image files must be located in the same directories as they were under the original Server Root. You can run cp -r to achieve this, provided none of the files have been relocated outside the Server Root.

You can create and start the new instance manually, but is not mandatory to create the new instance before running dsmig. dsmig checks whether a new Directory Server instance exists in the specified path. If a new instance exists, the commands are carried out on this instance. If a new instance does exist, the instance is created automatically.

The new instance can be created anywhere except for the exact location of the old instance.

Using dsmig to Migrate the Schema

Directory Server 5.2 schema files are located in

serverRoot/slapd-instance-path/config/schema. Directory Server 6.0 schema files are located in INSTANCE-PATH/config/schema.

Directory Server 6.0 provides a new schema file,00ds6pwp.ldif, that contains new password policy attributes. In addition, certain configuration attributes have been added to 00core.ldif. Apart from these files, the standard schema files provided with Directory Server 6.0 are identical to those provided in 5.2.

To migrate the schema automatically, run the following command:

$dsmig migrate-schemaold-instance-path new-instance-path

30 Sun Java System Directory Server Enterprise Edition 6.0 Migration Guide • March 2007

Sun Confidential: Registered