Sun Java System Calendar Server 6.3 管理指南

第 3 章 Calendar Server 6.3 的資料庫遷移公用程式

本章描述各種可用的資料庫遷移公用程式，可讓您在安裝並配置了 Calendar Server 6.3 軟體之後，遷移行事曆資料庫及 LDAP 資料庫。

本章包含以下小節：

提示 –

如果您是從 Calendar Server 6.0、6.1 或 6.2 版本遷移，請執行3.3 csmigrate 公用程式。如果未對先前部署中重複發生的事件及工作執行 cs5migrate，您必須在現有的行事曆資料庫上執行 cs5migrate，然後才能執行 csmigrate。

如果您是從 Calendar Server 5.1.1 遷移，請按照3.2 選擇正確的 Calendar Server 公用程式中的說明來使用遷移公用程式，遷移行事曆資料庫及 LDAP 資料庫。

如果您安裝的 Calendar Server 版本更舊，請打電話給技術支援人員，以取得遷移資料的協助。

3.1 Calendar Server 資料庫遷移公用程式簡介

本小節說明每一個遷移公用程式。但請根據您先前已安裝的 Calendar Server 版本，僅使用需要的遷移公用程式。這些公用程式位於 sbin 目錄中。

提示 –

如果您曾經對資料庫執行 cs5migrate 公用程式，但是未使用 -r 選項，則您必須搭配 -r 選項重新執行它，然後才能執行任何其他的公用程式。

遷移公用程式如下：

3.5 csmig 公用程式

可為 Calendar Server 6 資料庫中的每個行事曆指定一個所有者，並可將每個行事曆 ID (calid) 對映至一個所有者 (如果需要)，這樣可以支援多個網域和 LDAP 行事曆查找資料庫 (Calendar Lookup Database, CLD) 外掛程式。

在執行 cs5migrate 之後，但在 csvdmig 之前執行這個公用程式。

3.6 csvdmig

透過將行事曆的網域 (@domainname) 增加至每個 calid，升級 Calendar Server 6 網站以使用多個網域。例如，在網域 sesta.com 中，jdoe 的 calid 現在將是 jdoe@sesta.com。此公用程式與 Calendar Server 封裝在一起。

在執行 csmig 之後，但在 cs5migrate 之前執行這個公用程式。

3.4 cs5migrate 公用程式

將您的行事曆資料庫從 Calendar Server 版本 5 遷移至版本 6.2 格式。您必須指定 -r 選項，對您的資料庫執行這個公用程式。如果在此之前已從 Calendar Server 版本 5.1.1 遷移至版本 6.2，但是未搭配 -r 選項執行 cs5migrate 公用程式，則您必須以該選項重新執行它，然後才能執行 csmigrate 公用程式。

在執行 csmig 與 csvdmig 之後，但在 csmigrate 之前執行這個公用程式。

3.3 csmigrate 公用程式

遷移您的行事曆資料庫，以從 Calendar Server 版本 6.0、6.1 或 6.2 升級至 Calendar Server 6.3 版本。如果您需要以 -r 選項執行 cs5migrate，請在這個公用程式之前執行它。

3.7 commdirmig

將 LDAP 資料從 Schema 1 遷移至 Schema 2，以準備與 Access Manager (處於舊有模式) 搭配使用。

3.2 選擇正確的 Calendar Server 公用程式

本小節協助您判斷需要執行哪些公用程式，才能讓所有行事曆資料庫及 LDAP 資料庫達到 Calendar Server 6.3 軟體等級。

請使用下表來尋找要執行的正確公用程式集合：

備註 –

依特定的順序來執行公用程式。

表 3–1 選擇正確的公用程式


