|
||
|
如需每個公用程式的簡短說明,請參閱D.2 指令行公用程式的簡短說明。
Calendar Server 提供未包括在 Access Manager 隨附的 Delegated Administrator 中的指令行公用程式。
這些 Calendar Server 公用程式可從 batch、shell 和程序檔程式 (如 Perl) 啟動。在這些公用程式中,某些 (csuser、csresource 和 csdomain) 已由 Delegated Administrator 公用程式所取代,但其餘的仍在使用,即使在 Schema 2 環境中也是如此。對於 Schema 1,您必須繼續使用 csuser、csresource 和 csdomain,而不能使用 Delegated Administrator。
如果需要,這些公用程式可使用 ics.conf 配置檔案的預設值。
這些指令行公用程式位於以下目錄中︰cal-svr-base/SUNWics5/cal/sbin
除 start-cal 和 stop-cal 可以從任何目錄 (如果已指定完整路徑) 執行之外,所有其他公用程式均必須從 sbin 目錄啟動。
這些管理工具的錯誤訊息是被寫入 csdb 目錄中的 admin.log 檔案。
本章提供以下資訊︰
以執行 Calendar Server 的使用者和群組身份或 root 身份登入時,執行指令行公用程式。這是在安裝期間指定;預設為 icsuser 和 icsgroup。
例如,如果 Calendar Server 基底目錄為 cal-svr-base,若要執行 cscal 公用程式的 list 指令,您需要在登入後執行以下指令:
cd cal-svr-base/SUNWics5/cal/sbin ./cscal list
Calendar Server 指令行公用程式使用以下語法︰
utility [ -option [value]] command [target]
其中:
utility 為公用程式的可執行名稱,例如 cscal 或 csuser。
option 決定指令所執行的動作。選項為小寫且前面帶有連字符 (-),例如 -d。括號 ([]) 中的選項是可選擇的。如果指明,則可同時使用兩個或多個選項。
value 進一步限定 option 指定的動作,例如與 -d 選項配合使用的說明。括號 ([]) 中的值是可選擇的。包含空格的值必須置於引號 ("") 中。多個值必須置於引號 ("") 中,且各值之間必須以空格分隔,除非另有指示,例如使用以分號分隔的清單。
command 為公用程式執行的動作,例如 list 或 create。以垂直線 (|) 分隔的指令指示可同時使用任一指令,而不是一起使用這兩個指令。
target 為指令在其上生效的物件,例如行事曆 ID 或使用者 ID。
如果您僅指定公用程式的名稱,它則列出所有指令、選項以及數個範例。
如果您未指定必需的密碼,公用程式則提示您指定密碼。
-v (詳細) 和 -q (無訊息) 選項可用於每個公用程式。
如果是危險指令 (即可能會導致資料遺失的指令),則公用程式會在執行該指令之前提示您進行確認。危險指令的範例為 cscal (可刪除行事曆) 和 csuser (可刪除使用者)。但是,-q (無訊息) 選項會停用確認提示。
version 指令可用於每個公用程式。
如果您從程序檔執行指令行公用程式,則當公用程式執行成功時,回覆碼為 "0",失敗時則為 "-1" 。
下表提供 Calendar Server 指令行公用程式的簡短說明。
表 D–1 Calendar Server 指令行公用程式摘要
公用程式 |
說明 |
---|---|
針對 Schema 1 管理行事曆使用者或資源的 LDAP 屬性。 |
|
備份個別行事曆、使用者以及行事曆資料庫。 |
|
管理行事曆及其特性。 |
|
移除其狀態屬性 (inetUserStatus) 已被 Delegated Administrator 標記為「已刪除」的 Calendar Server 使用者的使用者行事曆和資源行事曆。 |
|
管理行事曆元件︰事件和工作 (待辦事項)。 |
|
管理行事曆資料庫。 |
|
針對 Schema 1 管理網域 LDAP 項目中的 Calendar Server 屬性。 |
|
以 iCalendar (.ics) 或 XML (.xml) 格式匯出行事曆。 |
|
以 iCalendar (.ics) 或 XML (.xml) 格式匯出行事曆。 |
|
允許手動清除刪除記錄資料庫 (ics50deletelog.db) 中的項目。 |
|
允許重新命名使用者 ID。導致整個資料庫被重寫。 |
|
管理行事曆資源,如會議室和設備。 |
|
復原個別行事曆、使用者以及行事曆資料庫。 |
|
管理群組排程引擎 (GSE) 佇列中的排程項目。 |
|
顯示 Calendar Server 中的計數器。 |
|
管理 Schema 1 的行事曆使用者。 |
|
啟動所有 Calendar Server 程序。 |
|
停止所有 Calendar Server 程序。 |
csattribute 公用程式只適用於 Schema 1 模式。它會管理 Calendar Server 使用者或資源 LDAP 項目屬性。指令包括︰
add,將 LDAP 屬性和值增加至指定目標 (使用者或資源物件)。
list,列出目標物件的屬性。
delete,從目標中刪除屬性。
如果您的網站使用的是 LDAP CLD 外掛程式,請勿在嘗試指定新的後端主機伺服器時使用 csattribute 變更 icsDWPHost 屬性。修改 icsDWPHost 不會在新的後端主機上建立新的行事曆。如需更多資訊,請參閱第 5 章, 在 Calendar Server 版本 6.3 中,將行事曆資料庫配置為分布在多台機器上
您必須使用 Schema 1。
Calendar Server 可以處於執行中或停止狀態。
您必須以執行 Calendar Server 的使用者或群組 (在安裝期間指定,例如 icsuser 和 icsgroup) 的身份或以 root 身份登入。
csattribute [-q|-v] -a attribute=value [-t resource | user] [-d domain] add target csattribute [-q|-v] -a attribute[=value] [-t resource | user] [-d domain] delete target csattribute [-q | -v] [-t resource | user] [-d domain] list target |
下表說明 csattribute 可用的指令。
表 D–2 csattribute 公用程式指令
指令 |
說明 |
---|---|
add target |
將 LDAP 屬性和值增加至指定目標 (使用者或資源物件)。 |
list target |
列出目標物件的屬性。 |
delete target |
從目標中刪除屬性。 |
version |
顯示公用程式的版本。 |
下表說明 csattribute 公用程式指令選項。
表 D–3 csattribute 公用程式指令選項
將值為 tchang 的 icsCalendar LDAP 屬性增加至使用者 ID tchang:
csattribute - a icsCalendar=tchang add tchang
從 tchang 中刪除 LDAP 屬性 icsCalendar:
csattribute -a icsCalendar delete tchang
顯示 tchang 的屬性:
csattribute list tchang
csbackup 公用程式可備份行事曆資料庫、指定的行事曆或使用者的預設行事曆。指令包括︰
database,備份行事曆資料庫。
calendar,備份指定的行事曆。
defcal,備份使用者的預設行事曆。
version,顯示目前安裝之公用程式的版本編號。
位於指定備份目錄中的 caldb.conf 版本檔案顯示已備份資料庫的版本編號。
如需有關 csrestore 的資訊,請參閱D.16 csrestore。
Calendar Server 可以處於執行中或停止狀態。
您必須在安裝了 Calendar Server 的機器上本機執行此公用程式。
您必須以執行 Calendar Server 的使用者或群組 (在安裝期間指定,例如 icsuser 和 icsgroup) 的身份或以 root 身份登入。
csbackup [-q|-v] -f database target csbackup [-q|-v] -c calid calendar target csbackup [-q|-v] -a userid [-b basedn] defcal target |
下表說明 csbackup 可用的指令。
表 D–4 csbackup 公用程式指令
指令 |
說明 |
---|---|
database target |
將行事曆資料庫備份至指定的目標資料庫目錄。依預設,目標資料庫目錄為︰ cal-svr-base/SUNWics5/cal/sbin/target-directory 如果您僅指定目標資料庫目錄,請勿在目錄名稱前加斜線 (/)。例如: csbackup database backupdir 注意:如果目標備份目錄已存在,並且您未指定 -f 選項,則 csbackup 公用程式會失敗。例如,如果 backupdir 存在,則即使目錄為空,以下指令也會失敗: csbackup database backupdir 因此,如果您指定已存在的目標備份目錄,請在執行 csbackup 時包含 -f 選項。 您也可以指定不存在的目標備份目錄,並讓 csbackup 為您建立該目錄。 |
calendar calid target |
將指定的行事曆 ID 備份至指定的目標輸出檔案。檔案的資料格式由檔案副檔名決定,.ics 為 text/calendar 格式,.xml 為 text/xml 格式。 |
defcal userid target |
將指定使用者 ID 的預設行事曆備份至指定的目標檔案。檔案的資料格式由檔案副檔名決定,.ics 為 text/calendar 格式,.xml 為 text/xml 格式。 |
version |
顯示公用程式的版本。 |
下表說明 csbackup 公用程式指令選項。
表 D–5 csbackup 公用程式指令選項
選項 |
說明 |
---|---|
-v |
在詳細模式下執行:顯示有關正在執行的指令之所有可用資訊。預設為關閉。 |
-q |
在無訊息模式下執行:
|
-a userid |
要備份的行事曆使用者的使用者 ID。此選項需要預設選項。無預設值。 |
-b basedn |
要用於該使用者的基底 DN。預設使用 ics.conf 檔案中所定義之設定 service.schema2root 的值。 基底 DN (識別名稱) 是 LDAP 目錄中用作搜尋起點的項目。 例如,如果您指定的基底 DN 為 ou=people, o=sesta.com,則由 Calendar Server 執行的所有 LDAP 搜尋作業均將僅檢查 o=sesta.com 目錄樹狀結構中的 ou=people 子樹狀結構。 |
-c calid |
要備份的行事曆 ID。此選項需要與 calendar 指令配合使用。無預設值。 如需更多資訊,請參閱15.2 建立行事曆唯一識別碼 (calid)。 |
-f |
強制所有要刪除的現有備份檔案。 在目前的發行版本中,如果備份目標目錄已存在,則即使該目錄為空,您也必須加上 -f 選項。 |
-l |
準備備份檔案,以與 SolsticeTM BackupTM 或 Legato NetworkerTM 備份程式配合使用。如需更多資訊,請參閱第 17 章, 備份與復原 Calendar Server 資料。 |
將行事曆資料庫備份至名為 backupdir 的目錄:
csbackup database backupdir
將行事曆 ID 為 tchang 的行事曆以 text/calendar 格式備份至檔案 tchang.ics:
csbackup -c tchang calendar tchang.ics
將 tchang 的預設行事曆以 text/xml 格式備份至檔案 tchang.xml:
csbackup - a tchang defcal tchang.xml
create,建立行事曆
delete,刪除行事曆
disable,停用行事曆
enable,啟用行事曆
list,列出行事曆
modify,修改行事曆特性及群組排程存取控制
reset,將行事曆特性重設為預設設定
version,顯示目前安裝之公用程式的版本編號。
您必須在安裝了 Calendar Server 的機器上本機執行此公用程式。
Calendar Server 可以處於執行中或停止狀態。
您必須以執行 Calendar Server 的使用者或群組 (在安裝期間指定,例如 icsuser 和 icsgroup) 的身份或以 root 身份登入。
cscal [-q|-v] [-a aces] [-c charset] [-d description] [-g categories] [-k yes|no] [-l langcode] [-m email] [-n name] [-o owner’s uid] [-y otherowners] create|modify calid cscal [-q|-v] [-o owner’s uid] [-O] delete|reset calid cscal [-q|-v] [-o owner’s uid] [-O] disable|list [calid] cscal [-q|-v] [-k yes|no] [-o owner’s uid] [-O] enable [calid] |
儘管在您輸入 -o (所有者的 uid) 後 cscal 不檢查大小寫,搜尋仍是大小寫不須相符。
下表說明 cscal 公用程式可用的指令。
表 D–6 cscal 公用程式指令
指令 |
說明 |
---|---|
create calid |
建立 calid 指定的行事曆。 注意:如果您的網站使用的是 LDAP CLD 外掛程式,則特定使用者的所有行事曆必須在同一後端伺服器上,如使用者的 icsDWPHost LDAP 屬性所指示。如果您嘗試在其他後端伺服器上建立該使用者的行事曆,Calendar Server 將傳回錯誤。 |
delete calid |
刪除 calid 指定的行事曆。 如果指定 -o owner 選項,則會刪除主要所有者為指定 uid 的所有行事曆。 |
enable [ calid ] |
啟用 calid 指定的行事曆。如果未指定 calid,則會啟用所有行事曆。 如果指定 -o owner 選項,則會啟用主要所有者為指定 uid 的所有行事曆。 |
disable [ calid ] |
停用 calid 指定的行事曆。如果未指定 calid,則會停用所有行事曆。 如果指定 - o owner 選項,則會停用主要所有者為指定 uid 的所有行事曆。 |
list [ calid ] |
列出 calid 所指定行事曆的特性。如果未指定 calid,則會列出所有行事曆的特性。 如果指定 - o owner's uid 選項,則會列出主要所有者為指定所有者 uid 的所有行事曆。 |
modify calid |
修改 calid 所指定行事曆的特性。 |
reset calid |
將 calid 所指定行事曆的特性重設為預設配置設定。 |
version |
顯示公用程式的版本。 |
下表說明 cscal 公用程式指令選項。
表 D–7 cscal 公用程式指令選項
選項 |
說明 |
---|---|
-v |
在詳細模式下執行:顯示有關正在執行的指令之所有可用資訊。預設為關閉。 |
-q |
在無訊息模式下執行:
|
-a [ aces] |
指定行事曆的存取控制項目 (ACE)。ACE 決定可以存取群組排程行事曆的人員,以及他們擁有的權限類型,例如建立、刪除、讀取和寫入權限。ACE 字串或存取控制清單 (ACL) 必須置於引號 (" ") 中。 預設為 ics.conf 檔案中的 calstore.calendar.default.acl 參數。 如需 ACE 格式的詳細資訊,請參閱1.8 Calendar Server 版本 6.3 的存取控制。 |
-c charset |
字元集。預設為無字元集。 |
-d description |
說明 (有關行事曆目的的可檢視註釋)。預設為無說明。 |
-g category |
類別。多個種類必須置於引號 ("") 中,並以空格分隔。預設為無類別。 |
-k yes|no |
指定是否允許使用者行事曆的雙預定。例如,yes 表示行事曆可以為同一時段排程一個以上的事件。 如果忽略 -k 選項,則預設使用 ics.conf 檔案中 user.allow.doublebook 參數的值。但是,僅在建立行事曆時,才使用 user.allow.doublebook 參數。 建立行事曆之後,Calendar Server 將檢查行事曆特性資料庫 ics50calprops.db,以確定是否允許雙預定。如果您需要為行事曆變更行事曆特性以允許或不允許雙預定,請重新發出帶有 -k 選項的 cscal。 |
-l langcode |
語言代碼。預設為無語言代碼。 |
-m email |
電子郵件位址。預設為無電子郵件。 |
-n name |
可檢視的名稱。預設為無名稱。 |
-o owner |
(小寫 o) 主要所有者。預設設定為主要所有者的唯一 ID (uid)。 |
-O |
(大寫 O) 指定主要所有者的所有行事曆。預設僅為已命名的行事曆。 |
-y otherowners |
其他行事曆所有者。多位所有者必須置於引號 ("") 中,並以空格分隔。預設為無其他所有者。 |
若嘗試在指定的後端機器上建立行事曆,並收到以下錯誤訊息:[無效的 DWP 主機伺服器]。則表示出現以下兩種狀況之一。可能是您的伺服器配置錯誤,或已將行事曆所有者指定給其他後端伺服器。
查詢 ics.conf 檔案以找出有問題的後端伺服器。確認存在下列設定:
service.dwp.enable = "yes" caldb.cld.type = "directory" local.hostname = "back-end hostname"
查詢使用者的 LDAP 項目,看是否存在 icsDWPHost 屬性。icsDWPHost 的值必須符合您嘗試建立行事曆所在的後端伺服器的名稱。您無法在其他後端伺服器上建立這個使用者的行事曆。
使用預設存取控制設定 (由 ics.conf 檔案中的 calstore.calendar.default.acl 定義) 建立行事曆 ID 為 tchang 的行事曆,tchang 為主要所有者,顯示名稱為 Public_Calendar︰
cscal - o tchang - n Public_Calendar create tchang
修改行事曆 chang,以便讓所有使用者都擁有讀取和寫入權限,該行事曆與種類 sports 關聯,並由 jsmith@sesta.com 共同所有︰
cscal - a "@^a^rw^g" -g sports -y jsmith@sesta.com modify tchang
停用行事曆 ID 為 tchang 的行事曆 (不允許使用者透過使用者介面讀取、寫入或尋找該行事曆)︰
cscal disable tchang
啟用行事曆 ID 為 tchang 的行事曆 (允許使用者透過使用者介面讀取或寫入該行事曆),但不允許雙預定︰
cscal -k no enable tchang
列出 tchang 的特性:
cscal list tchang
列出 tchang 的所有特性:
cscal - v list tchang
列出資料庫中的所有行事曆︰
cscal list
將行事曆 ID 為 tchang 的行事曆重設為預設配置設定︰
cscal reset tchang
從行事曆 ID 為 tchang 的行事曆中移除說明︰
cscal -d "" modify tchang
從行事曆 ID 為 tchang 的行事曆中移除所有種類︰
cscal -g "" modify tchang
從行事曆 ID 為 tchang 的行事曆中移除其他所有者︰
cscal -y "" modify tchang
從行事曆資料庫中刪除 tchang:
cscal delete tchang
從主要所有者為 tchang 的行事曆資料庫中刪除所有行事曆︰
cscal -o tchang delete
csclean 公用程式只適用於 Schema 2 模式。它可移除其狀態屬性 (icsStatus) 已被 Delegated Administrator 標記為「已刪除」之使用者的使用者行事曆和資源行事曆。
對於 Schema 1,請使用 csuser 和 cscal 來移除已刪除之使用者的所有行事曆。
您必須使用 Schema 2。
Calendar Server 可以處於執行中或停止狀態。
您必須在安裝了 Calendar Server 的機器上本機執行 csclean。
您必須以執行 Calendar Server 的使用者或群組 (在安裝期間指定,例如 icsuser 和 icsgroup) 的身份或以 root 身份登入。
csclean [-q | -v] [-g graceperiod] clean domain |
下表說明 csclean 公用程式指令選項。
表 D–8 csclean 公用程式指令選項
移除 sesta.com 中行事曆服務被刪除 5 天以上的所有使用者和資源的行事曆︰
csclean -g 5 clean sesta.com
移除所有網域中行事曆服務被刪除 10 天以上的所有使用者和資源的行事曆︰
csclean clean "*"
cscomponents 公用程式可管理行事曆元件︰事件和工作 (待辦事項)。指令包括︰
delete,刪除行事曆中的事件和工作。
list,列出行事曆中的事件和工作。
version,顯示目前安裝之公用程式的版本編號。
您必須在安裝了 Calendar Server 的機器上本機執行此公用程式。
Calendar Server 可以處於執行中或停止狀態。
您必須以執行 Calendar Server 的使用者或群組 (在安裝期間指定,例如 icsuser 和 icsgroup) 的身份或以 root 身份登入。
cscomponents [-v|-q] [-e endtime] [-s starttime] [-t event|task] delete|list calid |
下表說明 cscomponents 公用程式可用的指令。
表 D–9 cscomponents 公用程式指令
指令 |
說明 |
---|---|
delete calid |
刪除包含指定行事曆 ID 的行事曆中的事件和工作。 |
list calid |
列出包含指定行事曆 ID 的行事曆中的事件和工作。 |
version |
將公用程式的版本顯示在螢幕上。 |
下表說明 cscomponents 公用程式指令選項。
表 D–10 cscomponents 公用程式指令選項
刪除行事曆 ID 為 tchang 的行事曆中的所有 2000 個事件︰
cscomponents -s 20000101T000000Z -e 20001231T000000Z delete tchang
列出行事曆 ID 為 tchang 的行事曆中的所有事件和工作的詳細資訊︰
cscomponents -v list tchang
csdb 公用程式可管理行事曆資料庫 (行事曆、階段作業和統計)。指令包括︰
create,建立新的資料庫。(如果伺服器啟動時資料庫不存在,Calendar Server 會自動建立一個。)
delete,刪除現有的行事曆資料庫。資料庫在開啟時 (Calendar Server 在執行時) 無法被刪除。
list,列出有關資料庫的資訊。
check,檢查行事曆資料庫以確定是否發生毀壞。
rebuild,重建已毀壞的行事曆資料庫。
recover,回復已損毀的行事曆資料庫。
version,顯示目前安裝之公用程式的版本編號。
您必須在安裝了 Calendar Server 的機器上本機執行此公用程式。
必須停止 Calendar Server,才能執行 create、delete 或 rebuild 指令。
您必須以執行 Calendar Server 的使用者或群組 (在安裝期間指定,例如 icsuser 和 icsgroup) 的身份或以 root 身份登入。
csdb [-q|-v] [-t caldb|sessdb|statdb] create|delete [dbdir] csdb [-q|-v] [-t caldb|sessdb|statdb] list [dbdir] csdb [-q|-v] [-f] [-t caldb|sessdb|statdb] recover [dbdir] csdb check [dbdir] csdb rebuild [-a, -V] [-g] [dbdir [dstdir]] |
下表說明 csdb 公用程式可用的指令。
表 D–11 csdb 公用程式指令
指令 |
說明 |
---|---|
create [dbdir] |
在指定的資料庫目錄中建立資料庫。如果未指定資料庫目錄,則使用目前目錄。如果伺服器啟動時資料庫不存在,Calendar Server 會自動建立一個。 |
delete [dbdir] |
刪除指定資料庫目錄中的資料庫。如果未指定資料庫目錄,則使用目前目錄。資料庫在開啟時 (Calendar Server 在執行時) 無法被刪除。 |
list [dbdir] |
列出有關指定資料庫目錄之資料庫的資訊。如果未指定資料庫目錄,則使用目前目錄。 |
recover [dbdir] |
嘗試回復指定資料庫目錄中損毀的行事曆資料庫。如果未指定資料庫目錄,則使用目前目錄。未實作階段作業或統計資料庫。 |
check [dbdir] |
掃描指定資料庫目錄中的行事曆資料庫,以確定是否發生損毀並在其輸出中報告結果。如果未指定資料庫目錄,則使用目前目錄。 |
rebuild [dbdir [dstdir]] |
掃描指定資料庫目錄中的所有行事曆資料庫,以確定是否發生損毀,並產生重建的行事曆資料庫 (.db 檔案)。如果未指定資料庫目錄,則使用目前目錄。重建資料庫後,會執行 db_verify。 dstdir 可指定可選擇的目標目錄。 |
version |
顯示公用程式的版本。 |
下表說明 csdb 公用程式指令選項。
表 D–12 csdb 公用程式指令選項
在目前目錄中建立新的、未移入的資料庫︰
csdb -t caldb create
刪除目前目錄中的資料庫:
csdb -t caldb delete
列出有關目前目錄中之行事曆資料庫的資訊:
csdb -v -t caldb list
嘗試回復目前目錄中所有損毀的資料庫︰
csdb recover
列出有關目前目錄中之階段作業資料庫的資訊:
csdb -t sessdb list
僅重建警示資料庫:
csdb -a -V rebuild
csdomain 公用程式可管理網域 LDAP 項目中的 Calendar Server 屬性。這些屬性是 icsCalendarDomain 物件類別的一部分。指令包括︰
create,在 LDAP 目錄中建立新的網域項目。
add,在網域項目中增加 Calendar Server 屬性及其相關值。
delete,在網域項目中刪除 Calendar Server 屬性,或刪除整個網域。
list,列出網域 LDAP 項目中的 Calendar Server 屬性。
若要執行 csdomain,必須在 ics.conf 檔案中設定下列參數:
必須將 service.virtualdomain.support 設定為 "yes"。
必須將 local.schemaversion 設定為 LDAP 模式的版本 ("1"、"1.5" 或 "2")。
如果 local.schemaversion = “1” 或 “1.5”,則必須將 service.dcroot 設定為 LDAP 目錄中 DC 樹狀結構的根尾碼。
如果 local.schemaversion = “2”,則必須將 service.schema2root 設定為其下包含所有網域的根尾碼。
在使用 csdomain 增加組織樹狀結構節點之前,您必須遵循第 10 章, 設定多重網域 Calendar Server 6.3 環境。
您必須在安裝了 Calendar Server 的機器上本機執行 csdomain。
Calendar Server 可以處於執行中或停止狀態。
您必須以執行 Calendar Server 的使用者或群組 (在安裝期間指定,例如 icsuser 和 icsgroup) 的身份或以 root 身份登入。
csdomain [-q | -v] -n node create domain csdomain [-q | -v] {-a attr[=value] | -f filename} add domain csdomain [-q | -v] [-a attr | -f filename] delete domain csdomain [-q | -v] list domain |
下表說明 csdomain 公用程式可用的指令。
表 D–13 csdomain 公用程式指令
指令 |
說明 |
---|---|
create |
在 LDAP 目錄中建立新的網域。 |
add |
在網域 LDAP 項目中增加 Calendar Server 屬性及其相關值。如果您使用 csdomain 增加或更新網域屬性,請重新啟動 Calendar Server 以使新值生效。 |
delete |
在 LDAP 目錄中為特定網域刪除某個 Calendar Server 屬性或刪除整個網域的所有 LDAP 項目。 |
list |
顯示 LDAP 目錄中特定網域的 Calendar Server 屬性。 |
version |
顯示公用程式的版本。 |
下表說明 csdomain 公用程式指令選項。
表 D–14 csdomain 公用程式指令選項
選項 |
說明 |
---|---|
-v |
在詳細模式下執行:顯示有關正在執行的指令之所有可用資訊。預設為關閉。 |
-q |
在無訊息模式下執行:
|
-a attr[=value] |
指定 LDAP 屬性的特性名稱及其選擇性值。 如需這些屬性和特性名稱的清單,請參閱D.9.3 LDAP 屬性和特性名稱。 |
-f filename |
指定包含 Calendar Server LDAP 目錄的特性名稱及其關聯值的文字檔案。 例如: createLowerCase="yes" filterPrivateEvents="no" fbIncludeDefCal="no" subIncludeDefCal="no" uiProxyUrl="https://proxyserver " |
-n node |
套用至 create 指令,如下所示︰
|
domain |
對於 add、delete 和 list 指令,指定 LDAP 目錄中的現有網域。 對於 create 指令,指定將要在 LDAP 目錄中建立之新網域的唯一名稱。 例如:west.sesta.com |
下表說明適用於 csdomain 公用程式的 LDAP 屬性和特性名稱。這些屬性是 icsCalendarDomain 物件類別的一部分。增加或刪除值時,您必須使用特性名稱,而不是屬性名稱。
如果您使用 csdomain 增加或更新網域 LDAP 屬性,請重新啟動 Calendar Server 以使新值生效。
D.9.3 LDAP 屬性和特性名稱說明可以使用 csdomain 公用程式設定的 icsAllowRights 屬性和特性。該屬性為 32 位元的數字字串,字串中的每個位元均對應於特定使用者權限。(在目前發行版本中,某些位元不使用,並依預設被設定為零。)如果已設定對應於某特定權限的位元 (值 = 1),則不允許該權限。如果未設定該位元 (值 = 0),則允許該權限。
icsAllowRights 屬性中的每個特性均具有對應的 ics.conf 參數。如果未設定特性 (值 = 0) 或特性不存在 (service.virtualdomain.support = "no"),則 Calendar Server 將使用對應的 ics.conf 參數做為預設值。
icsAllowRights 的值是數字字串,而不是整數。若要透過程式設計將 icsAllowRights 用於位元運算,您必須先將其字串值轉換為整數。
表 D–15 icsAllowRights LDAP 目錄屬性和特性
下表說明可以使用 csdomain 公用程式設定的 icsExtendedDomainPrefs 屬性和特性。每個特性均具有對應的 ics.conf 參數。如果未設定特性 (例如,值 = 0 或 service.virtualdomain.support="no") 或特性不存在,則 Calendar Server 將使用對應的 ics.conf 參數做為預設值。
表 D–16 icsExtendedDomainPrefs LDAP 目錄屬性
特性名稱 |
說明 |
---|---|
allowProxyLogin |
指定 "yes" 或 "no" 以表示是否允許代理登入。 對應的 ics.conf 參數為︰ service.http.allowadminproxy (預設值 = "yes") |
calmasterAccessOverride |
指定 "yes" 或 "no" 以表示 Calendar Server 管理員是否可以置換存取控制。 對應的 ics.conf 參數為︰ service.admin.calmaster.overrides.accesscontrol (預設值 = "no") |
calmasterCred |
指定一個 ASCII 字串,該字串是被指定為 Calendar Server 網域管理員之使用者 ID 的密碼。 對應的 ics.conf 參數為︰ service.siteadmin.cred (無預設值) |
calmasterUid |
指定一個 ASCII 字串,該字串是被指定為 Calendar Server 網域管理員的使用者 ID。 對應的 ics.conf 參數為︰ service.siteadmin.userid (無預設值) |
createLowercase |
指定 "yes" 或 "no" 以表示在建立新行事曆或搜尋行事曆時,Calendar Server 是否應將行事曆 ID (calid) 轉換為小寫。 對應的 ics.conf 參數為︰ calstore.calendar.create.lowercase (預設值 = "no") |
domainAccess |
指定網域的存取控制清單 (ACL)。如需有關 ACL 的資訊,請參閱1.8.3 Calendar Server 版本 6.3 中的存取控制清單 (ACL)。 此 ACL 用於跨網域搜尋。如需更多資訊,請參閱11.2 Calendar Server 6.3 系統中的交叉網域搜尋。 注意 – 只允許 domainAccess 的單一實例。不過,系統不會警告您是否出現重複。每當您變更值時,您必須確定只有一個。 |
fbIncludeDefCal |
指定 "yes" 或 "no" 以表示使用者的預設行事曆是否包含在使用者的空閒/忙碌行事曆清單中。 對應的 ics.conf 參數為︰ calstore.freebusy.include.defaultcalendar (預設值 = "yes") |
filterPrivateEvents |
指定 "yes" 或 "no" 以表示 Calendar Server 是否篩選 (識別) 私人和只有時間與日期 (機密) 的事件和工作。如果為 "no",則 Calendar Server 將它們視為公開事件和工作。 對應的 ics.conf 參數為︰ calstore.filterprivateevents (預設值 = "yes") |
groupMaxSize |
指定將為邀請展開的 LDAP 群組的大小上限。 對應的 ics.conf 參數為: calstore.group.attendee.maxsize (預設為 "0" – 展開群組而無大小限制) |
language |
指定網域的語言。 對應的 ics.conf 參數為︰ local.domain.language |
resourceDefaultAcl |
指定一個存取控制清單 (ACL),該清單為建立資源行事曆時所使用的預設存取控制權限。 對應的 ics.conf 參數為︰ resource.default.acl (預設為 "@@o^a^r^g;@@o^c^wdeic^g; @^a^rsf^g") |
setPublicRead |
指定使用者預設行事曆最初被設定為公開讀取/私人寫入 ("yes"),還是私人讀取/私人寫入 ("no")。 對應的 ics.conf 參數為︰ service.wcap.login.calendar.publicread (預設值 = "no") |
searchFilter |
指定搜尋篩選器以尋找使用者。 對應的 ics.conf 參數為︰ local.userSearchFilter |
ssoCookieDomain |
指定瀏覽器應將 cookie 僅傳送至指定網域中的伺服器。值必須以小數點號 (.) 開頭,例如:".sesta.com" 對應的 ics.conf 參數為︰ sso.cookiedomain (預設為目前網域) |
ssoUserDomain |
指定用做使用者 SSO 認證一部分的網域。 對應的 ics.conf 參數為︰ sso.userdomain (無預設值) |
subIncludeDefCal |
指定 "yes" 或 "no" 以表示使用者的預設行事曆是否包含在使用者的已訂閱行事曆清單中。 對應的 ics.conf 參數為︰ calstore.subscribed.include.defaultcalendar (預設值 = "yes") |
uiAllowAnyone |
指定 "yes" 或 "no" 以表示使用者介面是否應顯示並使用「所有使用者」存取控制清單 (ACL)。 對應的 ics.conf 參數為︰ ui.allow.anyone (預設值 = "yes") |
uiAllowDomain |
指定 "yes" 或 "no" 以表示使用者介面是否應顯示並使用此網域的存取控制清單 (ACL)。 對應的 ics.conf 參數為︰ ui.allow.domain (預設值 = "no") |
uiBaseUrl |
指定基底伺服器位址的 URL。例如:"https://proxyserver" 。 對應的 ics.conf 參數為︰ ui.base.url (無預設值) |
uiConfigFile |
指定基於 xml 的選擇性配置檔案,該檔案可由 Calendar Server 在啟動時讀取,並允許使用者介面的某些部分被隱藏。 對應的 ics.conf 參數為︰ ui.config.file (無預設值) |
uiProxyURL |
指定要在 HTML UI JavaScript 檔案中前置的代理伺服器位址的 URL。例如:"https://web_portal.sesta.com/" 對應的 ics.conf 參數為︰ ui.proxyaddress.url (無預設值) |
下表說明可使用 csdomain 公用程式設定的其他 LDAP 屬性和特性。
表 D–17 csdomain 公用程式可設定的其他 LDAP 目錄屬性
使用 LDAP Schema 1 建立名為 west.sesta.com 的新網域:
csdomain -v -n o=nodewest,o=sesta create west.sesta.com
使用 LDAP Schema 2 建立名為 east.sesta.com 的新網域:
csdomain -v -n nodeeast create east.sesta.com
顯示 west.sesta.com 網域的 Calendar Server LDAP 屬性清單︰
csdomain -v list west.sesta.com
將 west.sesta.com 網域的時區設定為 America/New_York︰
csdomain -v -a timezone=America/New_York add west.sesta.com
csexport 公用程式可將行事曆匯出至 iCalendar (.ics) 或 XML (.xml) 格式的檔案。指令包括︰
calendar,匯出指定的行事曆。
version,顯示目前安裝之公用程式的版本編號。
您必須在安裝了 Calendar Server 的機器上本機執行此公用程式。
Calendar Server 可以處於執行中或停止狀態。
您必須以執行 Calendar Server 的使用者或群組 (在安裝期間指定,例如 icsuser 和 icsgroup ) 的身份或以 root 身份登入。
csexport [-v|-q] -c calid calendar outputfile |
下表說明 csexport 公用程式可用的指令。
表 D–18 csexport 公用程式指令
指令 |
說明 |
---|---|
calendar outputfile |
將行事曆匯出至指定的輸出檔案。檔案的資料格式由指定的檔案副檔名決定︰
|
version |
顯示公用程式的版本。 |
下表說明 csexport 公用程式指令選項。
表 D–19 csexport 公用程式指令選項
選項 |
說明 |
---|---|
-v |
在詳細模式下執行:顯示有關正在執行的指令之所有可用資訊。預設為關閉。 |
-q |
在無訊息模式下執行:
|
-c calid |
要匯出的行事曆之行事曆 ID。此選項需要與 calendar 指令一起使用。無預設值。 |
將行事曆 ID 為 tchang 的行事曆以 iCalendar (text/calendar) 格式匯出至名為 tchang.ics 的檔案:
csexport -c tchang calendar tchang.ics
將行事曆 ID 為 tchang 的行事曆以 XML (text/calendar) 格式匯出至名為 tchang.xml 的檔案:
csexport -c tchang calendar tchang.xml
csimport 公用程式可從使用 csexport 公用程式儲存的 iCalendar (ics) 或 XML 格式的檔案匯入行事曆。指令包括︰
calendar – 匯入指定的行事曆。
version – 顯示目前安裝之公用程式的版本編號。
匯入行事曆元件的日期計算會使用與該元件關聯的 X-NSCP-DTSTART-TZID 中指定的時區。如果沒有指定的時區,則使用 ics.conf 中的伺服器時區。
您必須在安裝了 Calendar Server 的機器上本機執行此公用程式。
Calendar Server 可以處於執行中或停止狀態。
您必須以執行 Calendar Server 的使用者或群組 (在安裝期間指定,例如 icsuser 和 icsgroup) 的身份或以 root 身份登入。
csimport [-v|-q] -c calid calendar inputfile |
下表說明 csimport 公用程式可用的指令。
表 D–20 csimport 公用程式指令
指令 |
說明 |
---|---|
calendar inputfile |
從指定的輸入檔案匯入行事曆。檔案的資料格式由檔案副檔名決定︰
|
version |
顯示公用程式的版本。 |
下表說明 csimport 公用程式指令選項。
表 D–21 csimport 公用程式指令選項
選項 |
說明 |
---|---|
-v |
在詳細模式下執行:顯示有關正在執行的指令之所有可用資訊。預設為關閉。 |
-q |
在無訊息模式下執行:
|
-c calid |
要匯入的行事曆之行事曆 ID。此選項需要與 calendar 指令一起使用。 如果指定的行事曆 ID 已經存在,則匯入的資料將併入目前行事曆。無預設值。 如需更多資訊,請參閱15.2 建立行事曆唯一識別碼 (calid)。 |
從檔案 tchang.ics 匯入行事曆 ID 為 tchang 的行事曆,並使用 iCalendar (text/calendar 檔案) 格式︰
csimport -c tchang calendar tchang.ics
從檔案 tchang.xml 匯入行事曆 ID 為 tchang 的行事曆,並使用 (text/xml 檔案) 格式︰
csimport -c tchang calendar tchang.xml
csplugin 可管理為 Calendar Server 安裝所配置的 CSAPI 外掛程式。指令包括︰
activate,載入和啟動指定的外掛程式。
deactivate,關閉和停用指定的外掛程式類型和外掛程式名稱。(如需所支援外掛程式類型的說明,請參閱表 D–23 中的 -t 選項。)
list,顯示所有支援的外掛程式。
version,顯示目前安裝之公用程式的版本編號。
必須在安裝了 Calendar Server 的本地機器上執行。
Calendar Server 可以處於執行中或停止狀態。
您必須以執行 Calendar Server 的使用者或群組 (在安裝期間指定,例如 icsuser 和 icsgroup) 的身份或以 root 身份登入。
csplugin [-q|-v] [-r] -t ac|attr|auth|locate|lookup|xlate activate|deactivate plugin csplugin [-q|-v] list |
下表說明 csplugin 公用程式可用的指令。
表 D–22 csplugin 公用程式指令
指令 |
說明 |
---|---|
activate -t type name |
載入和啟用指定的外掛程式類型和外掛程式名稱。(如需所支援外掛程式類型的說明,請參閱表 D–23 中的 -t 選項。) |
deactivate -t type name |
關閉和停用指定的外掛程式類型和外掛程式名稱。(如需所支援外掛程式類型的說明,請參閱表 D–23 中的 -t 選項。) |
list |
列出所有支援的外掛程式類型、名稱和啟動狀態。(如需所支援外掛程式類型的說明,請參閱表 D–23 中的 -t 選項。) |
version |
顯示公用程式的版本。 |
下表說明 csplugin 公用程式指令選項。
表 D–23 csplugin 公用程式指令選項
列出有關所有支援的外掛程式之詳細資訊,包括配置為與該伺服器實例配合使用的每個外掛程式的類型、名稱和啟動狀態︰
csplugin -v list
載入並啟用 mylookup 檔案的 lookup 類型外掛程式︰
csplugin activate -t lookup mylookup
停用 mylookup 檔案的 lookup 類型外掛程式,然後將其從 plugin 目錄刪除:
csplugin deactivate -t lookup mylookup -r
cspurge 公用程式允許手動清除刪除記錄資料庫 (ics50deletelog.db) 中的項目。
您必須在安裝了 Calendar Server 的機器上本機執行此公用程式。
Calendar Server 可以處於執行中或停止狀態。
您必須以執行 Calendar Server 的使用者或群組 (在安裝期間指定,例如 icsuser 和 icsgroup) 的身份或以 root 身份登入。
cspurge [-q|-v] -e endtime -s starttime |
下表說明 cspurge 公用程式指令選項。
表 D–24 cspurge 公用程式指令選項
清除刪除記錄中的所有項目︰
cspurge -v - e 0 -s 0
清除 2003 年 7 月 1 日至 2003 年 7 月 31 日之間的所有項目︰
cspurge -v - e 20030731T235959Z -s 20030701T120000Z
清除 2003 年 9 月 30 日之前的所有項目︰
cspurge -v - e 20031030T235959Z -s 0
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
csresource 公用程式可建立並管理 LDAP 項目和資源 (如會議室或設備) 的行事曆。(csresource 公用程式僅可用於與資源關聯的行事曆;如果針對使用者的行事曆發出此公用程式,則會傳回錯誤。)指令包括︰
create,為指定的行事曆 ID (calid) 增加新資源
delete,移除一個資源或所有資源
disable,停用一個資源或所有資源
enable,啟用一個資源或所有資源
list,顯示單一資源或所有資源清單
您必須在安裝了 Calendar Server 的機器上本機執行此公用程式。
Calendar Server 可以處於執行中或停止狀態。
您必須以執行 Calendar Server 的使用者或群組 (在安裝期間指定,例如 icsuser 和 icsgroup) 的身份或以 root 身份登入。
csresource [-q|-v] [-a aces] [-b basedn] [-d domain] [-t description] [-k yes|no] [-o owner] [-y otherowners] -m email -c calid create common_name csresource [-q|-v] [-b basedn] [-d domain] delete|disable|enable [common_name] csresource [-q|-v] [-b basedn] [-d domain] [-h host] list [common_name] |
下表說明 csresource 公用程式可用的指令。
表 D–26 csresource 公用程式指令
指令 |
說明 |
---|---|
create common_name |
為指定的行事曆 ID 建立新資源。 |
delete [common_name] |
刪除一個資源,或在未指定資源 common_name 時刪除所有資源。 |
enable [common_name] |
啟用一個資源,或在未指定資源 common_name 時啟用所有資源。 |
disable [common_name] |
停用一個資源,或在未指定資源 common_name 時停用所有資源。 |
list [common_name] |
顯示單一資源行事曆,或在未指定資源 name 時顯示所有資源行事曆。 如果包含 -h host 選項,則顯示該後端伺服器上指定名稱 (或所有資源行事曆) 的行事曆屬性。 |
如果上述任一指令的 name 中包含空格,則必須將其置於引號 (" ") 中。
下表說明 csresource 公用程式指令選項。
表 D–27 csresource 公用程式指令選項
選項 |
說明 |
---|---|
-v |
在詳細模式下執行:顯示有關正在執行的指令之所有可用資訊。預設為關閉。 |
-q |
在無訊息模式下執行:
|
-a [aces] |
指定行事曆的存取控制項目 (ACE)。ACE 決定可以存取群組排程行事曆的人員,以及他們擁有的權限類型,例如建立、刪除、讀取和寫入權限。ACE 字串或存取控制清單 (ACL) 必須置於引號 ("") 中。 預設為 ics.conf 檔案中的 resource.default.acl 參數。 如需有關 ACE 格式的資訊,請參閱15.4 Calendar 存取控制。 |
-b [basedn] |
要用於指定之資源的 LDAP 基底 DN (distinguished name,辨別名稱)。預設使用 ics.conf 檔案中 local.ugldapbasedn 參數的值。 |
-c calid |
icsCalendar 屬性。此選項需要與 create 指令一起使用。如需更多資訊,請參閱15.2 建立行事曆唯一識別碼 (calid)。 |
-d domain | |
-t [description] |
指定有關行事曆目的的可檢視註釋。預設為無說明。 |
-h host |
指定資源行事曆所在之後端伺服器的名稱。此選項僅適用於 list 指令。 |
-k yes|no |
指定是否允許與資源 (如會議室) 關聯的行事曆的雙預定。例如,yes 表示資源行事曆可以為同一時段排程一個以上的事件。 如果 -k 選項被忽略,則預設使用 ics.conf 檔案中 resource.allow.doublebook 參數的值。但是,僅在建立行事曆時,才使用 resource.allow.doublebook 參數。 建立行事曆後,Calendar Server 將檢查行事曆特性資料庫 (ics50calprops.db),以確定是否允許雙預定。如果您需要變更行事曆的行事曆特性以允許或不允許雙預定,請重新發出帶有 -k 選項的 csresource。 |
-m email |
指定資源的 LDAP mail 屬性 (主要電子郵件位址)。 |
-o owner |
主要所有者。 預設使用 ics.conf 檔案中 service.siteadmin.userid 的值。 |
-y otherowners |
其他所有者。必須將多位所有者置於引號 (" ") 中,並以空格分隔。預設為無其他所有者。 |
version |
顯示公用程式的版本。 |
顯示所有資源行事曆及其 LDAP 屬性的清單︰
csresource -v list
建立行事曆 ID (calid) 為 room100 且可檢視名稱 (LDAP cn 屬性) 為 MeetingRoom100 的資源行事曆:
csresource -m room100@sesta.com - c room100 create MeetingRoom100
顯示可檢視名稱為 MeetingRoom100 之資源行事曆的 LDAP 屬性:
csresource -v list MeetingRoom100
停用可檢視名稱為 MeetingRoom100 的資源行事曆:
csresource disable MeetingRoom100
啟用可檢視名稱為 MeetingRoom100 的資源行事曆,並允許雙預定:
csresource -k yes enable MeetingRoom100
刪除可檢視名稱為 MeetingRoom100 的資源行事曆:
csresource delete MeetingRoom100
顯示後端伺服器 sesta 上可檢視名稱為 MeetingRoom100 之資源行事曆的 LDAP 屬性:
csresource -v -h sesta list MeetingRoom100
csrestore 公用程式可復原使用 csbackup 或 csexport 儲存的行事曆資料庫、指定的行事曆或使用者的預設行事曆。指令包括︰
database,復原行事曆資料庫。
calendar,復原指定的行事曆。
defcal,復原使用者的預設行事曆。
version,顯示目前安裝之公用程式的版本編號。
位於指定備份目錄中的 caldb.conf 版本檔案會顯示已備份資料庫的版本編號。
Calendar Server 版本 6.3 的 csrestore 公用程式與 Calendar Server 版本 2 的 csrestore 公用程式不相容。請勿嘗試復原使用版本 2 csrestore 備份的資料,因為這可能會導致資料遺失。
您必須在安裝了 Calendar Server 的機器上本機執行此公用程式。
如果您要復原行事曆資料庫,則必須停止 Calendar Server。
您必須以執行 Calendar Server 的使用者或群組 (在安裝期間指定,例如 icsuser 和 icsgroup) 的身份或以 root 身份登入。
csrestore 不在乎使用者 LDAP 項目是訂閱或本身的行事曆。您需要手動執行使用者 LDAP 項目,以在多值屬性 icsSubscribed 中取回個人行事曆。
csrestore [-v|-q] [-f] database inputdir csrestore [-v|-q] -c calid calendar inputfile csrestore [-v|-q] -a userid [-b basedn] defcal inputfile |
下表說明 csrestore 公用程式可用的指令。
表 D–28 csrestore 公用程式指令
下表說明 csrestore 公用程式指令選項。
表 D–29 csrestore 公用程式指令選項
選項 |
說明 |
---|---|
-v |
在詳細模式下執行:顯示有關正在執行的指令之所有可用資訊。預設為關閉。 |
-q |
在無訊息模式下執行:
|
-a userid |
要復原的使用者 ID。此選項需要預設選項。無預設值。 |
-b basedn |
要用於指定的使用者 ID 的 LDAP 基底 DN (辨別名稱)。預設使用 ics.conf 檔案中所定義之設定 local.ugldapbasedn 的值。 |
-f |
強制所有要刪除的現有資料庫檔案。 |
-c calid |
要復原的行事曆 ID。此選項需要與 calendar 指令配合使用。無預設值。 如需更多資訊,請參閱15.2 建立行事曆唯一識別碼 (calid)。 |
復原目錄 backupdir 中之前使用 csbackup 儲存的行事曆資料庫︰
csrestore database backupdir
從目錄 backupdir 中之前使用 csbackup 或 csexport 以 iCalendar (text/calendar 檔案) 格式儲存的 tchang.ics 檔案復原行事曆 ID 為 tchang 的行事曆︰
csrestore -c tchang calendar backupdir/tchang.ics
從 backupdir 中之前使用 csbackup 儲存的行事曆資料庫復原 tchang:
csrestore -c tchang calendar backupdir
從目錄 backupdir 中之前使用 csbackup 或 csexport 以 iCalendar (text/calendar 檔案) 格式儲存的 tchang.ics 檔案復原 tchang 擁有的預設行事曆︰
csrestore -a tchang defcal backupdir/tchang.ics
csschedule 公用程式可管理儲存於群組排程引擎 (Group Scheduling Engine, GSE) 佇列中的排程項目。指令包括︰
list,顯示指定行事曆 ID 請求的 GSE 佇列中的項目。
delete,從指定行事曆 ID 請求的 GSE 佇列中移除項目。
version,顯示目前安裝之公用程式的版本編號。
您必須在安裝了 Calendar Server 的機器上本機執行此公用程式。
必須停止 Calendar Server。
您必須以執行 Calendar Server 的使用者或群組 (在安裝期間指定,例如 icsuser 和 icsgroup) 的身份或以 root 身份登入。
csschedule [-q|-v] [-c count] [-e endtime] [-s starttime] [-t scheduletime -o offset] [-u uid] list [calid] csschedule [-q|-v] [-t scheduletime -o offset -u uid -n sequencenumber -r rid] list [calid] csschedule [-q|-v] [-t scheduletime -o offset -u uid -n sequencenumber -r rid] delete [calid] csschedule [-q|-v] [-s starttime] [-e endtime] delete [calid] |
下表說明 csschedule 公用程式可用的指令。
表 D–30 csschedule 公用程式指令
指令 |
說明 |
---|---|
list |
顯示指定行事曆 ID 請求的 GSE 佇列中儲存的項目。 |
delete |
從指定行事曆 ID 請求的 GSE 佇列中移除項目。 |
version |
顯示公用程式的版本。 |
下表說明 csschedule 公用程式指令選項。
表 D–31 csschedule 公用程式指令選項
列出 GSE 佇列中儲存的所有項目的詳細資訊︰
csschedule -v list
列出 GSE 佇列中儲存的前十個項目︰
csschedule -c 10 list
列出 GSE 佇列中在 2000 年 12 月 31 日 10:30:45 至 11:30:45 之間排程的項目:
csschedule -s 20001231T103045Z - e 20001231T113045Z list
列出 GSE 佇列中在 10:30:45 排程的行事曆 tchang 的項目,該項目在 2000 年 12 月 31 日 10:30:45 的偏移量為 2,唯一識別碼為 1111,週期性 ID 為 0,並且序列號碼為 0︰
csschedule -v -t 20001231T103045Z - o 2 -u 1111 -r 0 -n 0 list tchang
刪除 GSE 佇列中 10:30:45 的行事曆 tchang 的項目,該項目的第一個偏移在 2000 年 12 月 31 日 10:30:45,唯一識別碼為 1111,週期性 ID 為 0,並且序列號碼為 0︰
csschedule - v -t 20001231T103045Z -o 1 -u 1111 - r 0 -n 0 delete tchang
刪除 GSE 中在 2000 年 12 月 31 日 10:30:45 至 16:30:45 之間排程的項目:
csschedule -v - s 20001231T103045Z -e 20001231T163045Z delete
刪除 GSE 佇列中的所有項目︰
csschedule - v delete
csstats 公用程式可顯示 Calendar Server 統計。指令包括︰
list,列出指定的 Calendar Server 子系統的有關計數器統計。
version,顯示目前安裝之公用程式的版本編號。
如需有關計數器的更多資訊,請參閱E.3 計數器配置 (counter.conf) 檔案。
您必須在安裝了 Calendar Server 的機器上本機執行此公用程式。
Calendar Server 可以處於執行中或停止狀態。
您必須以執行 Calendar Server 的使用者或群組 (在安裝期間指定,例如 icsuser 和 icsgroup) 的身份或以 root 身份登入。
csstats [-q|v] [-r registry] [-i iterations] [-s delay] list [subsystem] |
下表說明 csstats 公用程式可用的指令。
表 D–32 csstats 公用程式指令
下表說明 csstats 公用程式指令選項。
表 D–33 csstats 公用程式指令選項
顯示有關計數器和可用類型的基本資訊︰
csstats list
列出有關 HTTP 服務子系統 (hpptstat) 的計數器統計:
csstats list http
列出有關 WCAP 子系統 (wcapstat ) 的計數器統計,每 10 秒一次,共持續一小時 (3600 秒):
csstats -i 3600 - s 10 list wcap
csuser 公用程式僅適用於 Schema 1 模式。它會管理行事曆使用者的 LDAP 項目及使用者的預設行事曆。指令包括︰
check,檢查是否允許使用者使用行事曆功能。
create,允許使用者使用行事曆功能。
此公用程式無法讓使用者獲得 Communications Express 要求的通訊錄。要使用通訊錄,須藉由 ldapmodify 手動完成。
delete,刪除使用者和使用者的預設行事曆。
若使用者具有其他行事曆,則不會刪除它們。可使用 cscal 移除已刪除之使用者的其他行事曆。
disable,防止使用者登入 Calendar Server。
enable,允許使用者登入 Calendar Server。
list,列出使用者的行事曆屬性。
reset,從 LDAP 項目移除所有行事曆屬性,包括 icsCalendarUser (物件類別)、icsSubscribed、icsCalendarOwned、icsCalendar 和 icsDWPHost (如果使用者在 LDAP CLD 設定中)。
發出此指令後,將無法再啟用使用者的行事曆服務。若要復原使用者的行事曆服務,請發出 csuser enable 指令。
如果您使用的是 Directory Server,則還可以使用 ldapsearch 和 ldapmodify 公用程式。如需有關這些公用程式的資訊,請參閱以下網站上的 Directory Server 文件:
http://docs.sun.com/coll/1316.2
您必須使用 Schema 1。
Calendar Server 可以處於執行中或停止狀態。
您必須在安裝了 Calendar Server 的機器上本機執行此公用程式。
儲存行事曆使用者資訊的 LDAP 伺服器必須處於執行中狀態。
您必須以執行 Calendar Server 的使用者或群組 (在安裝期間指定,例如 icsuser 和 icsgroup) 的身份或以 root 身份登入。
csuser [-q|-v] [-a aces] [-b basedn] -m email address [-d domain] -f filename -g givenname [-k yes|no] [-l langcode] -s surname -y userpassword create userid csuser [-q|-v] [-b basedn] [-d domain] [-h host] list [userid] csuser [-q|-v] [-b basedn] [-d domain] [check|delete|disable|enable|reset] userid |
下表說明 csuser 公用程式可用的指令。
表 D–34 csuser 公用程式指令
指令 |
說明 |
---|---|
check userid |
檢查是否允許指定的使用者 ID 使用行事曆功能。 |
create userid |
建立指定的使用者 ID 並使該使用者登入 Calendar Server。 |
delete userid |
刪除指定的使用者 ID。 |
disable userid |
籍由在使用者的 LDAP 的項目中增加 icsAllowedServiceAcess="http" 來防止指定使用者 ID 使用行事曆功能。 |
enable userid |
籍由移除使用者 LDAP 中的 icsAllowedServiceAcess="http" 來允許指定使用者 ID 使用行事曆功能。 |
list [userid] |
列出指定使用者 ID 的行事曆屬性。如果未指定使用者 ID,則列出所有已啟用使用者的屬性。 如果包含 -h server-name 選項,則列出該後端伺服器上指定使用者 ID (或所有已啟用使用者) 的行事曆屬性。 |
reset userid |
將使用者 ID 的所有行事曆屬性重設為它們的預設設定。 注意:重設使用者 ID 的行事曆屬性之後,所有行事曆屬性都將從使用者的 LDAP 項目 (包括 icsCalendarUser (物件類別)、icsSubscribed、icsCalendarOwned、icsCalendar 和 icsDWPHost) 中移除 (如果使用者在 LDAP CLD 設定中)。然後,Calendar Server 管理員便無法代表使用者建立行事曆。 Calendar Server 管理員針對使用者發出 csuser 啟用指令時,這些屬性會復原至使用者的 LDAP 項目中。 |
version |
顯示公用程式的版本。 |
下表說明 csuser 公用程式指令選項。
表 D–35 csuser 公用程式指令選項
選項 |
說明 |
---|---|
-v |
在詳細模式下執行:顯示有關正在執行的指令之所有可用資訊。預設為關閉。 |
-q |
在無訊息模式下執行:
|
-b basedn |
要用於所有 LDAP 使用者的基底 DN。預設使用 ics.conf 檔案中所定義之設定 local.ugldapbasedn 的值。 |
-d domain | |
-a [aces] |
指定行事曆的存取控制項目 (ACE)。ACE 決定可以存取群組排程行事曆的人員,以及他們擁有的權限類型,例如建立、刪除、讀取和寫入權限。ACE 字串或存取控制清單 (ACL) 必須置於引號 ("") 中。 預設為: "@@o^a^r^g;@@o^c^wdeic^g; @^a^sf^g;@^c^^g;@^p^r^g" 如需有關 ACE 格式的詳細資訊,請參閱E.2.9 Calendar Server 服務配置。 |
-f filename |
檔案名稱,用於為需要密碼 (-y 參數) 的選項指定密碼。如果您要從程序檔執行 csuser,以使用附加的安全性,請在檔案名稱中指定密碼。 |
-g givenname |
使用者的 LDAP 給定名稱 (名字)。此選項是必需的。無預設值。 |
-h host |
指定使用者行事曆所在的後端伺服器的名稱。此選項僅適用於 list 指令。 |
-p port |
LDAP 伺服器偵聽的連接埠號。預設使用 ics.conf 檔案中所定義之設定 local.ugldapport 的值。 |
-k yes|no | |
-l [langcode] |
語言代碼。預設為 ics.conf 中 local.sitelanguage 的值。 |
-m email address |
指定使用者的 LDAP mail 屬性 (主要電子郵件位址)。 |
-s surname |
使用者的 LDAP 姓氏 (姓)。此選項是必需的。無預設值。 |
檢查是否允許行事曆使用者 jsmith@sesta.com 使用行事曆功能 (現有行事曆使用者是否可以存取此 Calendar Server 的行事曆資料)︰
csuser check jsmith@sesta.com
建立一位 LDAP 使用者,其使用者 ID 為 jsmith@sesta.com,名字為 John,姓氏為 Smith,電子郵件位址為 jsmith@sesta.com,網域為 sesta.com:
csuser -g John -s Smith -y password -m jsmith@sesta.com create jsmith@sesta.com -d sesta.com
刪除行事曆使用者 jsmith@sesta.com:
csuser delete jsmith@sesta.com
禁止行事曆使用者 jsmith@sesta.com 登入 Calendar Server:
csuser disable jsmith@sesta.com
此指令可防止 jsmith@sesta.com 登入 Calendar Server 以存取行事曆資料,但不會從行事曆資料庫中刪除 jsmith 的資料。如果 jsmith 目前已登入 Calendar Server,則他仍可存取行事曆資料,直至其登出。
允許 jsmith@sesta.com 使用行事曆功能 (讓現有行事曆使用者登入 Calendar Server):
csuser enable jsmith@sesta.com
列出 jsmith@sesta.com 的所有行事曆屬性:
csuser -v list jsmith@sesta.com
列出前綴為字串 user 的所有行事曆使用者 ID:
csuser -v list "user*"
將 jsmith@sesta.com 的所有行事曆屬性重設為預設配置設定:
csuser reset jsmith@sesta.com
列出後端伺服器 sesta 上 tchang 的所有行事曆屬性︰
csuser - v -h sesta list tchang
start-cal 公用程式按照以下順序啟動 Calendar Server 服務:
watcher — 監視 Calendar Server 常駐程式
enpd — 事件通知服務 (Event Notification Service, ENS)
csstored — 對資料庫執行維護和備份作業
csnotifyd — 通知服務
csadmind — 管理服務
csdwpd — 資料庫連線協定 (Database Wire Protocol, DWP) 服務,此分散式資料庫服務僅透過遠端 Calendar Server 資料庫配置才能啟動
cshttpd — HTTP 服務
您必須在安裝了 Calendar Server 的機器上本機執行 start-cal。
您必須以 root 身份登入。
start-cal
cal-svr-base/SUNWics5/cal/sbin/start-cal
如需更多資訊,請參閱12.1 啟動與停止 Calendar Server 6.3 程序。
stop-cal 公用程式可停止所有 Calendar Server 服務。
您必須在安裝了 Calendar Server 的機器上本機執行 stop-cal。
您必須以 root 身份登入。
stop-cal
cal-svr-base/SUNWics5/cal/sbin/stop-cal
如需更多資訊,請參閱12.1 啟動與停止 Calendar Server 6.3 程序。