第 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 的通訊錄中。 反之亦然。
|
|
圖 8-1 資料遷移程序簡介
資料遷移執行方式有兩種:
批次遷移
在批次遷移程序中,遷移會於伺服器層級進行,完全不需使用者介入。 管理員執行 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 時必須啟用動態遷移功能。
遷移程序受下列因素影響:
資料遷移發生於:
安裝 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
|
動態遷移程序
動態遷移發生於使用者登入 Communications Express 時。
- 應用程式會檢查 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 中綠色所示。
圖 8-2 Entry1 在 PAB 樹中的位置
遷移之後,新建立的通訊錄伺服器項目會新增到通訊錄伺服器樹的 o=siroe.com 底下,成為圖 8-3 中紅色所示的 cn=Entry 1。
圖 8-3 Entry1 在通訊錄伺服器樹中的位置
通訊錄伺服器樹中會新增一個檔名為 migrate.properties 的配置檔,這個檔案有下列詳細資訊:
- PAB Directory Server 的伺服器名稱、連接埠號碼、basedn、binddn、binddn 密碼。 PAB 可以儲存在一個或多個 Directory Server 上。 如果有許多 Directory Server,必須將其中之一設為預設伺服器。
- 儲存通訊錄伺服器個人資料的 Directory Server 的伺服器名稱、連接埠號碼、basedn、binddn、binddn 密碼。
若要遷移資料,遷移工具必須知道是否:
- 必須使用 PABURI 屬性來決定每個使用者的 PAB 所儲存的 Directory Server,或者
- 應考慮 Directory Server 清單中的預設 Directory Server
遷移方案
開始執行遷移的位置可以是:
- 指到預設單一 PAB 主機的單一 Messenger Express 實例。
- 指到多個 PAB 主機的單一 Messenger Express 實例。
- 指到包含預設 PAB 主機集的多個 PAB 主機的單一 Messenger Express 實例。
- 指到單一 PAB 主機的多個 Messenger Express 實例。
- 指到多個 PAB 主機的多個 Messenger Express 實例。