Chapter 23   migrateSchemaTo5.pl


The migrateSchemaTo5.pl tool is a Perl script that helps automate the process of updating your custom schema for deployment with iPlanet Directory Server  5.x . Most custom schema files used in version 4.x Directory Servers can be fully updated using this script and thus require no manual editing.

Further information about migrating to versions 5.x , see Chapter 6, "Migrating from Previous Versions" in the iPlanet Directory Server Installation Guide.

This chapter contains the following section:

• Syntax

• Options

Command Usage

---

The migrateSchemaTo5.pl tool is designed to convert all of the custom schema files used by your previous Directory Server to the format required by versions 5.x . For example, all attribute and object class definitions now require a value for the X-ORIGIN field, and this tool will generate one automatically using either a default value or a user-specified value.

Syntax

The migrateSchemaTo5.pl tool has the following command-line syntax:

migrateSchemaTo5.pl -o 4xInstancePath -s newSchemaFile [ options ]

Where:

• 4xInstancePath is the location of the old 4.x server installation. The tool will automatically locate all schema files defined in the slapd.conf file under the userat and useroc headings. Schema files specified in INCLUDE statements with the 4.x slapd.conf file are not converted automatically. You must convert these files separately using the -i option described in Table 23-1.

• newSchemaFile is the name of the file where the equivalent 5.x schema will be written.

This script requires Perl version 5.005_03 or later. See "Where to Find Additional Information" for links to Perl resources.

Options

The migrateSchemaTo5.pl options and parameters are described in the following table.

Table 23-1    Command-Line Options for the migrateSchemaTo5.pl Tool 

Option	Parameter	Purpose
-o	4xInstancePath	Specify the path of the 4.x Directory Sever instance that uses a custom schema you wish to migrate. The command will automatically convert all custom schema files found in the slapd.conf file under the userat and or useroc headings. However, schema files specified in INCLUDE statements are not converted automatically. This parameter has no effect when the -i option is used.
-i	oldSchemaFile	Specify the full path and filename of a 4.x schema file to convert for use with Directory Server 5.x . This option will override the -o parameter.
-s	newSchemaFile	Specify the path and filename of the converted custom schema.
-x	"X-ORIGIN"	Specify a value for the X-ORIGIN field for attributes and object classes in the converted schema file. Use double quotes ("") to include any space in this value on the command line. The default string value is "user defined".
-t	traceLevel	Specify the level of trace, from 0 to 4, for reporting actions performed during the schema file migration.
-L	logFile	Specify a file in which to log the migration report.