Name

msgiplanetmigrate — migrate a SCOoffice Mail Server LDAP directory to iPlanet

Synopsis

/opt/lsb-sco.com/msg/bin/msgiplanetmigrate --host=name [ --port=portno ]  
   --suffix=suffix --rootdn=name --rootpw=password [ options ]

Description

The msgiplanetmigrate SCOoffice Mail Server utility is a Perl script that migrates an LDAP directory containing SCOoffice Mail Server data to an iPlanet directory. By default, the utility migrates SCOoffice Mail Server data when the appropriate options are supplied; it can also migrate other directory information if LDIF (LDAP Data Interchange Format) information is provided for the objects.

Only the root user can use the msgiplanetmigrate utility.

The following arguments are supported to migrate SCOoffice Mail Server data:

--host=name

The host name of the system on which the iPlanet server resides.

--port=portno

The port number on which the remote LDAP server is listening; this argument is optional.

--suffix=suffix

The point in the directory tree where the SCOoffice Mail Server should be installed. For example, dc=caldera,dc=com.

--rootdn=name

The name of the root administrator on the remote directory. For example, cn=Directory Manager.

--rootpw=password

The rootdn password.

The following optional arguments are supported to migrate other directory information:

--attrFiles="name [ name ... ]"

Object attribute information, contained in space-separated list of LDIF files for the objects being migrated and in the format expected by iPlanet.

--classFiles="name [ name ... ]"

Object class information, contained in space-separated list of LDIF files for the objects being migrated and in the format expected by iPlanet.

--aciFiles="name [ name ... ]"

Access control information, contained in space-separated list of LDIF files for the objects being migrated and in the format expected by iPlanet.

--ldapBase=name

Subdirectory of the directory tree being copied relative to the supplied suffix. The default for this is ou=Volution Messaging Server, which is the organizational unit containing SCOoffice Mail Server objects.

Example

Typical usage for the msgiplanetmigrate utility might be:

  1. Run msgiplanetmigrate with appropriate arguments. For example:

    cd /etc/opt/lsb-caldera.com/volution/msg/bin
    ./msgiplanetmigrate --host=iplanet.mydomain.com --suffix='dc=mydomain,dc=com'

  2. Run the msgldaphost(8) utility to point the SCOoffice Mail Server to the new directory server. For example:

    cd /etc/opt/lsb-caldera.com/volution/msg/bin
    ./msgldaphost --host=iplanet.mydomain.com --base='dc=mydomain,dc=com' --rootdn

  3. Restart the SCOoffice Mail Server Apache, Postfix and Cyrus services:

    cd /etc/rc.d/init.d
    ./httpd stop; ./http start
    ./postfix stop; ./postfix start
    ./cyrus stop; ./cyrus start

Files

/opt/lsb-sco.com/msg/bin/msgiplanetmigrate

the msgiplanetmigrate Perl script

See also

msgldaphost(8)