Sun Java System Communications Express 6.3 Administration Guide

Migration Scenarios

Data Migration takes place in two ways:

Dynamic Migration

Dynamic Migration takes place when an existing Messenger Express user logs in to Communications Express. The Users receive an email after the migration is completed.

    In the dynamic migration process:

  1. The application checks if migration has been enabled in the file by checking the pab_mig_required parameter.

    If the pab_mig_required parameter is set to true, the migration process is initiated.

  2. The login logic then compares the nswmextendedprefs attribute in the user's LDAP entry. It checks for the value of the mepabmigration parameter to determine whether the user’s data has been previously migrated.

  3. Once PAB migration is completed, the Address Book Server sets the nswmextendedprefs, mepabmigration properties to 1 in the logged in user entry, to indicate the completion of the migration process.

  4. The user receives a mail after the PAB data is successfully migrated to the Address Book Server.

To receive a mail, you are required to set the parameters in the file.

Table 7–1 PAB Migration Email Parameters


Default Value 




Enables mail to be sent after the PAB data has been migrated successfully. 

Accepted values are “True” and “False”. 


local mail host 

For example:

Specifies the SMTP relay host name. 



Specifies the SMTP relay port. 


PAB Migration Status 

Specifies the subject of the mail. 



Specifies the sender’s name. 

Tip –

It is recommended that the administrator sends an email to all users informing them that PAB data migration will be triggered during the first login and as a consequence they will not see the Address Book data during the initial sessions. Users should contact the administrator if they are unable to see their data after 2 or 3 days.

Batch Migration

In the batch migration process, migration takes place at the server level without end user interaction. The administrator executes the batch script to migrate the mail users PAB data present in a given domain. For mail users present in multiple domains, the administrator will have to invoke the script for each domain to migrate users PAB data from the given inetDomainBaseDN to the Address Book Server.

To Perform Batch Migration

Set the following parameters in the script. This script is available at uwc-deployed-path/WEB-INF/classes directory.

Execute the batch migration script.

# ./

If the batch migration fails, exceptions are displayed at the command line prompt.

Migrating a Single User and a Set of Users

Using the migration script, administrators can migrate all the users, a single user, or a set of users. Running the batch migration script without any options migrates the entire set of users. To migrate a single user, you can specify the userid of the user. To migrate a set of users, you should provide the list of users in a text file. The command has the following syntax:

./{ [-u < [uid] |  [-f <uids-file]} [-h]