Sun Java System Communications Services 6 2005Q4 Schema Migration Guide

Steps for Running commdirmig

You can run commdirmig while the Messaging and Calendar servers are online. The servers can continue to look up user entries in the LDAP directory while commdirmig migrates the directory data to Schema 2.

ProcedureBefore you run commdirmig, complete following tasks:

Step

    If you intend to use a file that lists domain names (by specifying the -f option), create the domain-name file.

    • If you intend to use an input file containing the commdirmig options (by specifying the -i option), create the input file.

    • Create a file to contain the Directory Server login password. The password file must be specified as an argument with the -w option.

ProcedureTo run commdirmig, follow these steps:

Steps
  1. Log in as or become superuser (root).

    By default, the commdirmig utility is located in the /opt/SUNWcomm/bin directory.

  2. Run commdirmig. For the syntax, see commdirmig Syntax.

    Command-line examples are shown below.

  3. After commdirmig is finished, view the commdirmig.log file to check the migration status. If errors occur during the migration or if schema entries cannot be migrated, commdirmig writes them to commdirmig.log.

    By default, the log file is located in the following directory:

    /var/opt/SUNWcomm/logs/commdirmig.log

Example 1

The following example migrates all domains in the LDAP directory from Schema 1 to Schema 2, native mode:

commdirmig -D "cn=Directory Manager" -w /opt/SUNWcomm/passwd -t 1
-X ldaphost -p 389 -b "o=isp" -r "o=internet" -o -d “*”

Example 2

The following example does not migrate the actual directory data. It creates an LDIF audit file showing the modification requests for migrating domains siroe.com and sesta.com from Schema 1 to Schema 2, native mode:

commdirmig -D "cn=Directory Manager" -w /opt/SUNWcomm/passwd -t 1
-X ldaphost -p 389 -b "o=isp" -r "o=internet" -d siroe.com -d sesta.com

If this example were run with the -o option, the actual directory data would be migrated.

Example 3

The following example migrates the domain varrius.com from Schema 1 to Schema 2, native mode, and adds Calendar service to all the users in the domain:

commdirmig -D "cn=Directory Manager" -w /opt/SUNWcomm/passwd -t 1
-X ldaphost -p 389 -b "o=isp" -r "o=internet" -d varrius.com -S cal -o