第 7 章 遷移個人通訊錄資料到 Address Book Server

之前在 Sun Java System Messaging Server 中，個人通訊錄 (PAB) 用於儲存使用者的連絡人，且只能透過部署於 Messaging Server 上的網路型用戶端存取。Communications Express 的 Messaging Server 使用 Address Book Server 而非 PAB 來儲存使用者的連絡人詳細資訊。因此，使用現有 Messaging Server 安裝來存取 Communications Express 的使用者必須將 PAB 資料遷移到 Address Book Server。

• 遷移部署案例

• 遷移案例

• 資料遷移程序

• 後續配置步驟

• 支援水平可伸縮性所需的其他配置

遷移部署案例

可以從以下位置執行遷移：

1. 指向預設單一 PAB 主機的單一 Messenger Express 實例。

2. 指向多個 PAB 主機的單一 Messenger Express 實例。

3. 指向包含預設 PAB 主機集的多個 PAB 主機的單一 Messenger Express 實例。

4. 指向單一 PAB 主機的多個 Messenger Express 實例。

5. 指向多個 PAB 主機的多個 Messenger Express 實例。

遷移案例

資料遷移執行方式有兩種：

• 動態遷移

• 批次遷移

動態遷移

當現有的 Messenger Express 使用者登入 Communication Express 時，會發生動態遷移。使用者會在遷移完成之後收到一封電子郵件。

在動態遷移程序中：

1. 應用程式會檢查 pab_mig_required 參數，以檢查 uwcuath.properties 檔案是否已啟用遷移。

   如果 pab_mig_required 參數已設定為 true，就會啟動遷移程序。

2. 接著，登入邏輯會比較使用者 LDAP 項目中的 nswmextendedprefs 屬性。登入邏輯會檢查 mepabmigration 參數值，以確定之前是否遷移過使用者的資料。

3. 一旦完成 PAB 遷移，Address Book Server 會在登入使用者項目中將 nswmextendedprefs 和 mepabmigration 特性設定為 1，表示已經完成遷移程序。

4. 在 PAB 資料成功遷移到 Address Book Server 後，使用者會收到一封郵件。

若要接收郵件，您必須設定 migrate.properties 檔案中的參數。

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

批次遷移

在批次遷移程序中，遷移發生在伺服器層次，無需一般使用者互動。管理員會執行 runMigrate.sh 批次程序檔，以遷移指定網域中的郵件使用者 PAB 資料。對於存在於多重網域的郵件使用者，管理員必須針對每個網域均呼叫 runMigrate.sh 程序檔，以將使用者 PAB 資料從指定的 inetDomainBaseDN 遷移至 Address Book Server。

執行批次遷移

在 runMigrate.sh 程序檔中設定下列參數。此程序檔位於 uwc-deployed-path /WEB-INF/classes 目錄中。

• BASE_DIR：將此參數設定為 Communications Express 安裝的 uwc-deployed-path。

• JAVA_HOME：將此參數設定為 Java 安裝目錄。

• o=siroe.com, o=isp：將 siroe.com 和 isp 的值替代為配置網域的 inetDomainBaseDN。

執行批次遷移程序檔。

# ./runMigrate.sh

如果批次遷移失敗，指令行提示符號會顯示異常。

遷移單一使用者和一組使用者

管理員可以使用遷移程序檔來遷移所有使用者、單一使用者或一組使用者。執行批次遷移程序檔而未指定任何選項，將遷移所有使用者。要遷移單一使用者，您可指定使用者的使用者 ID。要遷移一組使用者，您應該以文字檔提供使用者清單。runMigrate.sh 指令的語法如下：

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

其中：

• -u 選項指定 runMigrate 程序檔要遷移單一使用者。—u 選項之後應接著要遷移使用者的使用者 ID。範例如下：

  ./runMigrate.sh -u user1

• -f 選項指定 runMigrate 程序檔要遷移一組已經指定在檔案中的使用者。—f 選項之後接著檔案名稱，檔案中包含已選取要遷移的一組使用者之使用者 ID。範例如下：

  ./runMigrate.sh -f usersToMigrate.txt

  usersToMigrate.txt 檔案中，每行應包含一個使用者 ID。例如：

  user1
  user2
  user3
  ...
  ....
  等等...

資料遷移程序

Communications Express 使用遷移程序檔，將使用者的 Messenger Express 通訊錄資料遷移到 Communications Express 中的 Address Book Server。

圖 7–1 資料遷移程序概觀

位於 Messenger Express 的 LDAP PAB 樹中的資料會遷移到 Address Book Server LDAP PAB 樹。下面的範例說明遷移程序。

當 siroe.com 網域中的 User1 在 PAB 中有一個需要遷移的項目 (例如 Entry1) 時，該項目會位於 PAB 樹的 ou=User1 中，如圖 7–2 所示。

圖 7–2 Entry1 在 PAB 樹中的位置

遷移之後，新建立的 Address Book Server 項目會增加到 Address Book Server 樹的 o=siroe.com, piEntryID=Entry 1 之下，如圖 7–3 所示。

圖 7–3 Entry 1 在 Address Book Server 樹中的位置

遷移公用程式會在使用者第一次登入時，將 Messenger Express 的 PAB 中的所有資料遷移到 Communications Express 的通訊錄。然而一旦將資料遷移到通訊錄之後，用 Messenger Express 新建立的連絡人或群組將不會顯示在 Communications Express 的通訊錄中。反之亦然。

後續配置步驟

您需要配置 Communications Express 以啟用遷移。

遷移所需的配置參數必須由管理員手動提供。

下表列出遷移程序檔所需的配置檔案。

基於使用者的郵件主機，將擷取下表列出的 PAB 配置項目，並建立至 PAB 伺服器的連線。

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	piEmail1Type:work piEmail1:
postoffice+street	homePostalAddress
l	homecity
st	homeState
postalcode	homePostalCode
co	homeCountry
labeleduri	piWebsite1
description	description
memberofpabgroup	memberOfOIGroup
dateOfBirth	dateOfBirth 注意 – 由於 Messenger Express 的限制，如果您指定的生日格式並非 MM/DD/YY，遷移此特性可能會發生錯誤。但是您可在遷移後編輯此特性，將其設定為正確日期。如需設定此特性的說明，請參閱線上說明。