計劃遷移的 Calendar Server 版本	資料庫檔案的情況	要使用的公用程式
Calendar Server 6.0、6.1、6.2	您正在使用重複發生的事件及工作，並且已在過去執行了 `cs5migrate`。您已使用 Schema 2。	執行 `csmigrate`
Calendar Server 6.0、6.1、6.2	您正在使用重複發生的事件及工作，並且已在過去執行了 `cs5migrate`。您之前沒有使用 Schema 2，但是現在需要使用。	執行 `csmigrate` 及 `commdirmig`。
Calendar Server 6.0、6.1、6.2	您從未對檔案執行 `cs5migrate`。您已使用 Schema 2，或您在 Schema 1 並計劃一直使用它。	執行 `cs5migrate` 及 `csmigrate`。
Calendar Server 6.0、6.1、6.2	您從未對檔案執行 `cs5migrate`。您之前沒有使用 Schema 2，但是現在需要使用。	執行 `cs5migrate`、`csmigrate` 及 `commdirmig`。
Calendar Server 5.1.1	過去您沒有使用多個網域。	執行 `csmig`、`csvdmig`、`cs5migrate`、`csmigrate` 及 `commdirmig`。
早於 Calendar Server 5.1.1	您的檔案不支援多個網域或 LDAP CLD。您的 LDAP 資料庫正在使用 Schema 1。	打電話給技術支援人員，以協助您將資料庫及 LDAP 檔案升級到 Calendar Server 5.1.1 等級。
早於 Calendar Server 5.1.1	您的系統是針對有限的虛擬網域而配置的，或您已在早於 Solaris 10 的作業系統上安裝多個 Calendar Server 軟體實例。	連絡銷售客戶代表，以評估您的遷移需求。

3.3 csmigrate 公用程式

csmigrate 公用程式是用來將 Calendar Server 6.0、6.1 或 6.2 資料庫遷移至 Calendar Server 6.3 資料庫。您可以在 Calendar Server 產品的 sbin 目錄中找到 csmigrate 公用程式，以及其他管理工具。

本小節包含以下主題：

3.3.1 csmigrate 公用程式語法

csmigrate 指令的語法為：

csmigrate [-q] [-d] [-l min|max] [-b backup_dir] source_dbdir target_dbdir

選項及其用法如下：

-q (選擇性): 指定無訊息模式及無列印說明。
-d (選擇性): 指定模擬測試模式及不寫入新的資料庫。
-l min|max (選擇性): 指定記錄層級。遷移記錄會寫入 csmigrate.log，而錯誤則會寫入預設記錄目錄中的 csmigrateError.log。
-b backup_dir (選擇性): 指定要備份來源資料庫的目錄。程式會將來源資料庫備份至這個目錄，並在該副本上工作，以防止來源資料庫發生任何損毀。預設位置為來源資料庫目錄下的 backup。
-source_dbdir (必要): 預先遷移資料庫檔案所在的目錄。
-target_dbdir (必要): 建立遷移後檔案的目錄。
-V (其他支援的選項): 列印工具的版本資訊。
-? (其他支援的選項): 列印工具的用法資訊。

備註 –

程式的結束碼在失敗時為 255，在成功時為 0。

3.3.2 csmigrate 範例

在 csmigrate 指令中使用選項的範例為：

csmigrate -b /var/opt/SUNWics5/tmpdb /var/opt/SUNWics5/old_db /var/opt/SUNWics5/new_db
csmigrate -q /var/opt/SUNWics5/old_db /var/opt/SUNWics5/new_db
csmigrate -l min old_db /var/opt/SUNWics5/new_db
csmigrate -l max old_db /var/opt/SUNWics5/new_db

如何執行 Calendar Server csmigrate 公用程式

以超級使用者權限登入。

停止所有服務。

例如，發出以下指令：
```
stop-cal
```

將您目前的資料庫移至暫存目錄。

例如，將整個 csdb 目錄移至 oldcsdb。
```
mv cal-svr-base/SUNWics5/csdb/* cal-svr-base/SUNWics5/oldcsdb
```

確定該目錄中的新目錄及舊檔案都是預設管理員 (icsuser, icsgroup) 所有。

如果所有權不正確，請使用以下指令來變更所有權：
```
chown -R icsuser:icsgroup /cal-svr-base/SUNWics5/oldcsdb/
```

