簡介
遷移工具將使用者的 Messenger Express 通訊錄資料遷移至做為 Communications Express 組件的 Address Book Server。
圖 7–1 資料遷移程序概觀
位於 Messenger Express 的 LDAP PAB 樹的資料遷移到 Addressbook Server 的 LDAP PAB 樹。下面的範例說明遷移程序。
當 siroe.com 網域中的 User1 在 PAB 中有一個需要遷移的項目 (例如 Entry1) 時，該項目位於 PAB 樹的 ou=User1 之下，如圖 7-2 中綠色所示。
圖 7–2 Entry1 在 PAB 樹中的位置
遷移之後，新建立的 Addressbook Server 項目 piEntryID=Entry 1 會新增到 Addressbook Server 樹的 o=siroe.com 之下，如圖 7-3 中顯示的紅色部分。
圖 7–3 Entry 1 在 Address Book Server 樹中的位置
備註 –
遷移公用程式會在使用者第一次登入時將 Messenger Express 的 PAB 中的所有資料遷移到 Communication Express 的通訊錄。然而一旦將資料遷移到通訊錄之後，用 Messenger Express 新建立的連絡人或群組將不會顯示在 Communications Express 的通訊錄中。反之亦然。
遷移方案
資料遷移執行方式有兩種：
動態遷移
當現有的 Messenger Express 使用者登入 Communication Express 時，會發生動態遷移。使用者會在遷移完成之後收到一封電子郵件。
在動態遷移程序中：
-
應用程式將檢查是否在 uwcuath.properties 檔案中啟用了遷移，然後繼續執行遷移程序。
-
然後，登入邏輯將比較 nswmextendedprefs 屬性和 mepabmigration 值，以確定之前是否遷移了使用者的資料。
-
一旦完成 PAB 遷移，Address Book Server 會在登入的使用者項目中將 nswmextendedprefs、mepabmigration 設定為 1，表示已經完成遷移程序。
-
在 PAB 資料成功遷移到 Address Book Server 後，使用者會收到一封郵件。
若要接收郵件，必須定義後續配置步驟中列出的參數。
批次遷移
在批次遷移程序中，遷移發生在伺服器層級，無需一般使用者互動。管理員執行 runMigrate.sh 批次程序檔，以遷移存在於指定網域中的郵件使用者 PAB 資料。對於存在於多重網域中的郵件使用者，管理員必須針對每個網域均呼叫 runMigrate.sh 程序檔，以將使用者 PAB 資料從指定的 inetDomainBaseDN 遷移至 Address Book Server。
後續配置步驟
您需要配置 Communications Express 以啟用遷移。
備註 –
請注意，遷移需要的配置參數必須由管理員手動提供。
表 7-1 列出遷移公用程式依賴的配置檔案。
表 7–1 配置檔案及其用途|
檔案名稱 |
說明 |
|---|---|
|
migrate.properties |
包含將資料從 PAB 遷移到 Address Book Server 所需的參數。請參閱後續配置步驟，以取得有關這些參數的資訊。 |
|
uwcauth.properties |
由遷移公用程式引用，用來決定是否需要遷移。 遷移工具會檢查 pab_mig_required 的值。如果值為 true，就會發生動態遷移。 |
|
uwcconfig.properties |
管理員可以提供日誌層次，並啟用記錄以供疑難排解。依預設，會停用這個參數。 |
|
runMigrate.sh (僅適用批次遷移) |
程序檔使用下列三個引數設定必要的變數，並呼叫 Java 程式 MigratePab。 # migrate.properties 檔案的絕對路徑。預設路徑設為：../WEB-INF/config/migrate.properties # 配置目錄的絕對路徑，這個目錄中存有 uwcauth.properties 和其他配置檔案。預設路徑設為：../WEBINF/config # 使用者的 inetDomainBaseDN 您必須適當的編輯這個檔案，以提供必要的路徑和引數。 |
|
xlate-pabperson.xml (後續配置步驟) xlate-pabgroup.xml (後續配置步驟) |
遷移公用程式在內部使用 Communications Express 的通訊錄 API，以從 Messenger Express PAB 載入資料。 必須具有 xlate 檔案才能將 PAB 的 LDAP 屬性對映到 Address Book Server 的通訊錄屬性。 |
基於使用者的郵件主機，將擷取表 7-2 中列出的 PAB 配置項目，並建立至 PAB 伺服器的連線。
表 7–2 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 的使用者密碼。 |
|
|
<pabhost.pabport\>.abhostport =< abldaphost\>:<abldappor t\> |
在 migrate.properties 檔案中，指定查詢表中提供的 pabhost 和 pabport 項目。 在該參數中，<pabhost.pabport\> 指來源目錄實例，<abldaphost\> 和 <abldaport\> 指目標目錄實例 (需要將 PAB 資料遷移至此位置)。 |
表 7–3 連絡人的欄位對映
|
PAB |
通訊錄 |
|---|---|
|
cn |
DisplayName |
|
sn |
sn |
|
givenName |
givenName |
|
telephonenumber |
piPhone1Type:工作 piPhone1: |
|
homephone |
piPhone2Type:家庭 piPhone2; |
|
呼叫器 |
piPhone4Type:呼叫器 piPhone4: |
|
mobile |
piPhone3Type:mobile piPhone3: |
|
facsimiletelephonenumber |
piPhone5Type:fax piPhone5: |
|
|
piEmail2Type:家庭 piEmail1: |
|
mailalternateaddress |
piEmail2Type:工作 piEmail2: |
|
postoffice+street |
homePostalAddress |
|
l |
homecity |
|
st |
homeState |
|
郵遞區號 |
homePostalCode |
|
co |
homeCountry |
|
labeleduri |
piWebsite1 |
|
description |
description |
|
memberofpab |
memberOfPIBook |
|
memberofpabgroup |
memberOfOIGroup |
表 7–4 群組的欄位對映
|
PAB |
通訊錄 |
|---|---|
|
cn |
displayName |
|
description |
description |
若要收到郵件，您必須定義表 7-5 中提及的參數。
表 7–5 PAB 遷移電子郵件參數|
參數 |
預設值 |
說明 |
|---|---|---|
|
emailReqd |
True |
允許成功遷移 PAB 資料後傳送電子郵件。 可接受的值為「True」和「False」。 |
|
smtphost |
本機郵件主機 例如：budgie.siroe.com |
指定 SMTP 中繼主機名稱。 |
|
smtpport |
25 |
指定 SMTP 中繼連接埠。 |
|
mailsubject |
PAB 遷移狀態 |
指定郵件的主旨。 |
|
from |
admin@hostname |
指定寄件者的名稱。 |
提示 –
建議管理員應該傳送電子郵件給所有使用者，通知他們在第一次登入時將會觸發 PAB 資料遷移，因此，他們在初始階段作業中將看不到通訊錄資料。使用者如果兩天或三天後仍然看不到資料，應連絡管理員。
支援水平可伸縮性所需的其他配置
使用者 LDAP 項目中的屬性 psRoot 是 Address Book Server 相容的 URL，定義儲存並擷取使用者個人通訊錄項目的 LDAP 位置。psRoot 屬性可讓管理員佈建使用者，從而可以跨多目錄位置散佈所有使用者的 PAB 資料。
對於現有 webmail 使用者，如果啟用了 PAB 遷移，將會使用現有 pabURI 屬性和 uwc-deploy-dir/WEB-INF/config/migrate.properties 中定義的對映表來建構 psRoot 屬性。
migrate.properties 檔案中的查詢表包括 pabhost 和 pabport 項目，其格式如下：
pabhost.pabport.abhostport = abldaphost:abldapport
其中，pabhost.pabport 指來源目錄實例，abldaphost 和 abldaport 指目標目錄實例 (需要將 PAB 資料遷移至此位置)。
因此，如果您想要將 PAB 資料從在 pab.example.com:389 上執行的目錄遷移至在 abs.example.com:389 上執行的通訊錄目錄，migrate.properties 檔案中的項目應該顯示為：
pab.example.com.389.abhostport = abs.example.com:389
您可能會擁有所有在 migrate.properties 檔案中必需的查詢。如果使用者的 pabURI 屬性使用 pabhost 和 pabport，則使用預設 psRoot 式樣建構的 psRoot 將以如下格式顯示：
ldap://abldaphost: abldapport/piPStoreOwner=%U,o=%D,o=PiServerDb
如果沒有為 pabURI 值定義查詢，亦即在對映表中未提供與 pabURI 相符的項目，則 pabhost 和 pabport 值將用做 abldaphost 和 abport 的預設值。這表示如果缺少對映表，Messaging Server 的 PAB 項目會根據通訊錄模式遷移到相同目錄實例中的另一個根目錄。在這個案例中，[目標] 目錄實例與 [來源] 目標實例相同。
備註 –
修補安裝程式未定義查詢表。安裝修補程式之後，您需要定義查詢表，並重新啟動 Web Server。
確定已在由該網域 personalstore.properties 所指向的 db_config.properties 檔案中定義了 abldaphost:abldapport Directory Server 實例。
遷移部署案例
可以從以下位置執行遷移：
-
指向預設單一 PAB 主機的單一 Messenger Express 實例。
-
指向多個 PAB 主機的單一 Messenger Express 實例。
-
指向包含預設 PAB 主機集的多個 PAB 主機的單一 Messenger Express 實例。
-
指向單一 PAB 主機的多個 Messenger Express 實例。
-
指向多個 PAB 主機的多個 Messenger Express 實例。
- © 2010, Oracle Corporation and/or its affiliates