You need to configure Communications Express to enable migration.
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 |
4 |
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 |
1 |
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 |
0 |
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: |
|
piEmail2Type:home piEmail1: |
mailalternateaddress |
piEmail2Type:work piEmail2: |
postoffice+street |
homePostalAddress |
l |
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. |
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.