執行遷移工具。

從您的新備份副本 (oldcsdb) 遷移至 csdb 目錄，如以下範例所示：

cd cal-svr-base/SUNWics5/cal/sbin/ 
./csmigrate -l max /cal-svr-base/SUNWics5/oldcsdb cal-svr-base/SUNWics5/csdb

重新啟動行事曆服務。

例如，使用以下指令：
```
start-cal
```

3.4 cs5migrate 公用程式

cs5migrate 公用程式用於將 Calendar Server 5.1.1 資料庫遷移至 Calendar Server 6.3 等級。此外，如果您是從其中一個 Calendar Server 6 之前版本遷移，而且未使用重複選項，也請執行這個公用程式。

cs5migrate 公用程式會執行以下工作：

備註 –

過去，如果未計劃使用 Connector for Microsoft Outlook，則您可以選擇執行這個公用程式，而不進行週期性的資料轉換。不過，從 Calendar Server 6.3 開始，您必須將週期性的資料轉換為新格式。

在您升級至 Calendar Server 6.3 軟體之後，這個公用程式位於 sbin 目錄，其中還有其他管理工具。

3.5 csmig 公用程式

csmig 公用程式會為行事曆資料庫中的每個行事曆指定一個所有者，並在需要時將每個行事曆 ID (calid) 對映至一個所有者。

csmig 公用程式支援多個網域及 LDAP 行事曆查找資料庫 (Calendar Lookup Database, CLD) 外掛程式。遷移資料庫中的行事曆可使用 LDAP CLD 外掛程式進行存取。如需有關 LDAP CLD 外掛程式的資訊，請參閱第 5 章, 在 Calendar Server 版本 6.3 中，將行事曆資料庫配置為分布在多台機器上。

本小節說明以下主題：

3.5.1 csmig 公用程式功能

csmig 遷移公用程式可執行以下功能：

3.5.1.1 遷移行事曆

csmig 可遷移 caldb.berkeleydb.homedir.path 參數所指定的目前行事曆資料庫 (*.db 檔案) 中的使用者行事曆和資源行事曆。在新的目標資料庫中，csmig 會更新行事曆特性 (calprops)、事件、待辦事項 (工作) 以及群組排程引擎 (GSE) 資料庫檔案中 LDAP CLD 外掛程式所需的項目。

csmig 僅會寫入至目標資料庫，而不會更新您的現有行事曆資料庫。

3.5.1.2 為行事曆指定所有者

csmig 可為行事曆資料庫中的每個行事曆指定一個所有者，並且可將每個行事曆 ID (calid) 對映至一個所有者 (如果需要)。所有預設 calids 都會保持原狀，不進行任何變更。

其他行事曆則以下列方式進行對映：

不具有有效所有者的使用者行事曆將由透過 -c 選項傳送至 csmig 的使用者所有。例如，如果行事曆 ID jsmith 不具有所有者，它將轉換為 orphan:jsmith，其中 orphan 被指定為 -c 選項。
不具有所有者的資源行事曆將由透過 -r 選項傳送至 csmig 的資源使用者所有。
如果資源行事曆名稱中含有冒號 (:)，這些冒號會被轉換為底線，以便遷移名稱中僅有一個冒號。

例如，所有者為 bkamdar 的名為 football 的行事曆會被轉換為 bkamdar:football。所有者為 bkamdar 的名為 tchang:soccer 的行事曆會被轉換為 bkamdar:tchang_soccer。所有者為 admin1 的名為 auditorium:room1 的資源行事曆會被轉換為 admin1:auditorium_room1。

3.5.1.3 更新 LDAP 屬性

csmig 可更新所有相關 LDAP 項目的 LDAP 屬性，包括 icsSubscribed、icsCalendar、icsCalendarOwned、icsFreeBusy、icsSet 和 uid (對於資源行事曆)。csmig 可為 LDAP 目錄伺服器資料庫中的每個行事曆建立 icsDWPHost 屬性。icsDWPHost 可指定行事曆所在的後端伺服器的主機名稱。

