第 8 章遷移 PAB 資料到通訊錄伺服器

以前 Sun ONE Messaging Server 使用個人通訊錄 (PAB) 來儲存使用者的聯絡資料，而且只有部署在 Sun ONE Messaging Server 上的網路型用戶端才能存取 PAB。為了使行事曆等其他模組能夠存取使用者的通訊錄，Sun Java System Messaging Server for Communications Express 使用通訊錄伺服器而非 PAB 來儲存使用者的聯絡資訊。因為這個緣故，所以使用現有 Sun ONE Messaging Server 安裝來存取 Communications Express 的使用者必須將 PAB 資料遷移到通訊錄伺服器。

遷移程序

位於不同目錄中的 PAB 資料都可以用通訊錄遷移工具遷移到通訊錄伺服器。遷移工具是獨立的可執行程式，它會將使用者的 Messenger Express 通訊錄資料遷移到屬於 Communications Express 的通訊錄伺服器。


注意	Sun Java System Messenger Express 使用一個不同的 Directory Server 來維護 Communications Express 中所用通訊錄以外的其他 PAB 資料。遷移公用程式會在使用者第一次登入時將 PAB 中的所有資料遷移到通訊錄。然而一旦將資料遷移到通訊錄之後，用 Messenger Express 新建立的聯絡人或群組將不會顯示在 Communications Express 的通訊錄中。反之亦然。

批次遷移

動態遷移

批次遷移

在批次遷移程序中，遷移會於伺服器層級進行，完全不需使用者介入。管理員執行 runMigrate.sh 批次程序檔來遷移存在於指定網域中的郵件使用者 PAB 資料。對於存在多個網域中的郵件使用者，管理員必須為每個網域啟動 runMigrate.sh 程序檔，以將指定 inetDomainBaseDN 中的使用者 PAB 資料遷移到通訊錄伺服器。

執行 runMigrate.sh 程序檔之前，管理員應該在 runMigrate.sh 中提供 MigratePab 公用程式所需的下列指令行引數：

migrate.properties 檔的絕對路徑。預設路徑設為： ../WEB-INF/config/migrate.properties

配置目錄的絕對路徑，這個目錄中存有 uwcauth.properties 和其他配置檔案。預設路徑設為： ../WEBINF/config

使用者的 inetDomainBaseDN

動態遷移

在動態遷移程序中，使用者第一次登入 Communications Express 時就會啟動資料遷移。為了能夠進行動態遷移，管理員在配置 Communications Express 時必須啟用動態遷移功能。

遷移類型：動態遷移或批次遷移

使用者是否為 Messenger Express 的註冊使用者

使用者登入 Communications Express 時

執行批次處理 (runMigrate.sh) 時

安裝 Communications Express 後，管理員必須執行的準備步驟包括：

配置 Communications Express 以啟用動態遷移功能。



注意	如果 uwcauth.properties 檔中未啟用動態遷移功能，PAB 資料將不會被遷移到通訊錄伺服器。

用 PAB 伺服器的詳細資料配置通訊錄伺服器。例如，您必須配置主機名稱、連接埠號碼、BindDN、BindDN 憑證、PAB 主機路徑和即將遷移資料的各來源主機電腦的名稱。

遷移程序會根據使用者的郵件主機擷取表 8-1 中所列的 PAB 配置項目，並建立與 PAB 伺服器的連線。

表 8-1 聯絡人的欄位對映
PAB	通訊錄
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
l	homecity
st	homeState
postalcode	homePostalCode
co	homeCountry
labeleduri	piWebsite1
description	description
memberofpab	memberOfPIBook
memberofpabgroup	memberOfOIGroup

表 8-2 群組的欄位對映
PAB	通訊錄
cn	displayName
description	description

動態遷移程序

應用程式會檢查 uwcuath.properties 檔中是否已啟用遷移功能，然後繼續進行遷移程序。

登入邏輯接著比較 nswmextendedprefs 屬性與 mepabmigration 值，以確定先前是否曾經遷移過使用者資料。

如果是第一次遷移資料，則傳送使用者的使用者 ID、網域與 userdn 以啟動遷移執行緒。

與 PAB 遷移相關的配置參數列在表 8-4 中。

表 8-3 migrate.properties 中可為 PAB 遷移配置的參數
參數	預設值	描述
hostname.pabldappoolmin	4	指定可為 PAB LDAP 建立的最少 LDAP 使用者連線數。
hostname.pabldappoolmax	20	指定可為 PAB LDAP 建立的最大 LDAP 使用者連線數。
hostname.pabldappooltimeout	50	指定 LDAP 連線逾時之前的秒數。
hostname.alwaysusedefaulthost	1	指定要使用 PAB URI 中提及的使用者 PAB 主機，或要使用維護的清單中取得的第一個完全合格 PAB 主機名稱。若設成 1，將使用第一個完全合格 PAB 主機來擷取 PAB 項目。
delete_pabentry	0	允許遷移成功後刪除 PAB 項目與 PABURI。
maxthreads	10	指定遷移執行緒數。
mailhost.pabhosts	郵件主機名稱指定為 PAB 項目所在位置的 PAB 主機清單。	指定 PAB 主機的清單。
mailhost.pabports		指定 PAB 主機的連接埠號碼。
mailhost.pabbinddns		指定 PAB 的連結 DN。
mailhost.pabpasswds		指定連結至 PAB 的使用者密碼。

一旦 PAB 遷移完成後，通訊錄伺服器就會將個別使用者項目中的 nswmextendedprefs、mepabmigration 設成「1」，表示已完成遷移程序。

在 PAB 資料成功遷移到通訊錄伺服器後，使用者會收到一封郵件。

若要收到郵件，您必須定義表 8-4 中提及的參數。

表 8-4 PAB 遷移電子郵件參數
參數	預設值	描述
emailReqd	True	允許成功遷移 PAB 資料後傳送電子郵件。可接受的值為「True」和「False」。
smtphost	本機郵件主機例如： budgie.siroe.com	指定 SMTP 中繼主機名稱。
smtpport	25	指定 SMTP 中繼連接埠。
mailsubject	PAB 遷移狀態	指定郵件的主旨。
from	admin@hostname	指定寄件者的名稱。


提示	建議管理員應該傳送電子郵件給所有使用者，通知他們在第一次登入時將會觸發 PAB 資料遷移，也因此，他們在初始階段作業中將看不到通訊錄資料。使用者如果兩天或三天後仍然看不到資料，應聯絡管理員。

遷移執行緒

遷移過程中，遷移執行緒會確認使用者是否為郵件使用者，然後從郵件使用者的 uwcconfig.properties 檔中找出 PAB 詳細資訊。uwcconfig.properties 檔包含預設的 PAB 主機名稱或多個 PAB 主機名稱 (如果使用者存在多個網域上)。通訊錄會根據這些項目決定應遷移資料的適當目標 PAB 主機，並建立連線。

範例

當 siroe.com 網域中的 User1 使用者在 PAB 中有一個必須遷移的項目 (例如 Entry1) 時，該項目位於 PAB 樹的 ou=User1 底下，如圖 8-2 中綠色所示。

遷移之後，新建立的通訊錄伺服器項目會新增到通訊錄伺服器樹的 o=siroe.com 底下，成為圖 8-3 中紅色所示的 cn=Entry 1。

通訊錄伺服器樹中會新增一個檔名為 migrate.properties 的配置檔，這個檔案有下列詳細資訊：