Sun Java System Communications Express 6.3 Administration Guide

Post Configuration Steps

You need to configure Communications Express to enable migration.


Note –

The configuration parameters required for migration must be manually provided by the administrator.


The following table lists the configuration files that the migration script depends on.

Table 7–2 Configuration Files and their Purpose

File Name 

Description 

migrate.properties

Contains the parameters required to migrate data from PAB to Address Book Server.  

uwcauth.properties

Referred by the migration utility to decide whether migration is required. 

Migration tool checks for the value of pab_mig_required If the value is true, dynamic migration takes place

uwcconfig.properties

Administrators can provide the log level and enable logging for trouble shooting purposes. By default the log level parameter log.level is disabled and set to 0.

runMigrate.sh

(applicable only for Batch migration) 

The script is used to perform batch migration. It sets the required variables and invokes the Java program MigratePab, with following three arguments.

# Absolute path of migrate.properties file. The Default path is set to: ../WEB-INF/config/migrate.properties

# Absolute path of configuration directory in which uwcauth.properties and other configuration files are located. The default path is set to: ../WEBINF/config

# inetDomainBaseDN of the users

This file needs to be edited appropriately to provide the necessary paths and arguments. 

xlate-pabperson.xml ()

xlate-pabgroup.xml ()

Migration utility internally uses the address book APIs of Communications Express to load the data from the PAB of Messenger Express. 

The xlate files are required to map LDAP attributes of the PAB to the address Book attributes of Address Book Server. These files are available at uwc-deloyed-path/WEB-INF/config//ldapstore/migrate.

Based on the user's mail host, the PAB configuration entries listed in the table below are retrieved and the connection to the PAB server established.

Table 7–3 Parameters Configurable for PAB Migration in migrate.properties

Parameter 

Default Value 

Description 

hostname.pabldappoolmin

Specifies the minimum number of LDAP user connections to be created for PAB LDAP 

hostname.pabldappoolmax

20 

Specifies the maximum number of LDAP user connections to be created for PAB LDAP 

hostname.pabldappooltimeout

50 

Specifies the number of seconds before timing out an LDAP connection 

hostname.alwaysusedefaulthost

Specifies whether to use the user’s PAB host mentioned in the PAB URI or to use the first fully qualified PAB hostname from the list maintained. 

When set to 1, the first fully qualified PAB host is used to retrieve the PAB entries

delete_pabentry

Enables the deletion of PAB entries and PABURI after a successful migration 

maxthreads

10 

Specifies the number of migration threads 

mailhost.pabhosts

The mail host name is assigned to the list of PAB hosts in which the PAB entries are located. 

Specifies the list of PAB hosts 

mailhost.pabports

 

Specifies the port number of the PAB hosts 

mailhost.pabbinddns

 

Specifies the bind DN for PAB 

mailhost.pabpasswds

 

Specifies the password of the user binding to the PAB 

<pabhost.pabport>.abhostport=< abldaphost>:<abldapport>

 

Specifies the pabhost and pabport entries available in the lookup table in the migrate.properties file.

In this parameter <pabhost.pabport> refers to the source directory instance and <abldaphost> and <abldaport> the target directory instance to which the PAB data is required to be migrated

Table 7–4 Field Mapping for Contacts

PAB 

Address Book 

cn

DisplayName

sn

sn

givenName

givenName

telephonenumber

piPhone1Type:work

piPhone1:

homephone

piPhone2Type:home

piPhone2;

pager

piPhone4Type:pager

piPhone4:

mobile

piPhone3Type:mobile

piPhone3:

facsimiletelephonenumber

piPhone5Type:fax

piPhone5:

mail

piEmail1Type:work

piEmail1:

   

postoffice+street

homePostalAddress

l

homecity

st

homeState

postalcode

homePostalCode

co

homeCountry

labeleduri

piWebsite1

description

description

   

memberofpabgroup

memberOfOIGroup

dateOfBirth

dateOfBirth


Caution – Caution –

Due to a limitation in Messenger Express, the migration of this property may be erroneous if you have specified date of birth in a format other than MM/DD/YY. You can however edit this property after the migration and set it to the correct date. Refer to the Online Help for instructions on how to set this.


Table 7–5 Field Mapping for Groups

PAB 

Address Book 

cn

displayName

description

description


Note –

For more information, see Appendix D, Password Encryption in Communications Express.