3.5.2 csmig 公用程式需求

使用 csmig 的需求為：

行事曆資料庫不能損毀。使用 csdb check 指令檢查行事曆資料庫，如有必要，請執行 csdb rebuild 指令以重建資料庫。如需有關這些指令的資訊，請參閱附錄 DCalendar Server 指令行公用程式參照。
您必須具有足夠的磁碟空間來容納新的目標資料庫。如果適用，也應該為備份資料庫準備足夠的磁碟空間。
若要執行 csmig，請以 icsuser 的身份 (或以配置期間指定的 Calendar Server 執行階段使用者 ID 的身份) 登入。如果您以超級使用者 (root) 的身份執行 csmig，則可能需要重設遷移檔案的權限。

您還必須具有管理 LDAP 目錄伺服器 (儲存使用者喜好設定) 中行事曆使用者屬性的權限。
必須停止 Calendar Server。

3.5.3 csmig 語法

csmig 公用程式具有以下語法：

csmig [-t DestinationDB]
      [-b Backend-DWPHost]
      [-o OutputFile]
      [-e ErrorFile]
      [-m MappingFile]
      [-c calendarOwner]
      [-r resourceOwner]
      { migrate|dryrun }

下表列出公用程式選項，並提供對每個公用程式的說明以及預設值。

csmig 選項	說明和預設值
`-t` `DestinationDB`	指定 `csmig` 產生的目標資料庫。預設為 `MigratedDB`。
`-b` `Backend-DWPHost`	指定 DWP 後端主機伺服器名稱。這個名稱必須與 `ics.conf` 檔案中指定的 DWP 後端主機伺服器名稱相符。
`-o` `OutputFile`	指定一個輸出檔案，該檔案會將 `csmig` 輸出及發生的所有錯誤擷取到螢幕。預設為 `MigrateOut`。
`-e` `ErrorFile`	`csmig` 在其中寫入所有無法解決的錯誤或資料庫項目的檔案。如果資料庫項目無法解決，則它們不會被寫入目標資料庫。預設為 `MigrateError`。
`-m` `MappingFile`	指定在 `dryrun` 模式中產生的輸出對映檔案，該檔案列出了 LDAP 模式中需要變更的項目。例如：舊的：`calid=jsmith` 新的：`calid=jsmith:basketball` 對映檔案僅提供要對 LDAP 模式所做的變更清單。csmig 實際上不會對模式做出變更對映檔案不用於 `migrate` 模式。
`-c` `calendarOwner`	為不具有所有者的使用者行事曆指定所有者。
`-r` `resourceOwner`	為不具有所有者的資源行事曆指定所有者。
`migrate\|dryrun`	指定公用程式的執行模式。使用 `migrate` 模式執行遷移。在實際遷移之前，使用 `dryrun` 模式產生輸出對映檔案。

3.5.4 csmig 公用程式遷移步驟

如果您有版本 5.1.1 之前的 Calendar Server 版本，則在安裝並配置 Calendar Server 6.3 之後，請執行 csmig，以遷移現有的 Calendar Server 及 LDAP 資料庫。要 LDAP CLD 外掛程式正常作業，必須遷移 LDAP 資料。使用 csmig 遷移行事曆資料時，執行以下步驟：

使用 csmig 的高階步驟

使用 comm_dssetup.pl 配置您的目錄伺服器。

如果尚未使用 comm_dssetup.pl 建立 LDAP 屬性的索引，請在此時建立。這將大大提昇 LDAP 資料遷移的效能。

使用展示伺服器 (非生產伺服器) 執行模擬測試。

模擬測試會報告 csmig 在實際遷移期間將執行的作業，但不會遷移任何資料。在模擬測試之後，實際遷移之前，請修正所有錯誤，並決定處理任何未解決的行事曆的計劃。

如需有關如何執行模擬測試的說明，請參閱3.5.4 csmig 公用程式遷移步驟。

