Sun Java System Communications Express 6.3 管理指南

遷移案例

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

動態遷移

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

在動態遷移程序中：

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

如果 pab_mig_required 參數已設定為 true，就會啟動遷移程序。
接著，登入邏輯會比較使用者 LDAP 項目中的 nswmextendedprefs 屬性。登入邏輯會檢查 mepabmigration 參數值，以確定之前是否遷移過使用者的資料。
一旦完成 PAB 遷移，Address Book Server 會在登入使用者項目中將 nswmextendedprefs 和 mepabmigration 特性設定為 1，表示已經完成遷移程序。
在 PAB 資料成功遷移到 Address Book Server 後，使用者會收到一封郵件。

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

表 7–1 PAB 遷移電子郵件參數


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

提示 –

建議管理員應該傳送電子郵件給所有使用者，通知他們在第一次登入時將會觸發 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
...
....
等等...
```