| Sun ONE Calendar Server 6.0 管理員指南 |
第 11 章
Calendar Server 指令行公用程式Sun ONE Calendar Server 提供一組可從 batch、shell 和程序檔程式 (如 Perl) 啟動的指令行管理公用程式。如果需要，這些公用程式可使用 ics.conf 配置檔案的預設值。這些指令行公用程式位於以下目錄中︰
cal_svr_base/opt/SUNWics5/cal/sbin
本章提供以下資訊︰
csattribute | csbackup | cscal | csclean | cscomponents | csdb
csdomain | csexport | csimport | csmonitor | csplugin | cspurge
csresource | csrestore | csschedule | csstart | csstats | csstop
csstored.pl | cstool | csuser | start-cal | stop-cal
執行指令行公用程式在 Solaris 系統上，以執行 Calendar Server 的使用者和群組身份 (在安裝期間指定，預設為 icsuser 和 icsgroup)，或者以 root 身份登入時，均可執行指令行公用程式。在大多數情況下，您必須移至公用程式所在的目錄。例如，在 Solaris 系統上為︰cal_svr_base/opt/SUNWics5/cal/sbin。
指令行公用程式的語法
Calendar Server 指令行公用程式使用以下語法︰
其中：
utility 為公用程式的可執行名稱，如 cscal 或 csuser。
option 決定指令所執行的動作。選項為小寫且前面帶有連字符號 (-)，如 -d。括號 ([]) 中的選項為選擇性的。如果指明，則可同時使用兩個或多個選項。
value 進一步限定 option 所指定的動作，如與 -d 選項一起使用的說明。括號 ([]) 中的值為選擇性的。包含空格的值必須置於引號 (" ") 中。多個值必須置於引號 ("") 中，且每個值必須以空格分隔，除非另有指示，如使用以分號分隔的清單。
command 為公用程式執行的動作，如 list 或 create。以垂直條 (|) 分隔的指令表示可同時使用任一指令 (而不是同時使用這兩個指令)。
target 為指令在其上生效的物件，如行事曆 ID 或使用者 ID。
指令行公用程式的使用規則
以下規則為指令行公用程式的一般使用指南︰
程序檔中的回覆碼
如果您從程序檔執行指令行公用程式，則在公用程式成功執行時，回覆碼為「0」；失敗時為「-1」。
指令行公用程式表格表格 11-1 說明 Calendar Server 指令行公用程式。
csattributecsattribute 公用程式管理 LDAP 伺服器中的 Calendar Server 性質。指令包括︰
- add，將 LDAP 性質和值新增至指定目標 (使用者或資源物件)。
- list，列出目標物件的性質。
- delete，從目標中刪除性質。
註
如果您的站台使用 LDAP CLD 外掛程式，請勿使用 csattribute 來變更 icsDWPHost 性質，以指定新的後端主機伺服器。修改 icsDWPHost 不會導致在新的後端主機上建立新行事曆。如需更多資訊，請參閱配置 LDAP 行事曆查找資料庫 (CLD) 外掛程式。
需求
語法
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
表格 11-2 說明 csattribute 可以使用的指令。
表格 11-2 csattribute 公用程式指令
指令
說明
add target
將 LDAP 性質和值新增至指定目標 (使用者或資源物件)。
list target
列出目標物件的性質。
delete target
從目標中刪除性質。
version
顯示公用程式的版本。
表格 11-3 說明 csattribute 公用程式指令選項。
表格 11-3 csattribute 公用程式指令選項
選項
說明
-v
在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q
在無訊息模式下執行：
預設為關閉。
-a attribute =value
或
-a attribute [=value ]
LDAP 性質和值︰
-t user | resource
目標類型 (使用者或資源物件)。預設為使用者。
[-d domain]
指定託管 (虛擬) 網域的名稱。預設使用 ics.conf 檔案中 service.defaultdomain 參數的值。
範例
csbackupcsbackup 公用程式可備份行事曆資料庫、指定的行事曆或使用者的預設行事曆。指令包括︰
位於指定備份目錄中的 caldb.conf 版本檔案顯示已備份資料庫的版本號碼。
如需有關 csrestore 的資訊，請參閱 csrestore。
需求
語法
csbackup [-q|-v] -f database target
csbackup [-q|-v] -c calid calendar target
csbackup [-q|-v] -a userid [-b basedn] defcal target
表格 11-4 說明 csbackup 可以使用的指令。
表格 11-4 csbackup 公用程式指令
指令
說明
database target
將行事曆資料庫備份至指定的目標資料庫目錄。依預設，目標資料庫目錄為︰
cal_svr_base/opt/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
顯示公用程式的版本。
表格 11-5 說明 csbackup 公用程式指令選項。
表格 11-5 csbackup 公用程式指令選項
選項
說明
-v
在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q
在無訊息模式下執行：
預設為關閉。
-a userid
要備份的行事曆使用者的使用者 ID。此選項需要預設選項。無預設值。
-b basedn
要用於該使用者的基準 DN。預設使用 ics.conf 檔案中所定義 local.ugldapbasedn 設定的值。
基準 DN (識別名稱) 是 LDAP 目錄中用作搜尋起點的項目。
例如，如果您指定的基準 DN 為 ou=people, o=sesta.com，則由 Calendar Server 執行的所有 LDAP 搜尋作業將僅檢查 o=sesta.com 目錄樹中的子樹 ou=people。
-c calid
要備份的行事曆 ID。此選項需要與 calendar 指令一起使用。無預設值。
如需更多資訊，請參閱行事曆識別碼 (calid)。
-f
強制所有要刪除的現有備份檔案。
在目前版本中，如果備份目標目錄已存在，即使該目錄為空，您也必須加上 -f 選項。
-l
準備備份檔案，以與 Solstice™ Backup™ 或 Legato Networker™ 備份程序配合使用。如需更多資訊，請參閱第 6 章「備份與復原 Calendar Server 資料」。
範例
cscalcscal 公用程式管理行事曆及其特性。指令包括︰
需求
語法
cscal [-q|-v] [-a aces] [-c charset] [-d description] [-g categories]
[-k yes|no] [-l langcode] [-m email] [-n name] [-o owner]
[-y otherowners] create|modify calid
cscal [-q|-v] [-o owner] [-O] delete|reset calid
cscal [-q|-v] [-o owner] [-O] disable|list [calid]
cscal [-q|-v] [-k yes|no] [-o owner] [-O] enable [calid]
表格 11-6 說明 cscal 公用程式可以使用的指令。
表格 11-6 cscal 公用程式指令
指令
說明
create calid
建立 calid 指定的行事曆。
注意：如果您的站台使用 LDAP CLD 外掛程式，您必須在使用者行事曆常駐 (或將要常駐) 的同一後端伺服器上建立新行事曆，如使用者的 icsDWPHost LDAP 性質所指定。如果您嘗試在其他後端伺服器上建立行事曆，則 Calendar Server 會傳回錯誤。
delete calid
刪除 calid 指定的行事曆。
如果指定 -o owner 選項，則會刪除主要所有者為指定所有者的所有行事曆。
enable [calid]
啟用 calid 指定的行事曆。如果未指定 calid，則會啟用所有行事曆。
如果指定 -o owner 選項，則會啟用主要所有者為指定所有者的所有行事曆。
disable [calid]
停用 calid 指定的行事曆。如果未指定 calid，則會停用所有行事曆。
如果指定 -o owner 選項，則會停用主要所有者為指定所有者的所有行事曆。
list [calid]
列出 calid 所指定行事曆的特性。如果未指定 calid，則會列出所有行事曆的特性。
如果指定 -o owner 選項，則會列出主要所有者為指定所有者的所有行事曆。
modify calid
修改 calid 所指定行事曆的特性。
reset calid
將 calid 所指定行事曆的特性重設為預設配置設定。
version
顯示公用程式的版本。
表格 11-7 說明 cscal 公用程式指令選項。
表格 11-7 cscal 公用程式指令選項
選項
說明
-v
在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q
在無訊息模式下執行：
預設為關閉。
-a [aces]
所指定行事曆的存取控制項目 (ACE)。ACE 決定可以存取群組排程行事曆的人員，以及他們擁有的許可權類型，如建立、刪除、讀取和寫入權限。ACE 字串或存取控制清單 (ACL) 必須置於引號 (" ") 中。
預設為 ics.conf 檔案中的 calstore.calendar.default.acl 參數。
如需有關 ACE 格式的詳細資訊，請參閱第 4 章「管理 Calendar Server 存取控制」。
-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
主要所有者。預設設定為行事曆 ID (calid)，通常與使用者 ID 相同。
-O
指定主要所有者的所有行事曆。預設僅為已命名的行事曆。
-y otherowners
其他行事曆所有者。多個所有者必須置於引號 ("") 中，並以空格分隔。預設為無其他所有者。
範例
cscleancsclean 公用程式可移除狀態性質 (inetUserStatus) 已被 Sun ONE Identity Server 的 commadmin 公用程式標記為「已刪除」的 Calendar Server 使用者的使用者行事曆和資源行事曆。
刪除 Calendar Server 使用者包括以下步驟︰
如需有關 commadmin 公用程式的資訊，請參閱「Sun ONE Messaging and Collaboration 1.0 User Management Utility Installation and Reference Guide」。
Sun ONE Messaging Server 使用類似的公用程式 (msuerpurge) 從郵件儲存中移除使用者。如需有關 msuserpurge 公用程式的資訊，請參閱「Sun ONE Messaging Server 6.0 Reference Manual」。
需求
語法
表格 11-8 說明 csclean 公用程式指令選項。
表格 11-8 csclean 公用程式指令選項
選項
說明
-q
在無訊息模式下執行：
預設為關閉。
-v
在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-g graceperiod
指定為使用者刪除行事曆服務以後經過的天數。
預設為 10 天。
範例
cscomponentscscomponents 公用程式管理行事曆元件︰事件和工作 (待辦事項)。指令包括︰
需求
語法
表格 11-9 說明 cscomponents 公用程式可以使用的指令。
表格 11-9 cscomponents 公用程式指令
指令
說明
delete calid
刪除包含指定行事曆 ID 的行事曆中的事件和工作。
list calid
列出包含指定行事曆 ID 的行事曆中的事件和工作。
version
將公用程式的版本顯示在螢幕上。
表格 11-10 說明 cscomponent 公用程式指令選項。
表格 11-10 cscomponent 公用程式指令選項
選項
說明
-v
在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q
在無訊息模式下執行：
預設為關閉。
-e endtime
元件的結束時間。結束時間為 0 表示不限制結束時間。預設為 0。
-s starttime
元件的起始時間。起始時間為 0 表示不限制起始時間。預設為 0。
-t event|task
在其上執行動作之元件 (事件或工作) 的類型。預設為兩者。
範例
csdbcsdb 公用程式管理行事曆資料庫 (行事曆、階段作業和統計資料)。指令包括︰
需求
語法
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 [-g] [dbdir [dstdir]]
表格 11-11 說明 csdb 公用程式可以使用的指令。
表格 11-11 csdb 公用程式指令
指令
說明
create [dbdir]
在指定的資料庫目錄中建立資料庫。如果未指定資料庫目錄，則使用目前目錄。如果伺服器啟動時資料庫不存在，Calendar Server 會自動建立一個。
delete [dbdir]
刪除指定資料庫目錄中的資料庫。如果未指定資料庫目錄，則使用目前目錄。資料庫在開啟時 (Calendar Server 在執行時) 無法被刪除。
list [dbdir]
列出有關指定資料庫目錄之資料庫的資訊。如果未指定資料庫目錄，則使用目前目錄。
recover [dbdir]
嘗試回復指定資料庫目錄中損毀的資料庫。如果未指定資料庫目錄，則使用目前目錄。
check [dbdir]
掃描指定資料庫目錄中的行事曆資料庫，以確定是否發生損毀，並在其輸出中報告結果。如果未指定資料庫目錄，則使用目前目錄。
rebuild [-g] [dbdir [dstdir]]
掃描指定資料庫目錄中的行事曆資料庫，以確定是否發生損毀，並產生重建的行事曆資料庫 (.db 檔案)。如果未指定資料庫目錄，則使用目前目錄。
除其他行事曆資料庫之外，-g 選項還可重建群組排程引擎 (GSE) 資料庫，dstdir 可指定選擇性的目標目錄。
version
顯示公用程式的版本。
表格 11-12 說明 csdb 公用程式指令選項。
表格 11-12 csdb 公用程式指令選項
選項
說明
-v
在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q
在無訊息模式下執行：
預設為關閉。
-f
強制回復行事曆資料庫。
-g
對於 rebuild 指令，除其他行事曆資料庫之外，還可重建群組排程引擎 (GSE) 資料庫。
-t caldb|sessdb|statdb
指定目標資料庫：
注意：如果未指定 -t，csdb 將在所有資料庫上作業，但 check 和 rebuild 指令除外，它們僅在 caldb (行事曆) 上作業。
範例
csdomaincsdomain 公用程式可管理 LDAP 目錄中託管 (虛擬) 網域的 Calendar Server 性質。這些性質是 icsCalendarDomain 物件類別的一部分。指令包括︰
需求
語法
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
表格 11-13 說明 csdomain 公用程式可以使用的指令。
表格 11-13 csdomain 公用程式指令
指令
說明
create
在 LDAP 目錄中建立新的託管網域。網域的所有 Calendar Server 使用者和資源均建立在目錄的此項目之下。
add
在 LDAP 目錄中為特定網域新增 Calendar Server 性質及其關聯值。如果您使用 csdomain 新增或更新網域 LDAP 性質，請重新啟動 Calendar Server 以使新值生效。
delete
在 LDAP 目錄中為特定託管網域刪除某個 Calendar Server 性質，或刪除整個網域的所有 LDAP 項目。
list
顯示 LDAP 目錄中特定網域的 Calendar Server 性質。
version
顯示公用程式的版本。
表格 11-14 說明 csdomain 公用程式指令選項。
表格 11-14 csdomain 公用程式指令選項
選項
說明
-v
在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q
在無訊息模式下執行：
預設為關閉。
-a attr[=value]
指定 LDAP 性質的特性名稱及其選擇性值。
如需這些性質和特性名稱的清單，請參閱 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
LDAP 性質和特性名稱
以下表格說明適用於 csdomain 公用程式的 LDAP 性質和特性名稱。這些性質是 icsCalendarDomain 物件類別的一部分。新增或刪除值時，您必須使用特性名稱，而不是性質名稱。
如果您使用 csdomain 新增或更新網域 LDAP 性質，請重新啟動 Calendar Server 以使新值生效。
icsAllowRights 性質︰csdomain 公用程式
表格 11-15 說明您可以使用 csdomain 公用程式設定的 icsAllowRights 性質和特性。該性質為 32 位元的數字字串，字串中的每個位元均對應於特定使用者權限。(在目前版本中，某些位元不使用，並依預設被設定為零。) 如果設定了對應於某特定權限的位元 (值 = 1)，則不允許該權限。如果未設定該位元 (值 = 0)，則允許該權限。
icsAllowRights 性質中的每個特性均具有對應的 ics.conf 參數。如果未設定特性 (值 = 0) 或特性不存在 (service.virtualdomain.support = "no")，則 Calendar Server 將使用對應的 ics.conf 參數作為預設值。
icsAllowRights 的值是數字字串，而不是整數。若要透過程序設計將 icsAllowRights 用於逐位元作業，您必須先將其字串值轉換為整數。
表格 11-15 icsAllowRights LDAP 目錄性質和特性
位元 特性名稱
說明
0
allowCalendarCreation
如果設定 (位元 0 = 1)，則不允許建立行事曆。
對應的 ics.conf 參數為︰
service.wcap.allowcreatecalendars
1
allowCalendarDeletion
如果設定 (位元 1 = 1)，則不允許刪除行事曆。
對應的 ics.conf 參數為︰
service.wcap.allowdeletecalendars
2
allowPublicWritableCalendars
如果設定 (位元 2 = 1)，則不允許公用的可寫入行事曆。
對應的 ics.conf 參數為︰
service.wcap.allowpublicwriteablecalendars
3
n/a
在目前版本中不使用。
4
allowModifyUserPreferences
如果設定 (位元 4 = 1)，則不允許網域管理員使用 WCAP 指令取得或設定使用者偏好設定。
對應的 ics.conf 參數為︰
service.admin.calmaster.wcap.allowgetmodifyuserprefs
5
allowModifyPassword
如果設定 (位元 5 = 1)，則不允許使用者經由此伺服器變更密碼。
對應的 ics.conf 參數為︰
service.wcap.allowchangepassword
6,7
n/a
在目前版本中不使用。
8
allowUserDoubleBook
如果設定 (位元 8 = 1)，則不允許使用者行事曆的雙預定。
對應的 ics.conf 參數為︰
user.allow.doublebook
9
allowResourceDoubleBook
如果設定 (位元 9 = 1)，則不允許資源行事曆的雙預定。
對應的 ics.conf 參數為︰
resource.allow.doublebook
10
allowSetCn
如果設定 (位元 10 = 1)，則不允許使用者使用 WCAP 的 set_userprefs 指令設定一般名稱 (cn) 性質。
對應的 ics.conf 參數為︰
service.wcap.allowsetprefs.cn
11
allowSetGivenName
如果設定 (位元 11 = 1)，則不允許使用者使用 WCAP 的 set_userprefs 指令設定 givenName 性質。
對應的 ics.conf 參數為︰
service.wcap.allowsetprefs.givenname
12
allowSetGivenMail
如果設定 (位元 12 = 1)，則不允許使用者使用 WCAP 的 set_userprefs 指令設定 mail 性質。
對應的 ics.conf 參數為︰
service.wcap.allowsetprefs.mail
13
allowSetPrefLang
如果設定 (位元 13 = 1)，則不允許使用者使用 WCAP 的 set_userprefs 指令設定 preferredLanguage 性質。
對應的 ics.conf 參數為︰
service.wcap.allowsetprefs.preferredlanguage
14
allowSetSn
如果設定 (位元 14 = 1)，則不允許使用者使用 WCAP 的 set_userprefs 指令設定姓氏 (sn) 性質。
對應的 ics.conf 參數為︰
service.wcap.allowsetprefs.sn
15
如果設定 (位元 15 = 1)，則不允許使用者使用 WCAP 的 set_userprefs 指令設定使用者的預設行事曆 ID (nswccalid)。
對應的 ics.conf 參數為︰
service.wcap.allowsetprefs.nswccalid
16-31
n/a
在目前版本中不使用。
icsExtendedDomainPrefs 性質︰csdomain 公用程式
表格 11-16 說明您可以使用 csdomain 公用程式設定的 icsExtendedDomainPrefs 性質和特性。每個特性均具有對應的 ics.conf 參數。如果未設定特性 (值 = 0) 或特性不存在 (service.virtualdomain.support = "no")，則 Calendar Server 將使用對應的 ics.conf 參數作為預設值。
表格 11-16 icsExtendedDomainPrefs LDAP 目錄性質
特性名稱
說明
allowProxyLogin
指定 "yes" 或 "no" 以表示是否允許代理登入。
對應的 ics.conf 參數為︰
service.http.allowadminproxy (預設 = "no")
calmasterAccessOverride
指定 "yes" 或 "no" 以表示 Calendar Server 管理員是否可以置換存取控制。
對應的 ics.conf 參數為︰
service.admin.calmaster.overrides.accesscontrol (預設 = "no")
calmasterCred
指定一個 ASCII 字串，該字串是被指定為 Calendar Server 網域管理員之使用者 ID 的密碼。
對應的 ics.conf 參數為︰
service.admin.calmaster.cred (無預設值)
calmasterUid
指定一個 ASCII 字串，該字串是被指定為 Calendar Server 網域管理員的使用者 ID。
對應的 ics.conf 參數為︰
service.admin.calmaster.userid (無預設值)
createLowercase
指定 "yes" 或 "no" 以表示在建立新行事曆或搜尋行事曆時，Calendar Server 是否應將行事曆 ID (calid) 轉換為小寫。
對應的 ics.conf 參數為︰
calstore.calendar.create.lowercase (預設 = "no")
domainAccess
指定網域的存取控制清單 (ACL)。如需有關 ACL 的資訊，請參閱存取控制清單 (ACL)。
此 ACL 用於跨網域搜尋。如需更多資訊，請參閱交叉網域搜尋。
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" 以表示 Calendar Express 是否應顯示並使用「所有使用者」存取控制清單 (ACL)。
對應的 ics.conf 參數為︰
ui.allow.anyone (預設 = "yes")
uiAllowDomain
指定 "yes" 或 "no" 以表示 Calendar Express 是否應顯示並使用此網域的存取控制清單 (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 (無預設值)
其他 LDAP 目錄性質︰csdomain 公用程式
表格 11-17 說明您可以使用 csdomain 公用程式設定的其他 LDAP 性質和特性。
表格 11-17 csdomain 公用程式的其他 LDAP 目錄性質
LDAP 性質
特性名稱
說明
icsAllowedServiceAccess
allowedAccessProtocols
指定是否允許存取 Calendar Server。如果設定為「http」，則拒絕存取。如果設定為其他任何值，則允許存取。
僅在未設定 icsStatus 性質時，Calendar Server 才使用此性質。
icsDefaultAccess
userDefaultAcl
為新建立的使用者行事曆指定 ACL。
對應的 ics.conf 參數為︰
calstore.calendar.default.acl
icsDomainNames
searchDomainNames
指定在尋找行事曆或使用者時此網域可以搜尋的外部網域。
對應的 ics.conf 參數為︰無
icsDWPBackEndHosts
指定未明確提供主機名稱時，使用者的預設後端主機 (DNS 名稱)。此性質在 Calendar Server 處於 LDAP CLD 模式時使用。
icsStatus
statusCalendarDomain
指定 Calendar Server 的狀態︰
如果設定 icsStatus，其值將置換 icsAllowedServiceAccess 性質。
如果未設定 icsStatus，Calendar Server 將使用 icsAllowedServiceAccess 性質。
icsTimezone
timezone
指定匯入檔案時使用的時區 ID。例如，America/New_York 或 Asia/Tokyo。
如需所支援時區的資訊，請參閱 timezones.ics 檔案。
範例
csexportcsexport 公用程式可將行事曆匯出至 iCalendar (.ics) 或 XML (.xml) 格式的檔案。指令包括︰
需求
語法
表格 11-18 說明 csexport 公用程式可以使用的指令。
表格 11-18 csexport 公用程式指令
指令
說明
calendar outputfile
將行事曆匯出至指定的輸出檔案。檔案的資料格式由指定檔案名稱的副檔名決定︰
version
顯示公用程式的版本。
表格 11-19 說明 csexport 公用程式指令選項。
表格 11-19 csexport 公用程式指令選項
選項
說明
-v
在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q
在無訊息模式下執行：
預設為關閉。
-c calid
要匯出的行事曆之行事曆 ID。此選項需要與 calendar 指令一起使用。無預設值。
範例
csimportcsimport 公用程式可從 csexport 公用程式儲存的 iCalendar (ics) 或 XML 格式的檔案匯入行事曆。指令包括︰
需求
語法
表格 11-20 說明 csimport 公用程式可以使用的指令。
表格 11-20 csimport 公用程式指令
指令
說明
calendar inputfile
從指定的輸入檔案匯入行事曆。檔案的資料格式由檔案名稱的副檔名決定︰
version
顯示公用程式的版本。
表格 11-21 說明 csimport 公用程式指令選項。
表格 11-21 csimport 公用程式指令選項
選項
說明
-v
在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q
在無訊息模式下執行：
預設為關閉。
-c calid
要匯入的行事曆之行事曆 ID。此選項需要與 calendar 指令一起使用。
如果指定的行事曆 ID 已經存在，則匯入的資料將併入目前行事曆。無預設值。
如需更多資訊，請參閱行事曆識別碼 (calid)。
範例
csmonitorcsmonitor 公用程式為執行以下監視功能的程序檔：
語法
表格 11-22 說明 csmonitor 公用程式的指令。
表格 11-23 csmonitor。
表格 11-23 csmonitor 配置參數
參數
說明
service.monitor.continuous
指定 csmonitor 是否應持續迴圈︰
"0" – 不持續迴圈。
"1" – 持續迴圈。
此選項需要較多的系統資源，但在除錯模式下十分有用。
預設為 "0"。
service.monitor.loopsdelay
指定兩個監視迴圈之間的延遲 (以秒為單位)。預設為 "60"。
service.monitor.emailaddress.from
指定 csmonitor 傳送訊息的電子郵件位址。預設為無。
service.monitor.emailaddress.to
指定 csmonitor 應將訊息傳送至的電子郵件位址。預設為無。
service.monitor.csdb.logthreshold
指定被視為正常的最大磁碟佔用率的臨界值 (以總磁碟空間的百分比表示)。如果行事曆資料庫 (csdb 目錄) 所在磁碟的佔用率超出此值，csmonitor 將傳送警告電子郵件訊息。
預設為 "90"。
logfile.monitor.logname
指定 csmonitor 日誌檔名稱。
預設為 "csmonitor.log"。
logfile.monitor.maxlogfilesize
指定日誌檔的最大大小。如果日誌檔超出此大小，csmonitor 會將日誌儲存為 csmonitor.log.timestamp，並重設日誌。
預設為 "2097152"。
service.monitor.dbglevel
指定除錯級別。此值越高，csmonitor 傳送的訊息就越精確、越詳細。
預設為 "0"。
csplugincsplugin 可管理為您的 Calendar Server 安裝所配置的 CSAPI 外掛程式。指令包括︰
- activate，載入和啟動指定的外掛程式。
- deactivate，關閉和停用指定的外掛程式類型和外掛程式名稱。(如需支援的外掛程式類型的說明，請參閱表格 11-25 中的「-t」選項。)
- list，顯示所有支援的外掛程式。
- version，顯示目前安裝之公用程式的版本號碼。
需求
語法
csplugin [-q|-v] [-r] -t ac|attr|auth|locate|lookup|xlate
activate|deactivate plugin
csplugin [-q|-v] list
表格 11-24 說明 csplugin 公用程式可以使用的指令。
表格 11-24 csplugin 公用程式指令
指令
說明
activate -t type name
載入和啟用指定的外掛程式類型和外掛程式名稱。(如需支援的外掛程式類型的說明，請參閱表格 11-25 中的「-t」選項。)
deactivate -t type name
關閉和停用指定的外掛程式類型和外掛程式名稱。(如需支援的外掛程式類型的說明，請參閱表格 11-25 中的「-t」選項。)
list
列出所有支援的外掛程式類型、名稱和啟動狀態。(如需支援的外掛程式類型的說明，請參閱表格 11-25 中的「-t」選項。)
version
顯示公用程式的版本。
表格 11-25 說明 csplugin 公用程式指令選項。
表格 11-25 csplugin 公用程式指令選項
選項
說明
-v
在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q
在無訊息模式下執行：
預設為關閉。
-r
與 activate 指令一起使用時，可將外掛程式實體複製到 Calendar Server 外掛程式目錄。
與 deactivate 指令一起使用時，可從外掛程式目錄刪除外掛程式。
-t type
指定外掛程式的以下支援的類型之一︰
範例
cspurgecspurge 公用程式允許手動清除刪除日誌資料庫 (ics50deletelog.db) 中的項目。
需求
語法
表格 11-26 說明 cspurge 公用程式指令選項。
表格 11-26 cspurge 公用程式指令選項
選項
說明
-v
在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q
在無訊息模式下執行：
預設為關閉。
-e endtime
指定 GMT (亦稱為 UTC 或祖魯) 格式的結束時間。此值最大為 (小於) 指定時間。
預設為 0，表示不限制結束時間。
-s starttime
指定 GMT (亦稱為 UTC 或祖魯) 格式的起始時間。此值包含 (大於或等於) 指定時間。
預設為 0，表示不限制起始時間。
範例
csresourcecsresource 公用程式可管理 LDAP 伺服器和 Calendar Server 資料庫中儲存的資源 (如會議室或設備) 的行事曆。(csresource 公用程式僅可用於與資源關聯的行事曆，如果針對使用者的行事曆使用此公用程式，會傳回錯誤。)指令包括︰
需求
語法
csresource [-q|-v] [-a aces] [-b basedn] [-d domain] [-t description] [-k yes|no] [-o owner] [-y otherowners] -m email -c calid create name
csresource [-q|-v] [-b basedn] [-d domain]
delete|disable|enable [name]
csresource [-q|-v] [-b basedn] [-d domain] [-h host] list [name]
表格 11-27 說明 csresource 公用程式可以使用的指令。
表格 11-27 csresource 公用程式指令
指令
說明
create name
為指定的行事曆 ID 建立新資源。
delete [name]
刪除一個資源，或在未指定資源 name 時刪除所有資源。
enable [name]
啟用一個資源，或在未指定資源 name 時啟用所有資源。
disable [name]
停用一個資源，或在未指定資源 name 時停用所有資源。
list [name]
顯示單一資源行事曆，或在未指定資源 name 時顯示所有資源行事曆。
如果包含 -h host 選項，則顯示該後端伺服器上指定名稱 (或所有資源行事曆) 的行事曆性質。
表格 11-28 說明 csresource 公用程式指令選項。
表格 11-28 csresource 公用程式指令選項
選項
說明
-v
在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q
在無訊息模式下執行：
預設為關閉。
-a [aces]
所指定行事曆的存取控制項目 (ACE)。ACE 決定可以存取群組排程行事曆的人員，以及他們擁有的許可權類型，如建立、刪除、讀取和寫入權限。ACE 字串或存取控制清單 (ACL) 必須置於引號 ("") 中。
預設為 ics.conf 檔案中的 resource.default.acl 參數。
如需有關 ACE 格式的資訊，請參閱第 4 章「管理 Calendar Server 存取控制」。
-b [basedn]
用於指定資源的 LDAP 基準 DN (識別名稱)。預設使用 ics.conf 檔案中 local.ugldapbasedn 參數的值。
-c calid
icsCalendar 性質。此選項需要與 create 指令一起使用。如需更多資訊，請參閱行事曆識別碼 (calid)。
-d domain
指定託管 (虛擬) 網域的名稱。預設使用 ics.conf 檔案中 service.defaultdomain 參數的值。
-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.admin.calmaster.userid 的值。
-y otherowners
其他所有者。多個所有者必須置於引號 (" ") 中，並以空格分隔。預設為無其他所有者。
version [name]
顯示公用程式的版本。
範例
csrestorecsrestore 公用程式可復原使用 csbackup 或 csexport 儲存的行事曆資料庫、指定的行事曆或使用者的預設行事曆。指令包括︰
位於指定備份目錄中的 caldb.conf 版本檔案顯示已備份資料庫的版本號碼。
小心 Calendar Server 6.x csrestore 與 2.x 版本的 csrestore 不相容。請勿嘗試復原使用 Calendar Server 2.x csrestore 備份的資料，因為這可能會導致資料遺失。
需求
語法
csrestore [-v|-q] [-f] database inputdir
csrestore [-v|-q] -c calid calendar inputfile
csrestore [-v|-q] -a userid [-b basedn] defcal inputfile
表格 11-29 說明 csrestore 公用程式可以使用的指令。
表格 11-29 csrestore 公用程式指令
指令
說明
database inputdir
從包含備份行事曆資料庫的指定輸入目錄或輸入檔案復原行事曆資料庫。此作業會覆寫目前行事曆資料庫的所有先前內容。
calendar inputfile
從指定的輸入檔案復原指定的行事曆 ID。檔案的資料格式由檔案名稱的副檔名決定︰
如果指定的行事曆 ID 已經存在，則系統在復原行事曆的資料之前會將該資料清除。
defcal inputfile
從指定的輸入檔案復原指定使用者 ID 的預設行事曆。檔案的資料格式由檔案名稱的副檔名決定︰
version
顯示公用程式的版本。
表格 11-30 說明 csrestore 公用程式指令選項。
表格 11-30 csrestore 公用程式指令選項
選項
說明
-v
在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q
在無訊息模式下執行：
預設為關閉。
-a userid
要復原的使用者 ID。此選項需要預設選項。無預設值。
-b basedn
要用於指定使用者 ID 的 LDAP 基準 DN (識別名稱)。預設使用 ics.conf 檔案中所定義 local.ugldapbasedn 設定的值。
-f
強制所有要刪除的現有資料庫檔案。
-c calid
要復原的行事曆 ID。此選項需要與 calendar 指令一起使用。無預設值。
如需更多資訊，請參閱行事曆識別碼 (calid)。
範例
csschedulecsschedule 公用程式可管理群組排程引擎 (GSE) 佇列中儲存的排程項目。指令包括︰
需求
語法
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]
表格 11-31 說明 csschedule 公用程式可以使用的指令。
表格 11-31 csschedule 公用程式指令
指令
說明
list
顯示指定行事曆 ID 請求的 GSE 佇列中儲存的項目。
delete
從指定行事曆 ID 請求的 GSE 佇列中移除項目。
version
顯示公用程式的版本。
表格 11-32 說明 csschedule 公用程式指令選項。
表格 11-32 csschedule 公用程式指令選項
選項
說明
-v
在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q
在無訊息模式下執行：
預設為關閉。
-c count
要列出的 GSE 佇列項目的數目。例如，如果您要檢查佇列中的十個項目，則指定 10。
-e endtime
GSE 佇列中項目的結束時間，其中 0 表示不限制結束時間。預設為 0。
-n sequencenumber
佇列中事件或工作的序列號碼。
-o offset
排程時間的偏移。同時排程一個以上的項目時，偏移可唯一識別 GSE 佇列中的項目。
-r rid
事件或待辦事項的週期性 ID (RID)。RID 是以分號分隔的字串清單，可識別發生的每個週期性事件或待辦事項。
-s starttime
GSE 佇列中項目的起始時間，其中 0 表示不限制起始時間。預設為 0。
-t scheduletime
排程時間，例如︰20001231T103045Z
-u uid
GSE 佇列中項目的唯一識別碼 (UID)。
範例
csstart
註
Calendar Server 提供 csstart 和 csstop 公用程式的目的僅為提供與舊版本的相容性。
建議您使用 start-cal 和 stop-cal 指令來啟動和停止 Calendar Server。如需更多資訊，請參閱啟動和停止 Calendar Server。
csstart 公用程式可啟動 Calendar Server。指令包括︰
需求
語法
表格 11-33 說明 csstart 公用程式可以使用的指令。
表格 11-33 csstart 公用程式指令
指令
說明
check | list
[servicename]檢查指定的 Calendar Server 服務是否在執行，或檢查所有 Calendar Server 服務是否在執行 (如果未指定服務名稱)
或列出所有 Calendar Server 服務 (或指定的服務) 及其階段作業 ID。
servicename 可為以下之一︰
service [servicename]
啟動指定的 Calendar Server 服務或其所有服務 (如果未指定服務名稱)。Calendar Server 服務應按以下次序啟動︰
1. ens — 可由其他 Sun ONE 伺服器共用的通用事件註冊和通知服務
2. notify — Calendar Server 通知服務
3. admin — Calendar Server 管理服務 (在藩侜督んCん奻歙岆斛剒腔)
4. dwp — Calendar Server 資料庫服務 (僅透過遠端資料庫配置啟動)
5. http — Calendar Server HTTP 服務
如需有關 Calendar Server 服務的更多資訊，請參閱以下小節︰
- 「Calendar Server 存取控制」。
- 服務配置.
version
顯示公用程式的版本。
表格 11-34 說明 csstart 公用程式指令選項。
表格 11-34 csstart 公用程式指令選項
選項 說明
-v
在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-f
強制指定的 Calendar Server 服務 (如果未指定服務，則為所有目前執行的服務) 以︰
1. 停止 (類似 kill -9 指令)。
2. 清除所有資料庫問題。
3. 啟動所有服務。
注意：建議您使用 stop-cal 和 start-cal 公用程式來停止和啟動 Calendar Server。
-q
在無訊息模式下執行：
預設為關閉。
範例
csstatscsstats 公用程式可顯示 Calendar Server 統計資料。指令包括︰
如需有關計數器的更多資訊，請參閱計數器配置 (counter.conf) 檔案。
需求
語法
表格 11-35 說明 csstats 公用程式可以使用的指令。
表格 11-35 csstats 公用程式指令
指令
說明
list [subsystem]
列出有關指定 Calendar Server 子系統的計數器統計資料。如果未指定子系統，則顯示有關可用子系統的基本資訊，包括︰
Version
顯示公用程式的版本。
表格 11-36 說明 csstats 公用程式指令選項。
表格 11-36 csstats 公用程式指令選項
選項
說明
-v
在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q
在無訊息模式下執行：
預設為關閉。
-i iterations
重複統計資料查找的次數。預設為 1。
-r registry
儲存計數器統計資料的檔案之名稱和位置。預設為：
/opt/SUNWics5/cal/lib/counter/counter
-s delay
顯示每個統計資料查找之前等待的時間 (以秒為單位)。預設為 1 秒。
範例
csstop
註
Calendar Server 提供 csstop 和 csstart 公用程式的目的僅為提供與舊版本的相容性。
建議您使用 start-cal 和 stop-cal 公用程式來啟動和停止 Calendar Server。如需更多資訊，請參閱啟動和停止 Calendar Server。
csstop 公用程式可停止 Calendar Server。指令包括︰
需求
語法
表格 11-37 說明 csstop 公用程式可以使用的指令。
表格 11-37 csstop 公用程式指令
指令
說明
check | list
[servicename]檢查指定的 Calendar Server 服務是否在執行，或檢查所有服務是否在執行 (如果未指定服務名稱)。
或列出所有 Calendar Server 服務或指定的服務及其階段作業 ID。servicename 可為以下之一︰
service [servicename]
停止指定的 Calendar Server 服務或其所有服務 (如果未指定服務名稱)。Calendar Server 服務應按以下次序啟動，並按相反次序停止︰
1. ens — 可由其他 Sun ONE 伺服器共用的通用事件註冊和通知服務。
2. notify — Calendar Server 通知服務。
3. admin — Calendar Server 管理服務 (admin 在每個伺服器機器上均是必需的)。
4. dwp — Calendar Server 資料庫服務 (僅透過遠端資料庫配置啟動)。
5. http — Calendar Server HTTP 服務。
如需有關 Calendar Server 服務的更多資訊，請參閱以下小節︰
- 「Calendar Server 存取控制」。
- 服務配置.
version
顯示公用程式的版本。
.
表格 11-38 說明 csstop 公用程式指令選項。
表格 11-38 csstop 公用程式指令選項
選項 說明
-v
在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q
在無訊息模式下執行：
預設為關閉。
-f
強制 Calendar Server 服務停止 (如果先前的嘗試失敗，則類似 kill -9 指令)。
此選項僅能與 service 指令一起使用。
範例
csstored.plcsstored.pl 公用程式為一種可執行行事曆資料庫和日誌檔的以下線上作業或「緊急」歸檔作業的 Perl 程序檔：
如需有關 Berkeley 資料庫公用程式的說明文件，請參閱 Sleepycat 軟體網站：
http://www.sleepycat.com/docs/utility/index.html
需求
語法
表格 11-39 說明 ics.conf 檔案中由 csstored.pl 公用程式使用的參數︰
表格 11-39 ics.conf 檔案中由 csstored.pl 公用程式使用的參數
參數
說明
caldb.berkeleydb.homedir.path
指定儲存行事曆資料庫檔案的目錄路徑。
預設為 "."，指定以下目錄︰
cal_svr_base/var/opt/SUNWics5/csdb
caldb.berkeleydb.archive.path
指定行事曆資料庫歸檔目錄的路徑。無預設值。
若要執行 csstored.pl，請指定一個不同於行事曆資料庫目錄和「緊急」備份目錄的路徑。
caldb.berkeleydb.hotbackup.path
指定「緊急」備份目錄的路徑。無預設值。
若要執行 csstored.pl，請指定一個不同於行事曆資料庫目錄和歸檔目錄的路徑。
caldb.berkeleydb.archive.enable
啟用 ("yes") 或停用 ("no") 行事曆資料庫的歸檔選項。
預設為 "no"。
若要執行 csstored.pl，請將此參數設定為 "yes"。
caldb.berkeleydb.hotbackup.enable
啟用 ("yes") 或停用 ("no") 行事曆資料庫的「緊急」備份選項
預設為 "no"。
若要執行 csstored.pl，請將此參數設定為 "yes"。
caldb.berkeleydb.circularlogging
指定 ("yes" 或 "no") 同步化資料庫檢查點檔案的異動後，是否移除這些檔案。
預設為 "yes"。
若要執行 csstored.pl，請將此參數設定為 "no"。
caldb.berkeleydb.archive.interval
指定歸檔行事曆資料庫的間隔時間 (以秒為單位)。
預設為「120」秒。
cstoolcstool 公用程式可 Ping Calendar Server、cshttpd 服務或事件通知服務 (ENS)。cstool 還可強制 Calendar Server 或特定服務以更新其配置。指令包括︰
註
在目前版本中，請勿使用 cstool refresh 更新配置。而是使用 stop-cal 和 start-cal 公用程式以停止然後重新啟動 Calendar Server。
如需更多資訊，請參閱啟動和停止 Calendar Server 和編輯 ics.conf 配置檔案。
需求
語法
cstool [-q|-v] [-h host] [-p port] [-t timeout] ping [http|ens]
cstool [-q|-v] [-h host] refresh [servicename]
表格 11-40 說明 cstool 公用程式可以使用的指令。
表格 11-40 cstool 公用程式指令
指令
說明
ping [http|ens]
Ping cshttpd 或 ENS 服務。
refresh [servicename]
強制 Calendar Server 更新指定服務的配置，如果未指定服務，則更新所有 Calendar Server 服務的配置。Calendar Server 服務選項包括︰
version
顯示公用程式的版本。
表格 11-41 說明 cstool 公用程式指令選項。
表格 11-41 cstool 公用程式指令選項
選項
說明
-v
在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q
在無訊息模式下執行：
預設為關閉。
-h host
指定執行 Calendar Server 之機器的主機名稱。預設值在安裝時設定，且預設使用 ics.conf 檔案中 local.hostname 參數的值。如果您要存取在遠端機器上執行的 Calendar Server，請使用此選項。
-p port
使用指定服務的連接埠，如果未指定服務，則使用 ics.conf 檔案中所定義連接埠的預設值。
-t timeout
等待伺服器回應的時間 (以秒為單位)。預設為 120 秒。
範例
csusercsuser 公用程式可管理 LDAP 目錄伺服器和 Calendar Server 行事曆資料庫中儲存的行事曆使用者資訊。指令包括︰
如果您使用的是 Sun ONE Directory Server，則還可以使用 ldapsearch 和 ldapmodify 公用程式。如需有關這些公用程式的資訊，請參閱以下網站上的 Sun ONE Directory Server 說明文件︰
http://docs.sun.com/coll/S1_DirectoryServer_52
需求
語法
csuser [-q|-v] [-a aces] [-b basedn] -m email [-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
表格 11-42 說明 csuser 公用程式可以使用的指令。
表格 11-42 csuser 公用程式指令
指令
說明
check userid
檢查是否允許指定的使用者 ID 對行事曆進行作業。
create userid
建立指定的使用者 ID，並使該使用者登入 Calendar Server。
delete userid
刪除指定的使用者 ID。
disable userid
禁止指定的使用者 ID 對行事曆進行作業。此公用程式將 http 定義為 nswcalDisallowAccess 性質的值。
enable userid
允許指定的使用者 ID 對行事曆進行作業。(此公用程式將指定的行事曆 ID 新增至 nswcalCALID 性質。)
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 的 enable 指令時，這些性質將在使用者的 LDAP 項目中被復原。
version
顯示公用程式的版本。
表格 11-43 說明 csuser 公用程式指令選項。
表格 11-43 csuser 公用程式指令選項
選項
說明
-v
在詳細模式下執行：顯示有關正在執行的指令之所有可用資訊。預設為關閉。
-q
在無訊息模式下執行：
預設為關閉。
-d domain
指定託管 (虛擬) 網域的名稱。預設使用 ics.conf 檔案中 service.defaultdomain 參數的值。
-a [aces]
所指定行事曆的存取控制項目 (ACE)。ACE 決定可以存取群組排程行事曆的人員，以及他們擁有的許可權類型，如建立、刪除、讀取和寫入權限。ACE 字串或存取控制清單 (ACL) 必須置於引號 ("") 中。
預設為：
"@@o^a^r^g;@@o^c^wdeic^g;@^a^sf^g;@^c^^g;@^p^r^g"
如需有關 ACE 格式的詳細資訊，請參閱服務配置。
-b [basedn]
所指定使用者 ID 的 LDAP 基準 DN (識別名稱)。
預設使用 ics.conf 檔案中 local.ugldapbasedn 參數的值。
-c [calid]
與指定使用者 ID 關聯之預設行事曆的行事曆 ID。預設為使用者 ID。此選項對 create 指令無效。
如需更多資訊，請參閱行事曆識別碼 (calid)。
-f filename
檔案名稱，用於為需要密碼的選項 (-y 參數) 指定密碼。如果您要從程序檔執行 csuser，建議您使用附加的安全性，即在檔案名稱中指定密碼。
-g givenname
使用者的 LDAP 給定名稱 (名字)。此選項是必需的。無預設值。
-h host
指定使用者行事曆所在之後端伺服器的名稱。此選項僅適用於 list 指令。
-k yes|no
是否允許使用者行事曆的雙預定。如果是，則使用者的行事曆可以為同一時段排程一個以上的事件。
預設使用 ics.conf 檔案中所定義 user.allow.doublebook 設定的值。
-l [langcode]
語言代碼。預設為 ics.conf 中 local.sitelanguage 的值。
-m email
指定使用者的 LDAP mail 性質 (主要電子郵件位址)。
-s surname
使用者的 LDAP 姓氏 (姓)。此選項是必需的。無預設值。
-y userpassword
所需的行事曆使用者的密碼。無預設值。
範例
start-calstart-cal 公用程式可按以下次序啟動 Calendar Server 服務︰
需求
語法
範例
./start-cal
如需更多資訊，請參閱啟動和停止 Calendar Server。
stop-calstop-cal 公用程式可停止所有 Calendar Server 服務。
需求
語法
範例
./stop-cal
如需更多資訊，請參閱啟動和停止 Calendar Server。