遷移生產資料

生產執行期間，csmig 會遷移行事曆資料庫 (.db 檔案) 和 LDAP 資料 (使用者和群組喜好設定資料)、icsSubscribed、icsCalendar、icsCalendarOwned、icsFreeBusy、icsSet 和 uid (對於資源行事曆)。遷移之後，所有行事曆資源都會建立一個 LDAP 項目。

如需有關如何遷移生產資料的說明，請參閱3.5.4 csmig 公用程式遷移步驟。

執行模擬測試

在展示伺服器上安裝 Calendar Server 6.3 (如有必要)。

將行事曆資料庫的快照複製到展示伺服器中。

透過執行以下工作在展示伺服器上模仿生產 LDAP 環境：
- 安裝 Directory Server。
- 在此伺服器上安裝 LDAP 資料庫的快照。

執行 comm_dssetup.pl 以配置展示 Directory Server。

執行 csconfigurator.sh 以配置展示 Calendar Server。

以 icsuser 的身份登入 (或者，如果不同，以配置期間指定的 Calendar Server 執行階段使用者 ID 的身份登入)。如果您以超級使用者 (root) 的身份執行 csmig，則可能需要重設遷移檔案的權限。

移至 cal-svr-base/SUNWics5/cal/sbin 目錄。

執行 csdb check 指令以檢查資料庫是否有損毀。如果指示資料庫已損毀，請執行 csdb rebuild 指令以重建資料庫。

考量為不具有所有者的使用者行事曆建立 catchall calid。例如，以下指令將建立 calid 為 orphan 的使用者：
./csuser -g orphan -s adminuser -y password -l en -c orphan create orphan

使用 stop-cal 指令停止 Calendar Server (如有必要)。

cal-svr-base/SUNWics5/cal/sbin/stop-cal

使用 -dryrun 選項執行 csmig。例如，您可以輸入︰
```
./csmig -b sesta.com -o csmig.out -e csmig.errors
 -m csmig.map -c orphan -r calmaster dryrun
```
此指令將不具有所有者的使用者行事曆 (無主行事曆) 指定給所有者 orphan，將不具有所有者的資源行事曆指定給所有者 calmaster。

檢查輸出對映檔案 (csmig.map)。對映檔案列出 LDAP 模式中需要更新的項目。

檢查輸出檔案、對映檔案與錯誤檔案。解決您發現的所有 LDAP 問題或錯誤。在實際遷移之前，決定如何處理所有未解決的行事曆。

有以下選項可供選擇：
- 在遷移之前，刪除所有不需要的行事曆。
- 為所有未解決的行事曆指定所有者。
- 在遷移期間，允許 csmig 使用 -c 及 -r 選項為行事曆指定所有者。

執行 csmig 以遷移展示行事曆資料庫。

例如，以下指令可將行事曆資料庫遷移至 /var/opt/SUNWics5/testcsdb/ 目錄：
```
./csmig -t /var/opt/SUNWics5/testcsdb/ -b sesta.com 
-o csmig.out -e csmig.errors -m csmig.map -c orphan 
-r calmaster migrate
```

完成測試遷移後，請執行以下步驟以檢查新遷移的行事曆資料庫。
1. 將遷移資料庫複製至 caldb.berkeleydb.homedir.path 參數指定的 /csdb 目錄中。或者，編輯此參數以指向遷移資料庫的新位置。
2. 對新的行事曆資料庫執行 csdb check。遷移資料庫中的事件數與待辦事項數應該與遷移前資料庫中的總數相符。
3. 搜尋 icsCalendarOwned 項目，並確定這些項目與遷移前的行事曆數目相符。
4. 登入 Communications Express，並驗證某些行事曆是否存在於遷移資料庫中。
  
  如果測試遷移成功，您便可以遷移生產資料庫。

遷移生產資料

以 icsuser 的身份 (或以配置期間指定的 Calendar Server 執行階段使用者 ID 的身份) 登入。如果您以超級使用者 (root) 的身份執行 csmig，則可能需要重設遷移檔案的權限。

