Sun Java System Calendar Server 6 2005Q4 管理指南

csrename

csrename 公用程式可讓您重新命名一個或多個行事曆使用者。此公用程式將重新命名行事曆使用者，如下所示：

行事曆資料庫檔案 – 在行事曆資料庫檔案中重新命名使用者 (使用者 ID)，然後將新的資料庫檔案寫入目標目錄。現有行事曆資料庫檔案不會被修改。
LDAP 目錄伺服器 – 轉換 Calendar Server LDAP 屬性 (亦即帶有「ics」前綴的屬性) 中的使用者 ID。系統會適當地修改 LDAP 目錄伺服器。

csrename 公用程式位於以下目錄：

cal_svr_base/SUNWics5/cal/sbin

需求

執行 csrename 之前，您必須首先：

為您要轉換的使用者建立輸入對映檔案 (-m 選項)。
如有必要，在 LDAP 目錄伺服器中建立新使用者。
停止 Calendar Server。

若要執行 csrename，您必須以 icsuser 身份 (或以配置期間指定的 Calendar Server 執行階段使用者 ID 身份) 登入。如果您以超級使用者 (root) 的身份執行 csrename，則可能需要重設新資料庫檔案的權限。若要修改 LDAP 目錄伺服器屬性，您還必須擁有對該目錄的管理權限。

如果您的 Calendar Server 安裝具有前端/後端伺服器配置，則必須在每台後端伺服器上執行 csrename。

語法

請使用以下語法執行 csrename：

csrename [-t DestinationDB] 
         [-c ConfigFile]
         [-e ErrorFile] 
          -m MappingFile 
         rename [DB|LDAP]

下表列出了該公用程式的選項，並對各選項進行了說明：

表 D–27 csrename 的選項


選項	說明
`-t` `DestinationDB`	指定 `csrename` 產生包含轉換的使用者名稱的新資料庫的目標目錄。預設為 `MigratedDB`。`csrename` 完成後，ics.conf 檔案中的 caldb.berkeleydb.homedir.path 參數必須指向目標資料庫。可以重設 caldb.berkeleydb.homedir.path 以指向目標資料庫目錄，也可以將目標資料庫檔案移至該參數所指定的目錄。
`-c` `ConfigFile`	一個輸入參數可指定 Calendar Server 配置檔案。預設為 `ics.conf` 檔案。`csrename` 使用配置檔案中的 `caldb.berkeleydb.homedir.path` 參數來確定輸入行事曆資料庫的位置。行事曆資料庫的預設位置為 /var/opt/SUNWics5/csdb。
`-e` `ErrorFile`	`csrename` 在其中寫入所有錯誤或無法解決的資料庫項目的檔案。預設為 `MigrateError`。
`-m` `MappingFile`	指定輸入對映檔案。預設為 `MigrateMapping`。輸入對映檔案是將現有的使用者 ID 對映至新的使用者 ID 的文字檔案。執行 `csrename` 之前，必須先建立對映檔案。每一行指定一個項目，新舊值之間用空格分隔。例如： tchang tc897675 jsmith js963123 bkamdar bk548769 如果在稽核搜索結果時發現一個或多個要變更的名稱被忽略，您可以透過建立僅包含缺少的名稱的新對映檔案和重新執行 `csrename` 來修正該錯誤。
`DB`\|`LDAP`	指定要進行更新的資料庫： `DB` 僅轉換新行事曆資料庫中的使用者 ID (預設)。 `LDAP` 同時轉換新行事曆資料庫和 LDAP 目錄伺服器屬性中的使用者 ID。

範例

根據名為 DBMapFile 的對映檔案重新命名使用者，並在目標目錄中建立名為 newcalDB 的新行事曆資料庫：
```
csrename -t newcalDB -m DBMapFile rename DB
```
根據名為 NewNames 的對映檔案中的值重新命名使用者，在目標目錄中建立名為 NewDB 的新行事曆資料庫，並修改 LDAP 目錄伺服器中的 Calendar Server 屬性：
```
csrename -t NewDB -m NewNames rename LDAP
```