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–25 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