移至 cal-svr-base/SUNWics5/cal/sbin 目錄。

使用 stop-cal 指令停止 Calendar Server。

cal-svr-base/SUNWics5/cal/sbin/stop-cal

備份下列資料：
- 行事曆資料庫 (.db 檔案)。
- LDAP 資料：slapd 資料庫目錄與 LDAP 資料庫。
- ics.conf 檔案。實際上不需要此步驟，但如果要復原至原始配置，該步驟會很有用。

使用 -migrate 選項執行 csmig。

例如，以下指令可將行事曆資料庫遷移至 /var/opt/SUNWics5/newcsdb/ 目錄：

./csmig -t /var/opt/SUNWics5/newcsdb/ -b sesta.com 
-o csmig.out -e csmig.errors -m csmig.log -c orphan 
-r calmaster migrate

檢查錯誤檔案 (csmig.errors) 中是否存在未解決的行事曆，並按照3.5.4 csmig 公用程式遷移步驟下3.5.4 csmig 公用程式遷移步驟中的計劃進行解決。

執行 csdb check 指令以檢查遷移資料庫。如果指示任何資料庫已毀損，請執行 csdb rebuild 以重建資料庫。

將新的遷移資料庫複製至 caldb.berkeleydb.homedir.path 參數指定的 /csdb 目錄中。或者，編輯此參數以指向遷移資料庫的新位置。

啟用 LDAP CLD 外掛程式，方法為對 ics.conf 檔案中的以下配置參數進行任何必要的變更：
- service.dwp.enable = "yes"
- service.dwp.port = "59779"
- csapi.plugin.calendarlookup = "yes"
- csapi.plugin.calendarlookup.name = "*"
- caldb.cld.type = "directory"
- caldb.dwp.server.default = "default-server-name"
- caldb.dwp.server.server-hostname.ip = "server-hostname" (適用於包括本機伺服器的每台後端伺服器)
- caldb.cld.cache.enable = "yes" (如果您要使用 CLD 快取選項)
- caldb.cld.cache.homedir.path 指定 CLD 快取目錄的位置。預設為 /var/opt/SUNWics5/csdb/cld_cache。
  
  如需有關設定 LDAP CLD 外掛程式的配置參數的資訊，請參閱第 5 章, 在 Calendar Server 版本 6.3 中，將行事曆資料庫配置為分布在多台機器上。

使用 start-cal 指令重新啟動 Calendar Server。

登入 Communications Express，並透過檢查一些遷移行事曆來驗證您的配置是否正常工作。

若要在進行檢查時停用警示，請將 ics.conf 檔案中的以下每個參數均設定為 "no"：
- caldb.serveralarms = "no"
- caldb.serveralarms.dispatch = "no"
- service.ens.enable = "no"
- service.notify.enable = "no"
- ine.cancellation.enable = "no"
- ine.invitation.enable = "no"
- service.admin.alarm = "no"

3.5.5 csmig 提示與疑難排解

本小節說明以下提示與疑難排解範例：

3.5.5.1 csmig 模擬測試行事曆會顯示行事曆的錯誤所有者。

問題範例

名為 tchang:myCalendar 的行事曆在行事曆資料庫中的所有者為 jsmith，而 csmig 模擬測試將對映顯示為 jsmith:tchang_myCalendar。但是，您希望將此行事曆命名為 tchang:myCalendar，並將所有者指定為 tchang。

解決方案範例

在遷移之前，使用 cscal 公用程式，將行事曆的所有者 tchang:myCalendar 變更為 tchang。完成此項工作後，遷移便會將這個行事曆對映至 tchang:myCalendar，並將 icsCalendarowned 增加至使用者 ID tchang 的 LDAP 項目。

3.5.5.2 無法正常搜尋 LDAP 行事曆。

問題範例

遷移之後，將啟用 LDAP 行事曆搜尋，但是行事曆搜尋對話方塊不會傳回任何結果，或僅傳回部分結果。

