Sun Java System Communications Express 6 2005Q4 Administration Guide

Post Configuration Steps

You need to configure Communications Express to enable migration.


Note –

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


Table 7-1 lists the config files the migration utility depends on.

Table 7–1 Configuration Files and their Purpose

File Name 

Description 

migrate.properties 

Contains the parameters required to migrate data from PAB to Address Book Server. Refer to Post Configuration Steps for information on these parameters.

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 this parameter is disabled. 

runMigrate.sh 

(applicable only for Batch migration) 

The script 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 config directory in which uwcauth.properties and other config 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 (Post Configuration Steps)

xlate-pabgroup.xml (Post Configuration Steps)

Migration utility internally uses the address Book API’s of Communications Express to load the data from the PAB of the Messenger Express. 

The xlate files are required to map LDAP attributes of the PAB to the address Book attributes of the Addressbook Server.

Based on the user\qs mail host, the PAB configuration entries listed in Table 7-2 are retrieved and the connection to the PAB Server established.

Table 7–2 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 delete 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–3 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 

piEmail2Type:home 

piEmail1: 

mailalternateaddress 

piEmail2Type:work 

piEmail2: 

postoffice+street 

homePostalAddress 

homecity 

st 

homeState 

postalcode 

homePostalCode 

co 

homeCountry 

labeleduri 

piWebsite1 

description 

description 

memberofpab 

memberOfPIBook 

memberofpabgroup 

memberOfOIGroup 

Table 7–4 Field Mapping for Groups

PAB 

Address Book 

cn 

displayName 

description 

description 

To receive a mail, you are required to define the parameters mentioned in Table 7-5.

Table 7–5 PAB Migration Email Parameters

Parameters 

Default Value 

Description 

emailReqd 

True 

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

Accepted values are “True” and “False”. 

smtphost 

local mail host 

For example: budgie.siroe.com 

Specifies the SMTP relay host name. 

smtpport 

25 

Specifies the SMTP relay port. 

mailsubject 

PAB Migration Status 

Specifies the subject of the mail. 

from 

admin@hostname 

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.