Sun Java 標誌     上一頁      目錄      索引      下一頁     

Sun 標誌
Sun Java System Communications Express 6 2005Q1 管理指南 

第 7 章
遷移 PAB 資料到 Addressbook Server

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

本章包含以下各節：

簡介

遷移工具將使用者的 Messenger Express 通訊錄資料遷移到 Addressbook Server (Communications Express 的一個元件)。

圖 7-1 資料遷移程序簡介

資料遷移程序的圖形表示法。

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

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

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

Entry1 在 PAB 樹中的位置

遷移之後，新建立的 Addressbook Server 項目 piEntryID=Entry 1 會新增到 Addressbook Server 樹的 o=siroe.com 之下，如圖 7-3 中顯示的紅色部分。

圖 7-3 Entry 1 在 Addressbook Server 樹中的位置

Entry 1 在 Address Book Server 樹中的位置。

備註

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

遷移方案

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

動態遷移

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

在動態遷移程序中：

批次遷移

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

後續配置步驟

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

備註

請注意，遷移需要的配置參數必須由管理員手動提供。

表 7-1 列出遷移公用程式依賴的配置檔案。

表 7-1 配置檔案及其用途

檔案名稱

描述

migrate.properties

包含將資料從 PAB 遷移到 Address Book Server 所需的參數。如需有關這些參數的資訊，請參閱表 7-2。

uwcauth.properties

由遷移公用程式引用，用來決定是否需要遷移。

遷移工具會檢查 pab_mig_required 的值。如果值為 true，就會發生動態遷移。

uwcconfig.properties

管理員可以提供記錄層次，並啟用記錄以供疑難排解。依預設，會停用這個參數。

runMigrate.sh

 

(僅適用批次遷移)

程序檔使用下列三個引數設定必要的變數，並呼叫 MigratePab, java 程式。

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

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

# 使用者的 inetDomainBaseDN

您必須適當的編輯這個檔案，以提供必要的路徑和引數。

xlate-pabperson.xml (表 7-3)

xlate-pabgroup.xml (表 7-4)

遷移公用程式內部使用 Communications Express 的通訊錄 API，從 Messenger Express 的 PAB 載入資料。

必須有 xlate 檔案才能將 PAB 的 LDAP 屬性對映到 Addressbook 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>:<abldapport>

 

在 migrate.properties 檔案的查詢表中指定可用的 pabhost 及 pabport 項目。

在這個參數中，<pabhost.pabport> 代表來源目錄實例，而 <abldaphost> 和 <abldaport> 代表需要遷移 PAB 資料的目標目錄實例。

表 7-3 聯絡人的欄位對映

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

表 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 屬性是遵守 Addressbook Server 的 URL，它定義儲存及擷取使用者個人通訊錄項目的 LDAP 位置。psRoot 屬性讓管理員能佈建使用者，以便所有使用者的 PAB 資料可以跨多個目錄位置來散佈。

對於現有的 Webmail 使用者，如果啟用 PAB 遷移，則會使用現有的 pabURI 屬性來建構 psRoot 屬性，並在 uwc-deploy-dir/WEB-INF/config/migrate.properties 中定義對映表。

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 實例。

遷移部署案例

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

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



上一頁      目錄      索引      下一頁     

文件號碼：819-1104。  Copyright 2005 Sun Microsystems, Inc. 版權所有。