解決方案範例

啟用 LDAP 行事曆搜尋使得 Calendar Server 可以搜尋 (&(objectclass=icscalendaruser)(icscalendarowned=*substr*))。

使用以下篩選器對 LDAP 資料手動執行兩種不同的搜尋，並比較輸出結果：

LDAP 搜尋，篩選器為 (&(objectclass=icscalendaruser)(icscalendarowned=*substr*))
LDAP 搜尋，篩選器為 (icscalendarowned=*substr*)

由於伺服器會使用包括 icsCalendarUser 物件類別的篩選器，因此在模式檢查停用的情況下可能已部署 LDAP 伺服器，並且可能已佈建某些不具有 icsCalendarUser 物件類別的行事曆項目。

3.5.5.3 csmig 模擬測試指出存在重複的行事曆名稱。

問題範例

csmig 模擬測試對映檔案與輸出檔案指示存在重複的行事曆名稱。

例如，在原始資料庫中，jsmith 擁有以下行事曆：

包含 5 個事件的 basketball
包含 10 個事件的 jsmith:basketball

模擬測試指示在遷移期間將合併這兩個行事曆，最後生成的行事曆將為 jsmith:basketball，其所有者為 jsmith，共包含 15 個事件

輸出檔案將包含下列警告訊息：

Error modifying calendar properties, error=2

解決方案範例

如果您不想合併這兩個行事曆，請在遷移之前將 basketball 的所有者變更為 jsmith 之外的其他所有者。這樣做會保留兩個獨立行事曆的資料完整性。

3.5.5.4 我如何將無主行事曆指定給不同的所有者？

問題範例

依預設，csmig 會將所有無主行事曆指定給單一所有者，但是我想為某些無主行事曆指定不同的所有者。

解決方案範例

csmig 不接受指令行中的對映檔案。但是，您可以在遷移之前，將所有者指定給原始資料庫中的無主行事曆。檢查所有無主行事曆的模擬測試對映檔案。然後在遷移之前，使用 cscal 公用程式將所有者指定給無主行事曆。以 -dryrun 模式再次執行 csmig，以驗證新的所有者。

3.5.5.5 如何將行事曆使用者移至另一個後端伺服器？

問題範例

我如何將使用者從一台後端伺服器移至另一台後端伺服器

解決方案範例

若要移動行事曆使用者，請 export 原始伺服器上的每個使用者行事曆，然後將這些行事曆 import 另一台伺服器。移動行事曆之後，您可以刪除原始伺服器上的行事曆。如需有關如何移動行事曆的說明，請參閱15.6 管理使用者行事曆。

3.6 csvdmig

csvdmig 公用程式可準備行事曆資料庫及 LDAP 使用者和群組項目，以在多個網域的環境中使用它們。即使您計劃只使用預設網域，也須執行這個公用程式。

備註 –

如果您是從非網域環境遷移至 Calendar Server 6.3 的多個網域的環境，請務必在使用這個公用程式之前執行 csmig。

本小節包含以下主題：

3.6.1 csvdmig 功能

csvdmig 公用程式會對資料庫及 LDAP 項目執行以下變更：

行事曆 ID (calids) 的格式會變更：

從：userid[:calendar-name]

變更為： userid@domain[:calendar-name]
存取控制清單 (ACL) 存取規則變更如下：

從： userid

變更為：userid@domain
Calendar Server 屬性的 LDAP 目錄伺服器使用者項目修改如下：

userid[:calendar-name] 至 userid@domain[:calendar-name]。
更新行事曆資料庫中事件與工作的所有者欄位和與會者欄位。例如：

如果網域 sesta.com 中的 jsmith 是事件的所有者，則新的所有者欄位將包含 jsmith@sesta.com。

注意 –

csvdmig 公用程式會在原位更新資料庫及 LDAP 目錄。也就是說，它不建立獨立的遷移資料庫，而是變更您要轉換的資料庫。因此，為安全起見，請對您的資料庫快照及 LDAP 目錄執行 csvdmig。

3.6.2 csvdmig 語法

csvdmig 公用程式的語法如下：

csvdmig [-t DestinationDB]
         [-c ConfigFile]
         [-e ErrorFile]
         [-m MappingFile]
         migrate [DB|LDAP]

下表列出 csvdmig 所使用的選項，並提供對每個選項的說明。

選項	說明和預設值
`-m` `MappingFile`	指定對映檔案的輸入參數。如需有關對映檔案的更多資訊，請參閱3.6.2.1 對映檔案。預設為 `MigrateMapping`。
`-c` `ConfigFile`	指定 Calendar Server 配置檔案的輸入參數。預設為 `ics.conf` 檔案。
`-t` `DestinationDB`	指定要遷移的資料庫位置的輸出參數。預設為 `MigratedDB`。提示 – 始終使用 `-t` 選項。如需有關這個選項的更多資訊，請參閱3.6.2.2 目標 DB。
`-e` `ErrorFile`	用於為無法解決的錯誤指定錯誤檔案名稱的輸出參數。預設為 `MigrateError`。
`DB` \| `LDAP`	指定要修改哪個資料庫： `DB` – 行事曆資料庫 `LDAP` – LDAP 目錄預設為行事曆資料庫 (`DB`)。

3.6.2.1 對映檔案

對映檔案是輸入文字檔案它將現有使用者對映至他們各自的網域。執行 csvdmig 之前，必須先建立對映檔案。每一行指定一個項目，新舊值之間用空格分隔。例如：

user1 user1@sesta.com
user2 user2@siroe.com
user3 user3@sesta.com
 ...
usern usern@siroe.com

3.6.2.2 目標 DB

要遷移的資料庫位置。公用程式會在原位更新檔案。請確定在使用 csvdmig 公用程式之前，已備份這個目錄。

如果未指定 -t 選項，公用程式將嘗試遷移目前目錄 (在指令行執行 pwd 所指定的目錄) 的內容，而結果無法預期。

3.6.3 csvdmig 範例

以下是 csvdmig 範例

使用預設值遷移 LDAP 目錄伺服器：
```
csvdmig migrate LDAP
```

遷移 Calendar Server 資料庫：

csvdmig -t targetDB -e errorFile -m mappingFile migrate

3.7 commdirmig

commdirmig 公用程式會將您的 LDAP 資料從 Sun Java System LDAP Schema 1 遷移至 Schema 2，以準備使用 Access Manager 來進行認證服務。如果先前的安裝已使用 Schema 2，您不必再次執行這個公用程式。

3.7.1 誰應該執行 commdirmig 公用程式

這個遷移公用程式會將您的 Schema 1 LDAP 資料庫遷移至 Schema 2。如果您即將使用 Access Manager 軟體進行認證，則必須透過執行這個公用程式，將您的 LDAP 項目轉換為 Schema 2 格式。

如果未使用 Access Manager，您仍應考量遷移 LDAP 資料，因為 Schema 2 是所有使用 LDAP 的 Communications Suite 產品偏好的 LDAP 模式。

備註 –

如果您具有用於喜好設定的獨立 LDAP 目錄，則必須在該 LDAP 和用於認證的 LDAP 上執行 commdirmig。

3.7.2 何時執行 commdirmig 公用程式

在執行了將您的行事曆及 LDAP 資料庫從舊版的 Calendar Server 軟體遷移至版本 6.3 的 Calendar Server 軟體所需的所有其他遷移公用程式之後，才執行 commdirmig。

3.7.3 何處可以找到 commdirmig 公用程式的相關文件

commdirmig 遷移公用程式需要特殊的準備及規劃。這在獨立的指南中有說明，請參閱「Sun Java Communications Suite 5 Schema Migration Guide 」。

3.7.4 公用程式的位置

commdirmig 公用程式隨附於您使用 Communications Suite 安裝程式安裝的 Delegated Administrator。

還可從技術支援部門獲得用於該公用程式的修補程式。