Sun Java System Calendar Server 6.3 管理指南

第 5 部分 附錄

此部分包含管理指南的附錄。

附錄 A 目錄配置工作表

這個工作表可協助您收集在執行 comm_dssetup.pl 時會詢問您的資訊。第一欄顯示無訊息模式選項及其預期的資訊。第二欄顯示互動模式中的相同選項及預設答案。

右欄中提供一行供您填寫要給出的答案。它適用於無訊息模式和互動模式。對於無訊息模式,請將答案用作選項的值。對於互動模式,請在提示處輸入您的值。

如需有關如何執行 comm_dssetup.pl 的範例及說明,請參閱「Sun Java System Communications Suite 5 Installation and Configuration Guide」。

表 A–1 Directory Server 設定程序檔 (comm_dssetup.pl) 工作表

無訊息模式選項 

互動式對話方塊和預設值 

-i yes | no

增加新的 Directory Server 索引 (yes/no)。 

預設:是 

您的值: 

-R yes | no

立即重新索引 (yes/no)。 

預設:是 

您的值: 

-c Directory Server 根

Directory Server 根路徑名稱。 

預設:/var/opt/Sun/dsins

您的值: 

-d Directory Server 實例

Directory Server 實例子目錄。 

預設:無 

您的值: 

-r DC 根尾碼

DC 樹狀結構根尾碼。 

預設:o=internet

您的值: 

-u 使用者和群組基底尾碼

使用者/群組根尾碼。 

預設:o=usergroup

您的值: 

-s yes | no

更新模式 (yes/no)。 

預設:是 

您的值: 

-D 目錄管理員 DN

目錄管理員辨別名稱 (DN)。 

預設:"cn=Directory Manager".

您的值: 

-w 目錄管理員 DN 密碼

目錄管理員 DN 密碼。 

預設:無。 

您的值: 

-b yes | no

使用此目錄儲存配置資料與使用者資料 (yes) 或僅儲存配置資料 (no)。 

預設:是 

您的值: 

-t 1|1.5|2

模式版本: 

  • 選項 1 – Schema 1

  • 選項 1.5 – Schema 2 相容模式

  • 選項 2 – Schema 2 原生模式

    預設:1

    您的值:

-m yes|no

您要修改目錄伺服器嗎? 

預設:是 

no- 列印程序檔但不執行該程序檔。 

-S PathtoSchemaFile

模式檔案所在目錄的路徑。 

預設:./schema

您的值: 

附錄 B Calendar Server 配置工作表

本附錄包含以下工作表,可協助您追蹤執行 Calendar Server 配置程式所需的資訊,該配置程式在第 2 章, Calendar Server 6.3 軟體的初始執行階段配置程式 (csconfigurator.sh)中有相關說明。

B.1 管理、使用者喜好設定及認證螢幕工作表

表 B–1 管理、使用者喜好設定及認證螢幕工作表

選項 

說明 

LDAP 伺服器主機名稱 

用於使用者認證的 LDAP 目錄伺服器之主機名稱。 

預設:目前主機。 

您的值: 

LDAP 伺服器連接埠 

LDAP 伺服器偵聽的連接埠號碼。 

預設: 389。 

您的值: 

基底 DN 

LDAP 目錄中用做搜尋起點的項目。 

預設:o=host.com

您的值: 

目錄管理員 DN 

可以在目錄伺服器模式中進行變更的使用者名稱。 

預設: cn=Directory Manager

您的值: 

目錄管理員密碼 

目錄管理員 DN 的密碼。 

預設:無 

您的值: 

管理員使用者 ID 

管理員的使用者。該使用者必須是上述 LDAP 目錄伺服器中的使用者。 

預設:calmaster

您的值: 

管理員密碼 

Calendar Server 管理員的密碼。 

預設:無 

您的值: 

B.2 電子郵件與電子郵件警示工作表

表 B–2 電子郵件與電子郵件警示工作表

選項 

說明 

電子郵件警示 

指定發生伺服器問題時 Calendar Server 是否應向 Calendar Server 管理員傳送電子郵件警示訊息。 

預設:啟用。 

您的值: 

管理員電子郵件位址 

將接收電子郵件警示訊息的 Calendar Server 管理員之電子郵件位址。 

預設:無。 

您的值: 

SMTP 主機名稱 

應傳送電子郵件警示訊息的 SMTP 伺服器之主機名稱。 

預設:目前主機。 

您的值: 

B.3 執行階段配置工作表

表 B–3 執行階段配置工作表

選項 

說明 

服務連接埠 

Calendar Server 偵聽以向使用者提供 Web (HTTP) 存取權的連接埠號碼。 

預設: 80。 

您的值: 

最大階段作業數 

Calendar Server 階段作業的最大數目。 

預設: 5000。 

您的值: 

最大執行緒數 

Calendar Server 執行緒的最大數目。 

預設:20。 

您的值: 

伺服器程序數 

Calendar Server 程序的最大數目。 

預設:安裝 Calendar Server 的伺服器上的 CPU 數目。 

您的值: 

執行階段使用者 ID 

執行 Calendar Server 時所用的 UNIX 使用者名稱。 

預設:icsuser

您的值: 

執行階段群組 ID 

執行 Calendar Server 時所用的 UNIX 群組。 

預設:icsgroup

您的值: 

Calendar Server 啟動 

成功配置後啟動。 

預設:核取。 

您的值: 

系統啟動時啟動。 

預設:核取。 

您的值: 

B.4 資料庫、記錄和暫存檔目錄工作表

表 B–4 資料庫、記錄和暫存檔目錄工作表

選項 

說明 

資料庫目錄 

Calendar Server 應建立並儲存行事曆資料庫檔案的目錄。 

預設:/var/opt/SUNWics5/csdb

您的值: 

記錄目錄 

Calendar Server 寫入記錄檔的目錄。 

預設:/var/opt/SUNWics5/logs

您的值: 

暫存檔目錄 

Calendar Server 寫入暫存檔的目錄。 

預設:/var/opt/SUNWics5/tmp

您的值: 

附錄 C Calendar Server 配置工作表

C.1 Calendar Server 配置工作表

下表列出了您執行 Calendar Server 配置程式 (csconfigurator.sh) 時設定的值。

表 C–1 Calendar Server 配置工作表

元件 

說明與註釋 

LDAP 伺服器主機名稱 

例如:ldaphost.sesta.com

您的值: 

LDAP 伺服器連接埠 

LDAP 伺服器偵聽的連接埠號碼。 

預設: 389。 

您的值: 

目錄管理員 DN 

可以在目錄伺服器模式中進行變更的使用者名稱。 

預設: cn=Directory Manager

您的值: 

目錄管理員密碼 

目錄管理員 DN 的密碼。 

預設:無 

您的值: 

管理員使用者 ID 

Calendar Server 管理員的使用者 ID。該使用者必須是上述 LDAP 目錄伺服器中的使用者。 

預設:calmaster

您的值: 

管理員密碼 

Calendar Server 管理員的密碼。 

預設:無 

您的值: 

電子郵件警示 

指定發生伺服器問題時 Calendar Server 是否應向 Calendar Server 管理員傳送電子郵件警示訊息。 

預設:啟用。 

您的值: 

管理員電子郵件位址 

將接收電子郵件警示訊息的 Calendar Server 管理員之電子郵件位址。 

預設:無。 

您的值: 

SMTP 主機名稱 

應傳送電子郵件警示訊息的 SMTP 伺服器之主機名稱。 

預設:目前主機。 

您的值: 

服務連接埠 

Calendar Server 偵聽以向使用者提供 Web (HTTP) 存取權的連接埠號碼。 

預設: 80。 

您的值: 

最大階段作業數 

Calendar Server 階段作業的最大數目。 

預設: 5000。 

您的值: 

最大執行緒數 

Calendar Server 執行緒的最大數目。 

預設:20。 

您的值: 

伺服器程序數 

Calendar Server 程序的最大數目。 

預設:安裝 Calendar Server 的伺服器上的 CPU 數目。 

您的值: 

執行階段使用者 ID 

預設值:icsuser

對於 HA 配置,請增加至叢集中所有節點上的 /etc/passwd

您的值: 

執行階段群組 ID 

預設值:icsgroup

對於 HA 配置,請增加至叢集中所有節點上的 /etc/group

您的值: 

Calendar Server 啟動 

成功配置後啟動。 

預設:核取。 

您的值:對於 HA 配置,請核取此選項。

系統啟動時啟動。 

預設:核取。 

您的值:對於 HA 配置,請核取此選項。

資料庫目錄 

預設:/var/opt/SUNWics5/csdb

例如:/global/cal/var/opt/SUNWics5/csdb

您的值: 

記錄目錄 

預設:/var/opt/SUNWics5/logs

例如:/global/cal/var/opt/SUNWics5/logs

您的值 

暫存檔目錄 

預設:/var/opt/SUNWics5/tmp

例如:/global/cal/var/opt/SUNWics5/tmp

您的值: 

附錄 D Calendar Server 指令行公用程式參照

D.3 csattribute

D.10 csexport

D.17 csschedule

D.4 csbackup

D.11 csimport

D.18 csstats

D.5 cscal

D.12 csplugin

D.19 csuser

D.6 csclean

D.13 cspurge

D.20 start-cal

D.7 cscomponents

D.14 csrename

D.21 stop-cal

D.8 csdb

D.15 csresource

 

D.9 csdomain

D.16 csrestore

 

如需每個公用程式的簡短說明,請參閱D.2 指令行公用程式的簡短說明

Calendar Server 提供未包括在 Access Manager 隨附的 Delegated Administrator 中的指令行公用程式。

這些 Calendar Server 公用程式可從 batch、shell 和程序檔程式 (如 Perl) 啟動。在這些公用程式中,某些 (csusercsresourcecsdomain) 已由 Delegated Administrator 公用程式所取代,但其餘的仍在使用,即使在 Schema 2 環境中也是如此。對於 Schema 1,您必須繼續使用 csusercsresourcecsdomain,而不能使用 Delegated Administrator。

如果需要,這些公用程式可使用 ics.conf 配置檔案的預設值。

這些指令行公用程式位於以下目錄中︰cal-svr-base/SUNWics5/cal/sbin

start-calstop-cal 可以從任何目錄 (如果已指定完整路徑) 執行之外,所有其他公用程式均必須從 sbin 目錄啟動。


備註 –

這些管理工具的錯誤訊息是被寫入 csdb 目錄中的 admin.log 檔案。


本章提供以下資訊︰

D.1 執行指令行公用程式

以執行 Calendar Server 的使用者和群組身份或 root 身份登入時,執行指令行公用程式。這是在安裝期間指定;預設為 icsusericsgroup

例如,如果 Calendar Server 基底目錄為 cal-svr-base,若要執行 cscal 公用程式的 list 指令,您需要在登入後執行以下指令:

cd cal-svr-base/SUNWics5/cal/sbin
./cscal list

D.1.1 指令行公用程式的語法

Calendar Server 指令行公用程式使用以下語法︰

utility [ -option [value]] command [target]

其中:

utility 為公用程式的可執行名稱,例如 cscalcsuser

option 決定指令所執行的動作。選項為小寫且前面帶有連字符 (-),例如 -d。括號 ([]) 中的選項是可選擇的。如果指明,則可同時使用兩個或多個選項。

value 進一步限定 option 指定的動作,例如與 -d 選項配合使用的說明。括號 ([]) 中的值是可選擇的。包含空格的值必須置於引號 ("") 中。多個值必須置於引號 ("") 中,且各值之間必須以空格分隔,除非另有指示,例如使用以分號分隔的清單。

command 為公用程式執行的動作,例如 listcreate。以垂直線 (|) 分隔的指令指示可同時使用任一指令,而不是一起使用這兩個指令。

target 為指令在其上生效的物件,例如行事曆 ID 或使用者 ID。

D.1.2 指令行公用程式的使用規則

以下規則為指令行公用程式的一般用法指導原則︰

D.1.3 程序檔中的回覆碼

如果您從程序檔執行指令行公用程式,則當公用程式執行成功時,回覆碼為 "0",失敗時則為 "-1"

D.2 指令行公用程式的簡短說明

下表提供 Calendar Server 指令行公用程式的簡短說明。

表 D–1 Calendar Server 指令行公用程式摘要

公用程式 

說明 

D.3 csattribute

針對 Schema 1 管理行事曆使用者或資源的 LDAP 屬性。 

D.4 csbackup

備份個別行事曆、使用者以及行事曆資料庫。 

D.5 cscal

管理行事曆及其特性。 

D.6 csclean

移除其狀態屬性 (inetUserStatus) 已被 Delegated Administrator 標記為「已刪除」的 Calendar Server 使用者的使用者行事曆和資源行事曆。 

D.7 cscomponents

管理行事曆元件︰事件和工作 (待辦事項)。 

D.8 csdb

管理行事曆資料庫。 

D.9 csdomain

針對 Schema 1 管理網域 LDAP 項目中的 Calendar Server 屬性。 

D.10 csexport

以 iCalendar (.ics) 或 XML (.xml) 格式匯出行事曆。

D.11 csimport

以 iCalendar (.ics) 或 XML (.xml) 格式匯出行事曆。

D.13 cspurge

允許手動清除刪除記錄資料庫 (ics50deletelog.db) 中的項目。

D.14 csrename

允許重新命名使用者 ID。導致整個資料庫被重寫。 

D.15 csresource

管理行事曆資源,如會議室和設備。 

D.16 csrestore

復原個別行事曆、使用者以及行事曆資料庫。 

D.17 csschedule

管理群組排程引擎 (GSE) 佇列中的排程項目。 

D.18 csstats

顯示 Calendar Server 中的計數器。 

D.19 csuser

管理 Schema 1 的行事曆使用者。 

D.20 start-cal

啟動所有 Calendar Server 程序。 

D.21 stop-cal

停止所有 Calendar Server 程序。 

D.3 csattribute

csattribute 公用程式只適用於 Schema 1 模式。它會管理 Calendar Server 使用者或資源 LDAP 項目屬性。指令包括︰


備註 –

如果您的網站使用的是 LDAP CLD 外掛程式,請勿在嘗試指定新的後端主機伺服器時使用 csattribute 變更 icsDWPHost 屬性。修改 icsDWPHost 不會在新的後端主機上建立新的行事曆。如需更多資訊,請參閱第 5 章, 在 Calendar Server 版本 6.3 中,將行事曆資料庫配置為分布在多台機器上


D.3.1 需求

D.3.2 語法


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 公用程式指令選項

選項 

說明 

-v

在詳細模式下執行:顯示有關正在執行的指令之所有可用資訊。預設為關閉。 

-q

在無訊息模式下執行: 

  • 如果作業成功,則不顯示任何資訊 (如果發生錯誤,則會顯示錯誤資訊)。

  • 不顯示危險指令的確認提示。

    預設為關閉。

-a attribute = value

或 

-a attribute [= value ]

LDAP 屬性和值︰ 

  • 使用 -a 選項時,attribute 是必需的。

  • -a 選項與 add 指令配合使用時,value 是必需的;但是,當 -a 選項與 delete 和 list 指令配合使用時,其為選擇性的。

-t user | resource

目標類型 (使用者或資源物件)。預設為使用者。 

[-d domain]

指定網域的名稱。預設使用 ics.conf 檔案中 service.defaultdomain 參數的值。

D.3.3 範例

D.4 csbackup

csbackup 公用程式可備份行事曆資料庫、指定的行事曆或使用者的預設行事曆。指令包括︰

位於指定備份目錄中的 caldb.conf 版本檔案顯示已備份資料庫的版本編號。

如需有關 csrestore 的資訊,請參閱D.16 csrestore

D.4.1 需求

D.4.2 語法


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 資料

D.4.3 範例

D.5 cscal

cscal 公用程式可管理行事曆及其特性。指令包括︰

D.5.1 需求

D.5.2 語法


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

其他行事曆所有者。多位所有者必須置於引號 ("") 中,並以空格分隔。預設為無其他所有者。

D.5.3 在後端機器上建立行事曆時可能發生的問題

若嘗試在指定的後端機器上建立行事曆,並收到以下錯誤訊息:[無效的 DWP 主機伺服器]。則表示出現以下兩種狀況之一。可能是您的伺服器配置錯誤,或已將行事曆所有者指定給其他後端伺服器。

D.5.3.1 後端機器配置錯誤

查詢 ics.conf 檔案以找出有問題的後端伺服器。確認存在下列設定:

service.dwp.enable = "yes"
caldb.cld.type = "directory"
local.hostname = "back-end hostname"

D.5.3.2 將行事曆所有者指定給其他後端機器

查詢使用者的 LDAP 項目,看是否存在 icsDWPHost 屬性。icsDWPHost 的值必須符合您嘗試建立行事曆所在的後端伺服器的名稱。您無法在其他後端伺服器上建立這個使用者的行事曆。

D.5.4 範例

D.6 csclean

csclean 公用程式只適用於 Schema 2 模式。它可移除其狀態屬性 (icsStatus) 已被 Delegated Administrator 標記為「已刪除」之使用者的使用者行事曆和資源行事曆。

對於 Schema 1,請使用 csusercscal 來移除已刪除之使用者的所有行事曆。

D.6.1 需求

D.6.2 語法


csclean [-q | -v] 
        [-g graceperiod]
        clean domain

下表說明 csclean 公用程式指令選項。

表 D–8 csclean 公用程式指令選項

選項 

說明 

-q

在無訊息模式下執行: 

  • 如果作業成功,則不顯示任何資訊 (如果發生錯誤,則會顯示錯誤資訊)。

  • 不顯示危險指令的確認提示。

    預設為關閉。

-v

在詳細模式下執行:顯示有關正在執行的指令之所有可用資訊。預設為關閉。 

-g graceperiod

指定為使用者刪除行事曆服務以後經過的天數。 

預設為 10 天。 

domain

指定要在其中移除所有使用者和資源之行事曆的網域。 

星號 (*) 可移除所有網域中的所有使用者和資源的所有行事曆。

D.6.3 範例

D.7 cscomponents

cscomponents 公用程式可管理行事曆元件︰事件和工作 (待辦事項)。指令包括︰

D.7.1 需求

D.7.2 語法


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 公用程式指令選項

選項 

說明 

-v

在詳細模式下執行:顯示有關正在執行的指令之所有可用資訊。預設為關閉。 

-q

在無訊息模式下執行: 

  • 如果作業成功,則不顯示任何資訊 (如果發生錯誤,則會顯示錯誤資訊)。

  • 不顯示危險指令的確認提示。

    預設為關閉。

-e endtime

元件的結束時間。結束時間為 0 表示不限制結束時間。預設為 0

-s starttime

元件的起始時間。起始時間為 0 表示不限制起始時間。預設為 0

-t event|task

在其上執行動作之元件 (事件或工作) 的類型。預設為兩者。 

D.7.3 範例

D.8 csdb

csdb 公用程式可管理行事曆資料庫 (行事曆、階段作業和統計)。指令包括︰

D.8.1 需求

D.8.2 語法


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 公用程式指令選項

選項 

說明 

-a

僅用於 rebuild 指令,僅重建警示資料庫。

-V

必須使用重建警示資料庫的 -a 傳送。將驗證所有資料庫 (包括警示資料庫)。

-v

在詳細模式下執行:顯示有關正在執行的指令之所有可用資訊。預設為關閉。 

-q

在無訊息模式下執行: 

  • 如果作業成功,則不顯示任何資訊 (如果發生錯誤,則會顯示錯誤資訊)。

  • 不顯示危險指令的確認提示。

    預設為關閉。

-f

強制回復行事曆資料庫。 

-g

對於 rebuild 指令,除其他行事曆資料庫之外,還可重建群組排程引擎 (group scheduling engine, GSE) 資料庫。

-t caldb|sessdb|statdb

指定目標資料庫群組: 

  • caldb (行事曆)

  • sessdb (階段作業)

  • statdb (統計)

    注意:如果未指定 -tcsdb 將在所有資料庫群組上作業,但 checkrecoverrebuild 指令除外,它們僅在 caldb (行事曆) 上作業。

D.8.3 範例

D.9 csdomain

csdomain 公用程式可管理網域 LDAP 項目中的 Calendar Server 屬性。這些屬性是 icsCalendarDomain 物件類別的一部分。指令包括︰

D.9.1 需求

D.9.2 語法


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 指令,如下所示︰ 

  • 對於 LDAP Schema 1 – 指定在其下建立所有使用者和資源的節點。例如:o=node2,o=node1,o=sesta

  • 對於 LDAP Schema 2 – 指定為此網域建立之節點的名稱。例如:o=west.sesta.com

    如果未指定節點,則使用網域名稱。

domain

對於 add、delete 和 list 指令,指定 LDAP 目錄中的現有網域。 

對於 create 指令,指定將要在 LDAP 目錄中建立之新網域的唯一名稱。 

例如:west.sesta.com

D.9.3 LDAP 屬性和特性名稱

下表說明適用於 csdomain 公用程式的 LDAP 屬性和特性名稱。這些屬性是 icsCalendarDomain 物件類別的一部分。增加或刪除值時,您必須使用特性名稱,而不是屬性名稱。

如果您使用 csdomain 增加或更新網域 LDAP 屬性,請重新啟動 Calendar Server 以使新值生效。

D.9.3.1 icsAllowRights 屬性:csdomain 公用程式

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 目錄屬性和特性

位元 

特性名稱 

說明 

allowCalendarCreation

如果設定 (位元 0 = 1),則不允許建立行事曆。 

對應的 ics.conf 參數為︰

service.wcap.allowcreatecalendars

allowCalendarDeletion

如果設定 (位元 1 = 1),則不允許刪除行事曆。 

對應的 ics.conf 參數為︰

service.wcap.allowdeletecalendars

allowPublicWritableCalendars

如果設定 (位元 2 = 1),則不允許公用的可寫入行事曆。 

對應的 ics.conf 參數為︰

service.wcap.allowpublicwriteablecalendars

 

在目前發行版本中不使用。 

allowModifyUserPreferences

如果設定 (位元 4 = 1),則不允許網域管理員使用 WCAP 指令取得或設定使用者喜好設定。 

對應的 ics.conf 參數為:

service.admin.calmaster.wcap.allowgetmodifyuserprefs

allowModifyPassword

如果設定 (位元 5 = 1),則不允許使用者經由此伺服器變更密碼。 

對應的 ics.conf 參數為︰

service.wcap.allowchangepassword

 

在目前發行版本中不使用。 

 

在目前發行版本中不使用。 

allowUserDoubleBook

如果設定 (位元 8 = 1),則不允許使用者行事曆的雙預定。 

對應的 ics.conf 參數為︰

user.allow.doublebook

allowResourceDoubleBook

如果設定 (位元 9 = 1),則不允許資源行事曆的雙預定。 

對應的 ics.conf 參數為︰

resource.allow.doublebook

10 

allowSetCn

如果設定 (位元 10 = 1),則不允許使用者使用 WCAP set_userprefs 指令設定一般名稱 (common name, 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 指令設定郵件屬性。

對應的 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 指令設定姓氏 (surname, sn) 屬性。

對應的 ics.conf 參數為︰

service.wcap.allowsetprefs.sn

15–31 

 

在目前發行版本中不使用。 

D.9.3.2 icsExtendedDomainPrefs 屬性:csdomain 公用程式

下表說明可以使用 csdomain 公用程式設定的 icsExtendedDomainPrefs 屬性和特性。每個特性均具有對應的 ics.conf 參數。如果未設定特性 (例如,值 = 0service.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 (無預設值)

D.9.3.3 其他 LDAP 目錄屬性:csdomain 公用程式

下表說明可使用 csdomain 公用程式設定的其他 LDAP 屬性和特性。

表 D–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 的狀態︰ 

  • active – Calendar Server 可以存取。

  • inactive – Calendar Server 不可以存取。行事曆保留在資料庫中,並且 Calendar Server LDAP 屬性保持不變。

  • deleted – 無法存取 Calendar Server,因為人員被標記為已刪除。

  • removed – 行事曆已從行事曆資料庫中移除。

    如果已設定 icsStatus,其值將置換 icsAllowedServiceAccess 屬性。

    如果未設定 icsStatus,Calendar Server 將使用 icsAllowedServiceAccess 屬性。

icsTimezone

timezone

指定預設時區 ID。例如,America/New_York 或 Asia/Tokyo。 

如需所支援時區的資訊,請參閱 timezones.ics 檔案。

D.9.4 範例

D.10 csexport

csexport 公用程式可將行事曆匯出至 iCalendar (.ics) 或 XML (.xml) 格式的檔案。指令包括︰

D.10.1 需求

D.10.2 語法


csexport [-v|-q]
         -c calid
         calendar outputfile

下表說明 csexport 公用程式可用的指令。

表 D–18 csexport 公用程式指令

指令 

說明 

calendar outputfile

將行事曆匯出至指定的輸出檔案。檔案的資料格式由指定的檔案副檔名決定︰ 

  • .ics 為 iCalendar (text/calendar) 格式

  • .xml 為 XML (text/xml) 格式

version

顯示公用程式的版本。 

下表說明 csexport 公用程式指令選項。

表 D–19 csexport 公用程式指令選項

選項 

說明 

-v

在詳細模式下執行:顯示有關正在執行的指令之所有可用資訊。預設為關閉。 

-q

在無訊息模式下執行: 

  • 如果作業成功,則不顯示任何資訊 (如果發生錯誤,則會顯示錯誤資訊)。

  • 不顯示危險指令的確認提示。

    預設為關閉。

-c calid

要匯出的行事曆之行事曆 ID。此選項需要與 calendar 指令一起使用。無預設值。 

D.10.3 範例

D.11 csimport

csimport 公用程式可從使用 csexport 公用程式儲存的 iCalendar (ics) 或 XML 格式的檔案匯入行事曆。指令包括︰

匯入行事曆元件的日期計算會使用與該元件關聯的 X-NSCP-DTSTART-TZID 中指定的時區。如果沒有指定的時區,則使用 ics.conf 中的伺服器時區。

D.11.1 需求

D.11.2 語法


csimport [-v|-q]
          -c calid
         calendar inputfile

下表說明 csimport 公用程式可用的指令。

表 D–20 csimport 公用程式指令

指令 

說明 

calendar inputfile

從指定的輸入檔案匯入行事曆。檔案的資料格式由檔案副檔名決定︰ 

  • .ics 為 iCalendar (text/calendar) 格式

  • .xml 為 XML (text/xml) 格式

version

顯示公用程式的版本。 

下表說明 csimport 公用程式指令選項。

表 D–21 csimport 公用程式指令選項

選項 

說明 

-v

在詳細模式下執行:顯示有關正在執行的指令之所有可用資訊。預設為關閉。 

-q

在無訊息模式下執行: 

  • 如果作業成功,則不顯示任何資訊 (如果發生錯誤,則會顯示錯誤資訊)。

  • 不顯示危險指令的確認提示。

    預設為關閉。

-c calid

要匯入的行事曆之行事曆 ID。此選項需要與 calendar 指令一起使用。 

如果指定的行事曆 ID 已經存在,則匯入的資料將併入目前行事曆。無預設值。 

如需更多資訊,請參閱15.2 建立行事曆唯一識別碼 (calid)

D.11.3 範例

D.12 csplugin

csplugin 可管理為 Calendar Server 安裝所配置的 CSAPI 外掛程式。指令包括︰

D.12.1 需求

D.12.2 語法


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 公用程式指令選項

選項 

說明 

-v

在詳細模式下執行:顯示有關正在執行的指令之所有可用資訊。預設為關閉。 

-q

在無訊息模式下執行: 

  • 如果作業成功,則不顯示任何資訊 (如果發生錯誤,則會顯示錯誤資訊)。

  • 不顯示危險指令的確認提示。

    預設為關閉。

-r

與 activate 指令配合使用時,可將外掛程式實體複製到 Calendar Server plugin 目錄中。

與 deactivate 指令配合使用時,可從 plugin 目錄刪除外掛程式。

-t type

指定的以下支援的外掛程式類型之一︰ 

  • ac— 強化或置換預設群組排程存取控制機制。

  • attr— 強化或置換儲存與擷取使用者屬性的機制。

  • auth— 強化或置換登入認證機制。

  • locate— 擷取指定的合格 URL 之行事曆 ID。

  • lookup— 強化或置換預設行事曆查找機制。

  • xlate— 強化或置換內送和外寄資料的格式轉換。

D.12.3 範例

D.13 cspurge

cspurge 公用程式允許手動清除刪除記錄資料庫 (ics50deletelog.db) 中的項目。

D.13.1 需求

D.13.2 語法


cspurge [-q|-v] 
        -e endtime 
        -s starttime

下表說明 cspurge 公用程式指令選項。

表 D–24 cspurge 公用程式指令選項

選項 

說明 

-v

在詳細模式下執行:顯示有關正在執行的指令之所有可用資訊。預設為關閉。 

-q

在無訊息模式下執行: 

  • 如果作業成功,則不顯示任何資訊 (如果發生錯誤,則會顯示錯誤資訊)。

  • 不顯示危險指令的確認提示。

    預設為關閉。

-e endtime

指定 GMT (亦稱為 UTC 或祖魯) 格式的結束時間。此值最大為 (小於) 指定時間。 

預設為 0,表示不限制結束時間。 

-s starttime

指定 GMT (亦稱為 UTC 或祖魯) 格式的起始時間。此值包含 (大於或等於) 指定時間。 

預設為 0,表示不限制起始時間。 

D.13.3 範例

D.14 csrename

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

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

cal-svr-base /SUNWics5/cal/sbin

D.14.1 需求

執行 csrename 之前,您必須首先:

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

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

D.14.2 語法

請使用以下語法執行 csrename


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

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

表 D–25 csrename 的選項

選項 

說明 

-t DestinationDB

指定 csrename 產生具有所轉換使用者名稱之新資料庫的目標目錄。預設為 MigratedDBcsrename 完成後,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。

D.14.3 範例

D.15 csresource

csresource 公用程式可建立並管理 LDAP 項目和資源 (如會議室或設備) 的行事曆。(csresource 公用程式僅可用於與資源關聯的行事曆;如果針對使用者的行事曆發出此公用程式,則會傳回錯誤。)指令包括︰

D.15.1 需求

D.15.2 語法


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

指定網域的名稱。預設使用 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.siteadmin.userid 的值。

-y otherowners

其他所有者。必須將多位所有者置於引號 (" ") 中,並以空格分隔。預設為無其他所有者。

version

顯示公用程式的版本。 

D.15.3 範例

D.16 csrestore

csrestore 公用程式可復原使用 csbackupcsexport 儲存的行事曆資料庫、指定的行事曆或使用者的預設行事曆。指令包括︰

位於指定備份目錄中的 caldb.conf 版本檔案會顯示已備份資料庫的版本編號。


注意 – 注意 –

Calendar Server 版本 6.3 的 csrestore 公用程式與 Calendar Server 版本 2 的 csrestore 公用程式不相容。請勿嘗試復原使用版本 2 csrestore 備份的資料,因為這可能會導致資料遺失。


D.16.1 需求


備註 –

csrestore 不在乎使用者 LDAP 項目是訂閱或本身的行事曆。您需要手動執行使用者 LDAP 項目,以在多值屬性 icsSubscribed 中取回個人行事曆。


D.16.2 語法


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 公用程式指令

指令 

說明 

database inputdir

從包含備份行事曆資料庫的指定輸入目錄或輸入檔案復原行事曆資料庫。此作業會覆寫目前行事曆資料庫的所有先前內容。 

calendar inputfile

從指定的輸入檔案復原指定的行事曆 ID。檔案的資料格式由檔案副檔名決定︰ 

  • .ics 為 iCalendar (text/calendar) 格式。

  • .xml 為 XML (text/xml) 格式。

    如果指定的行事曆 ID 已經存在,則系統在復原行事曆的資料之前會將該資料清除。

defcal inputfile

從指定的輸入檔案復原指定使用者 ID 的預設行事曆。檔案的資料格式由檔案副檔名決定︰ 

  • .ics 為 iCalendar (text/calendar) 格式。

  • .xml 為 XML (text/xml) 格式。

version

顯示公用程式的版本。 

下表說明 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)

D.16.3 範例

D.17 csschedule

csschedule 公用程式可管理儲存於群組排程引擎 (Group Scheduling Engine, GSE) 佇列中的排程項目。指令包括︰

D.17.1 需求

D.17.2 語法


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 公用程式指令選項

選項 

說明 

-v

在詳細模式下執行:顯示有關正在執行的指令之所有可用資訊。預設為關閉。 

-q

在無訊息模式下執行: 

  • 如果作業成功,則不顯示任何資訊 (如果發生錯誤,則會顯示錯誤資訊)。

  • 不顯示危險指令的確認提示。

    預設為關閉。

-c count

要列出的 GSE 佇列項目的數目。例如,如果您要檢查佇列中的十個項目,則指定 10。 

-e endtime

GSE 佇列中項目的結束時間,其中 0 表示不限制結束時間。預設為 0。 

-n sequencenumber

佇列中事件或工作的序列號碼。 

-o offset

排程時間的偏移。同時排程一個以上的項目時,偏移可唯一識別 GSE 佇列中的項目。 

-r rid

事件或待辦事項的週期性 ID (recurrence ID, RID)。RID 是以分號分隔的字串清單,可識別發生的每個週期性事件或待辦事項。

-s starttime

GSE 佇列中項目的起始時間,其中 0 表示不限制起始時間。預設為 0。 

-t scheduletime

排程時間,例如︰20001231T103045Z

-u uid

GSE 佇列中項目的唯一識別碼 (unique identifier, UID)。

D.17.3 範例

D.18 csstats

csstats 公用程式可顯示 Calendar Server 統計。指令包括︰

如需有關計數器的更多資訊,請參閱E.3 計數器配置 (counter.conf) 檔案

D.18.1 需求

D.18.2 語法


csstats [-q|v] 
        [-r registry] 
        [-i iterations] 
        [-s delay] 
        list [subsystem] 

下表說明 csstats 公用程式可用的指令。

表 D–32 csstats 公用程式指令

指令 

說明 

list [subsystem]

列出有關指定 Calendar Server 子系統的計數器統計資料。如果未指定子系統,則顯示有關可用子系統的基本資訊,包括︰ 

  • alarm — 服務警示通知監視

  • auth — 登入認證

  • db — 行事曆資料庫

  • disk — 磁碟使用率監視

  • gse — 群組排程引擎 (Group Scheduling Engine, GSE)

  • http — HTTP 傳輸

  • response — 伺服器回應次數

  • sess — 伺服器階段作業狀態

  • wcap — Web 行事曆存取協定

Version

顯示公用程式的版本。 

下表說明 csstats 公用程式指令選項。

表 D–33 csstats 公用程式指令選項

選項 

說明 

-v

在詳細模式下執行:顯示有關正在執行的指令之所有可用資訊。預設為關閉。 

-q

在無訊息模式下執行: 

  • 如果作業成功,則不顯示任何資訊 (如果發生錯誤,則會顯示錯誤資訊)。

  • 不顯示危險指令的確認提示。

    預設為關閉。

-i iterations

重複統計資料查找的次數。預設為 1。 

-r registry

儲存計數器統計資料的檔案之名稱和位置。預設為: 

/opt/SUNWics5/cal/lib/counter/counter

-s delay

顯示每個統計資料查找之前等待的時間 (以秒為單位)。預設為 1 秒。 

D.18.3 範例

D.19 csuser

csuser 公用程式僅適用於 Schema 1 模式。它會管理行事曆使用者的 LDAP 項目及使用者的預設行事曆。指令包括︰


備註 –

此公用程式無法讓使用者獲得 Communications Express 要求的通訊錄。要使用通訊錄,須藉由 ldapmodify 手動完成。


如果您使用的是 Directory Server,則還可以使用 ldapsearchldapmodify 公用程式。如需有關這些公用程式的資訊,請參閱以下網站上的 Directory Server 文件:

http://docs.sun.com/coll/1316.2

D.19.1 需求

D.19.2 語法


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 (物件類別)、icsSubscribedicsCalendarOwnedicsCalendaricsDWPHost) 中移除 (如果使用者在 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

指定網域的名稱。預設使用 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 格式的詳細資訊,請參閱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

是否允許使用者行事曆的雙預定。如果是,則使用者的行事曆可以為同一時段排程多個的事件。

預設使用 ics.conf 檔案中所定義之設定 user.allow.doublebook 的值。

-l [langcode]

語言代碼。預設為 ics.conflocal.sitelanguage 的值。

-m email address

指定使用者的 LDAP mail 屬性 (主要電子郵件位址)。 

-s surname

使用者的 LDAP 姓氏 (姓)。此選項是必需的。無預設值。 

D.19.3 範例


備註 –

此指令可防止 jsmith@sesta.com 登入 Calendar Server 以存取行事曆資料,但不會從行事曆資料庫中刪除 jsmith 的資料。如果 jsmith 目前已登入 Calendar Server,則他仍可存取行事曆資料,直至其登出。


D.20 start-cal

start-cal 公用程式按照以下順序啟動 Calendar Server 服務:

D.20.1 需求

D.20.2 語法

start-cal

D.20.3 範例

cal-svr-base/SUNWics5/cal/sbin/start-cal

如需更多資訊,請參閱12.1 啟動與停止 Calendar Server 6.3 程序

D.21 stop-cal

stop-cal 公用程式可停止所有 Calendar Server 服務。

D.21.1 需求

D.21.2 語法

stop-cal

D.21.3 範例

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

如需更多資訊,請參閱12.1 啟動與停止 Calendar Server 6.3 程序

附錄 E Calendar Server 配置參數

Calendar Server 配置參數儲存在配置檔案 (包括 ics.confcounter.conf) 中。

本章提供以下資訊︰

E.1 編輯 ics.conf 配置檔案

Calendar Server 配置參數儲存在以下檔案中︰

/etc/opt/SUNWics5/config/ics.conf

ics.conf 檔案為 ASCII 文字檔案,每行定義一個參數及其關聯值。這些參數在 Calendar Server 安裝期間初始化。安裝之後,您可以使用文字編輯器編輯該檔案。


注意 – 注意 –

僅能依 Sun 文件的說明或用戶支援代表的指導來修改 ics.conf 檔案中參數的設定。

例如:Calendar Server 不啟用遠端管理。請勿變更 service.admin.port 參數,因為 Calendar Server 已將其設定為其所需的值。否則,csadmind 程序可能無法正確執行。


Procedure若要編輯 ics.conf 檔案︰

  1. 以使用者身份登入,該身份具有對執行 Calendar Server 之系統的管理員權限。

  2. 移至 ics.conf 檔案所在的 /etc/opt/SUNWics5/config 目錄。

  3. 使用文字編輯器 (例如 vi) 編輯 ics.conf 檔案中的參數。參數的慣例包括︰

    • 所有參數必須僅為小寫。

      • 參數及其關聯值必須以等號 (=) 分隔,等號的前後均允許包含空格或定位點。例如:

        service.http.idletimeout = "120"

      • 參數值必須置於雙引號 (") 中。如果參數允許多個值,則整個值字串必須置於雙引號中。例如:

        calstore.calendar.owner.acl=
        "@@o^a^rsf^g;@@o^c^wdeic^g"
      • 註釋行以驚嘆號 (!) 開頭。註釋行僅用於提供資訊,且被 Calendar Server 忽略。

        某些參數做為註釋發佈,以一個或兩個驚嘆號 (!!!) 開頭。若要使用此類型的參數,您必須移除驚嘆號,提供一個值 (如果需要),然後重新啟動 Calendar Server 以使參數生效。

        例如,若要使用 !!caldb.dwp.server.[hostname].ip,您必須移除驚嘆號 (!!),提供 hostname 值,然後重新啟動 Calendar Server。

      • 如果某個參數不在 ics.conf 檔案中,請將該參數及其關聯值增加至該檔案。

      • 如果參數出現多次,則所列出的最後一個參數值將置換先前的值。

      • 所有選項必須從行首開始。

  4. 變更 ics.conf 檔案中的參數後,停止然後重新啟動 Calendar Server 以使新的配置值生效。

    如果願意,您也可以先停止 Calendar Server,然後再編輯 ics.conf 檔案。如需更多資訊,請參閱12.1 啟動與停止 Calendar Server 6.3 程序

E.2 配置參數 (ics.conf) 檔案

本節小列出 ics.conf 檔案中的各種配置參數。為方便起見,將它們分為以下的功能群組:


注意 – 注意 –

以下列出的參數僅顯示其預設設定。若要實作特定功能,可能需要將一或多個參數變更為不同值。請參閱第 3 部分自訂 Calendar Server 配置的中各章節說明來瞭解如何實作功能,包括使用哪些參數及將哪些值指定給它們。



備註 –

ics.conf 檔案中允許重複的參數。系統會使用檔案中參數的最後一個實例之值。


E.2.1 配置檔案自訂提示

配置檔案太大。有太多參數。如果進行自訂,則可能很難找到這些自訂內容或忘記變更值的原因。為了避免混淆,請在您針對該用途所建立的區段中,於檔案結尾增加您的自訂資訊。例如,您可以建立包含以下文字的註釋行:! 我的 ics.conf 變更。然後增加新參數或您要修改的任何參數,並增加它們的值。為每個參數增加註釋,說明變更的原因及目前的日期。如此能提供您系統的變更歷程記錄,供後續參照。

每當您啟動或重新啟動 Calendar Server 時,系統會讀取整個配置檔案。系統必須處理的參數越多,啟動系統的時間就越長。若有許多重複的參數,則可能會大幅降低處理速度。為了避免這種情況,請將過時的重複參數標記為註釋。

E.2.2 Calendar Server 本機實例配置參數

下表顯示以 local. 開頭的配置參數及每個參數的預設值和說明。

表 E–1 ics.conf 檔案中的本機伺服器實例配置參數

參數 

預設值 

說明 

local.autoprovision

"yes"

啟用 ("yes") 或停用 ("no") 使用者行事曆的自動佈建

local.domain.language

"en"

此 Calendar Server 實例中網域的預設語言。 

local.hostname

" "

安裝 Calendar Server 之機器的主機名稱。 

local.installeddir

cal-svr-base/SUNWics5/ cal

安裝 Calendar Server 的目錄路徑位置。 

local.instancedir

cal-svr-base/SUNWics5/ cal

安裝此 Calendar Server 實例之配置檔案和資料的目錄路徑位置。 

local.instance.lockdir.path

cal-svr-base/SUNWics5/ cal/data/lock

指定該伺服器實例之鎖定檔案的儲存位置。 

local.instance.counter.path

cal-svr-base/SUNWics5/ cal/lib/counter

指定該伺服器實例之計數器檔案的儲存位置。 

local.plugindir.path

" "

安裝此 Calendar Server 實例之 CSAPI 外掛程式的目錄路徑位置。 

local.rfc822header.allow8bit

"no"

允許 (y) 或不允許 (n) 在此伺服器傳送的電子郵件訊息中使用 8 位元標頭。

local.servergid

"icsgroup"

Calendar Server 檔案 (例如計數器和記錄檔) 的群組 ID (Group ID, GID)。

local.serveruid

"icsuser"

Calendar Server 檔案 (例如計數器和記錄檔) 的使用者 ID (User ID, UID)。

local.sitelanguage

"en"

此 Calendar Server 實例的預設語言。 

local.smtp.defaultdomain

" "

用於查找與電子郵件位址對應的與會者行事曆 ID 的預設網域名稱。例如,如果此設定的值為 "sesta.com",則 jsmith 解析為 jsmith@sesta.com

local.supportedlanguages

"en"

此 Calendar Server 實例支援的使用者語言。 

E.2.3 Calendar Server LDAP 授權配置參數

表 E–2 ics.conf 檔案中的 LDAP 授權配置參數

參數 

預設值 

說明 

local.authldapbasedn

" "

用於 LDAP 認證的基底 DN。如果未指定,則使用 local.ugldapbasedn

local.authldaphost

"localhost"

用於 LDAP 認證的主機。如果未指定,則使用 local.ugldaphost

local.authldapbindcred

" "

local.authldapbinddn 中指定的使用者連結憑證 (密碼)。

local.authldapbinddn

" "

用於連結 LDAP 認證主機以搜尋使用者 dn 的 DN。若未指定,或值為 " ",則為匿名連結。

local.authldapport

"389"

用於 LDAP 認證的連接埠。如果未指定,則使用 local.ugldapport

local.authldappoolsize

"1"

為 LDAP 認證所維護的 LDAP 用戶端連線的最小數目。如果未指定,則使用 local.ugldappoolsize

local.authldapmaxpool

"1024"

為 LDAP 認證所維護的 LDAP 用戶端連線的最大數目。如果未指定,則使用 local.ugldapmaxpool

E.2.4 Calendar Server LDAP 使用者和群組搜尋配置參數

表 E–3 ics.conf 檔案中的 LDAP 授權配置參數

參數 

預設值 

說明 

local.lookupldap.search.minwildcardsize

"3"

指定與會者查找搜尋中萬用字元搜尋的最小字串大小。零 (0) 表示始終進行萬用字元搜尋。 

local.ugldaphost

"localhost"

儲存 LDAP 使用者喜好設定之機器的主機名稱。 

E.2.5 Calendar Server 使用者喜好設定配置參數

表 E–4 ics.conf 檔案中的使用者喜好設定配置參數

參數 

預設值 

說明 

local.enduseradmincred

" "

用於 LDAP 使用者喜好設定認證的連結憑證 (密碼)。 

local.enduseradmindn

" "

用於連結 LDAP 使用者喜好設定主機的 DN。無預設 DN。若值為 " " 或未指定,則假定匿名連結。

local.ugldapbasedn

" "

LDAP 使用者喜好設定的基底 DN。必須指定此基底 DN,且不能為空。 

local.ugldapicsextendeduserprefs

"ceColorSet,

ceFontFace,

ceFontSizeDelta,

ceDateOrder,

ceDateSeparator,

ceClock,

ceDayHead,

ceDayTail,

ceInterval,

ceToolText,

ceToolImage,

ceDefaultAlarmStart,

ceSingleCalendarTZID,

ceAllCalendarTZIDs,

ceDefaultAlarmEmail,

ceNotifyEmail,

ceNotifyEnable,

ceDefaultView,

ceExcludeSatSun,

ceGroupInviteAll"

icsExtendedUserPrefs 屬性中選項的值。

local.user.authfilter

"uid=%u"

用於使用者查找的篩選器。 

E.2.6 Calendar Server 行事曆存放區配置參數

下表顯示行事曆存放區配置參數以及每個參數的預設值和說明。行事曆存放區保存所有事件和待辦事項記錄。

表 E–5 ics.conf 檔案中的行事曆儲存區配置參數

參數 

預設值 

說明 

calstore.anonymous.calid

"anonymous"

用於匿名登入的行事曆 ID (Calendar ID, calid)。

user.allow.doublebook

"yes"

決定建立行事曆時使用者行事曆是否可以在同一時段排程多個事件︰ 

  • "no" 不允許雙預定。

  • "yes" 允許雙預定。

calstore.calendar.default.acl

"@@o^a^r^g;
@@o^c^wdeic^g;
@^a^fs^g;
@^c^^g;
@^p^r^g"

指定使用者建立行事曆時所使用的預設存取控制權限。格式由以分號分隔的存取控制項目 (ACE) 引數字串的清單指定。 

如需有關 ACE 格式的詳細資訊,請參閱15.4 Calendar 存取控制

若要使用指令行公用程式為一個或多個行事曆指定存取控制項目,請參閱D.5 cscal

calstore.calendar.owner.acl

"@@o^a^rsf^g;
@@o^c^wdeic^g"

指定行事曆所有者的預設存取控制設定。 

calstore.calendar.create.

lowercase

"no"

指定在建立新行事曆或使用 LDAP CLD 外掛程式查找行事曆時,Calendar Server 是否應將行事曆 ID (calid) 轉換為小寫。

calstore.default.timezoneID

"America/
New_York"

出現以下情況時要使用的時區 ID︰ 

  • 未提供時區 ID

  • 找不到行事曆時區 ID

  • 找不到使用者時區 ID

    無效值會導致伺服器使用 GMT (格林威治標準時間) 時區。

calstore.filterprivateevents

"yes"

指定 Calendar Server 是否篩選 (識別) 私人和只有時間與日期 (機密) 的事件和工作。如果為 "no",則 Calendar Server 將它們視為公開事件和工作。

calstore.freebusy.include.

defaultcalendar

"yes"

指定使用者的預設行事曆是否包含在使用者的空閒/忙碌行事曆清單中。 

calstore.freebusy.remove.

defaultcalendar

"no"

指定是否可以從使用者的空閒/忙碌行事曆清單中移除使用者的預設行事曆。 

calstore.group.attendee.maxsize

"0"

展開用於邀請的 LDAP 群組的大小上限。值 "0" 表示展開群組,而無大小限制。值 -1 表示不允許展開 LDAP 群組。

calstore.recurrence.bound

"60"

可由週期性擴充建立之事件的最大數目。 

calstore.subscribed.include.

defaultcalendar

"yes"

指定使用者的預設行事曆是否包含在使用者的訂閱行事曆清單中。 

calstore.subscribed.remove.

defaultcalendar

"no"

指定是否可以從使用者的訂閱行事曆清單中移除使用者的預設行事曆。 

calstore.userlookup.maxsize

"200"

從使用者搜尋的 LDAP 查找傳回之結果的最大數目。值 "0" 表示無限制。

calstore.unqualifiedattendee.

fmt1.type

"uid"

為事件的與會者執行目錄查找時,指定 Calendar Server 如何處理字串,如 jdoejdoe:tv。允許值為︰uidcn gidresmailtocap

calstore.unqualifiedattendee.

fmt2.type

"mailto"

為事件的與會者執行目錄查找時,指定 Calendar Server 如何處理帶有 at 符號 (@) 的字串,如 jdoe@sesta.com。允許值為︰uidcngidresmailtocap

calstore.unqualifiedattendee.

fmt3.type

"cn"

為事件的與會者執行目錄查找時,指定 Calendar Server 如何處理帶有空格的字串,如 john doe。允許值為︰uidcn gidrescap

store.partition.primary.path

"."

儲存行事曆資訊之主磁碟分割區的位置。 

E.2.7 行事曆記錄資訊配置參數

下表顯示行事曆記錄配置參數以及每個參數的預設值和說明。

表 E–6 ics.conf 檔案中的行事曆記錄配置參數

參數 

預設值 

說明 

logfile.admin.logname .

"admin.log"

用於記錄管理工具之記錄檔的名稱。 

logfile.buffersize

"0"

記錄緩衝區的大小,以位元組為單位。 

logfile.dwp.logname

"dwp.log"

用於記錄與資料庫連線協定相關的管理工具的記錄檔之名稱。 

logfile.expirytime

"604800"

記錄檔過期之前的秒數。 

logfile.flushinterval

"60"

清除記錄檔緩衝區的間隔秒數。 

logfile.http.access.logname

"httpd.access"

目前存取記錄檔的名稱。 

logfile.http.logname

"http.log"

cshttpd 服務的目前記錄檔名稱。

logfile.http.access.

logname

"httpd.access"

目前 HTTP 存取記錄檔的名稱。 

logfile.logdir

"logs"

記錄檔的目錄位置。 

logfile.loglevel

"NOTICE"

決定伺服器將記錄的詳細資訊層級。每個記錄項目均被指定以下層級之一︰CRITICALALERTERRORWARNINGNOTICEINFORMATIONDEBUG

logfile.maxlogfiles

"10"

記錄目錄中記錄檔的最大數目。 

logfile.maxlogfilesize

"2097152"

每個記錄檔的最大大小 (以位元組為單位)。 

logfile.maxlogsize

"20971520"

用於儲存所有記錄檔的最大磁碟空間 (以位元組為單位)。 

logfile.minfree

diskspace

"5242880"

必須可用於記錄的最小可用磁碟空間 (以位元組為單位)。 

logfile.notify.logname

"notify.log"

csnotifyd 服務的記錄檔名稱。

logfile.rollovertime

"86400"

旋轉記錄檔之前的秒數。 

logfile.store.logname

"store.log"

儲存記錄檔名稱。 

service.http.commandlog

"no"

此參數僅適用於除錯。若設為 "yes",系統會將所有傳入的指令記錄到 http.commands 記錄檔。

請勿在生產執行階段使用此參數。它會很快地填入記錄檔,並可能導致效能降低。 

E.2.8 Calendar Server 管理員配置參數

下表列出適合管理員的 ics.conf 參數。

表 E–7 管理員的配置參數

參數 

預設值 

說明 

service.siteadmin.

cred

" "

被指定為 Calendar Server 管理員之使用者 ID 的密碼。此值在安裝時提供,而且是安裝程式所必需的。 

service.siteadmin.

userid

"calmaster"

被指定為 Calendar Server 管理員之人員的使用者 ID。此值在安裝時提供,而且是安裝程式所必需的。 

service.admin.calmaster.

overrides.accesscontrol

"no"

指示 Calendar Server 管理員是否可以置換存取控制。 

service.admin.calmaster.

wcap.allowgetmodify

userprefs

"no"

指示 Calendar Server 管理員是否可以使用 WCAP 指令取得和設定使用者喜好設定。 

service.admin.ldap.enable

"yes"

如果為 "yes",則為 service.siteadmin.userid 中所指定之使用者的使用者認證啟用 LDAP。

E.2.9 Calendar Server 服務配置

下表顯示各種服務配置參數以及每個參數的預設值和說明。

表 E–8 ics.conf 檔案中的服務配置參數

參數 

預設值 

說明 

service.admin.alarm

"yes"

啟用 ("yes") 或停用 ("no") 管理工具的警示通知。

local.store.

checkpoint.enable

"yes"

如果為 "yes",則啟動 csadmind 資料庫檢查點執行緒。

service.admin.

dbcachesize

"8388608"

用於管理階段作業之 Berkeley 資料庫的最大快取記憶體大小 (以位元組為單位)。 

local.store.

deadlock.enable

"yes"

如果為 "yes",則啟動 csadmind 資料庫死結偵測執行緒。

service.admin.

diskusage

"no"

如果為 "yes",則啟動 csadmind 低磁碟空間監視執行緒。

service.admin.enable

"yes"

如果為 "yes",則在啟動所有服務時啟動 csadmind 服務,並在停止所有服務時停止 csadmind

service.admin.

idletimeout

"120"

使 HTTP 連線在 csadmind 中逾時之前的秒數。

service.admin.

maxsessions

"100"

所允許的管理階段作業的最大數目。 

service.admin.

maxthreads

"10"

每個管理階段作業的執行中執行緒的最大數目。 

service.admin.

numprocesses

不適用 

所允許的同步運作之管理程序的最大數目。 

service.admin.port

不適用 

**CAUTION** 

由系統設定。請勿變更。 

service.admin.

resourcetimeout

"900"

使管理連線逾時之前的秒數。 

service.admin.

serverresponse

"no"

如果為 "yes",則啟動 csadmind 服務回應執行緒。

service.admin.

sessiondir.path

" "

管理階段作業請求的暫存目錄。 

service.admin.

sessiontimeout

"1800"

使 HTTP 階段作業在 csadmind 中逾時之前的秒數。

service.admin.

sleeptime

"2"

在檢查已啟動、已停止或準備好的行事曆服務之間等待的秒數。 

service.admin.

starttime

"300"

任一行事曆服務啟動之前需要等待的秒數。 

service.admin.

stoptime

"300"

任一行事曆服務停止之前需要等待的秒數。 

service.admin.

stoptime.next

"60"

在向任一行事曆服務傳送 stop 指令之間等待的秒數。 

service.dcroot

"o=internet"

該目錄中 DC 樹狀結構的根尾碼。 

service.

dnsresolveclient

"no"

如果為 "yes",則會根據 DNS 檢查用戶端 IP 位址 (如果允許 HTTP 存取)。

service.plaintext

loginpause

"0"

使用一般文字密碼成功認證使用者後延遲的秒數。 

service.http.admins

"calmaster"

以空格分隔的對此 Calendar Server 具有管理權限的使用者 ID 清單。 

service.http.

allowadminproxy

"yes"

如果為 "yes",則允許經由代理登入。

service.http.

allowanonymouslogin

"yes"

如果為 "yes",則允許匿名 (無認證) 存取。這是特殊類型的登入,只允許指定的受限制的存取 (通常僅讀取對公開行事曆的存取)。

service.http

.calendarhostname

"" (Null)

用於擷取 HTML 文件的 HTTP 主機。 

service.http.cookies

"yes"

告知伺服器是否支援 cookie。必須設定為 "yes" 才能啟用單次登入。

service.http.

dbcachesize

"8388608"

用於 HTTP 階段作業之 Berkeley 資料庫的最大快取記憶體大小。 

service.http.

domainallowed

"" (Null)

如果已指定且不為 "",則會進行篩選以允許基於 TCP 網域的存取。例如,"ALL: LOCAL.sesta.com" 將允許對 sesta.com 網域中的任何人進行本機 HTTP 存取。多個篩選器由 CR-LF (換行) 分隔。

service.http.

domainnotallowed

"" (Null)

如果已指定且不為 " ",則會進行篩選以拒絕基於 TCP 網域的存取。例如,"ALL:LOCAL.sesta.com" 將拒絕對 sesta.com 網域中的任何人進行 HTTP 存取。多個篩選器必須由 CR-LF (換行) 分隔。

service.http.

attachdir.path

"."

與暫時儲存匯入檔案之 local.queuedir 相對的目錄位置 (或指定的絕對路徑)。

service.http.

ipsecurity

"yes"

如果為 "yes",則參照現有階段作業的所有請求均被驗證為來源於同一 IP 位址。 

service.http.enable

"yes"

如果為 "yes",則在啟動所有服務時啟動 cshttpd 服務,並在停止所有服務時停止 cshttpd

service.http.

idletimeout

"120"

使 HTTP 連線逾時之前的秒數。 

service.http.

ldap.enable

"yes"

如果為 "yes",則建立並維護用於認證和使用者喜好設定的 LDAP 連線。 

service.http.listenaddr

"INADDR_ANY"

指定 HTTP 服務將為用戶端請求偵聽的 TCP 位址。"INADDR_ANY" 指示任一位址。

service.http.logaccess

"no"

如果為 "yes",則完全記錄至伺服器的 HTTP 連線。 

service.http.

maxsessions

"5000"

cshttpd 服務中 HTTP 階段作業的最大數目。

service.http.

maxthreads

"20"

cshttpd 服務中回應 HTTP 請求之執行緒的最大數目。

service.http.

numprocesses

"1"

應在某個伺服器上同步執行的 HTTP 服務 (cshttpd) 程序的最大數目。

如需有關具有多個 CPU 的伺服器的資訊,請參閱21.8 使用跨多個 CPU 的負載平衡功能

service.http.port

"80"

來自 Calendar Server 使用者之 HTTP 請求的連接埠。 

service.http.

proxydomainallowed

""

如果已指定且不為 "",則進行篩選以允許基於 TCP 網域的代理登入。語法與 service.http.domainallowed 相同。

service.http.

resourcetimeout

"900"

使 HTTP 階段作業逾時之前的秒數。 

service.http.

sessiondir.path

"http"

HTTP 階段作業的暫存目錄。 

service.http.sessiontimeout

"1800"

使 HTTP 階段作業在 cshttpd 服務中逾時之前的秒數。

service.http.sourceurl

" "

相對於可執行檔的目錄,其中儲存檔案的所有 URL 參照。 

service.http. tmpdir

 

相對於可執行檔的目錄,其中儲存檔案的所有 URL 參照。 

預設為:/var/opt/SUNWics5/tmp

service.http.uidir.path

"html"

包含預設行事曆用戶端的目錄。如果僅允許 WCAP 存取,則設定為 ""

service.ldapmemcache

"no"

如果為 "yes",則在 LDAP SDK 中使用快取記憶體。 

service.ldapmemcachettl

"30"

service.ldapmemcache 為 "yes",則將此值傳送至 LDAP SDK。這是快取項目的最大秒數。如果為 0,則對快取項目的時間沒有限制。

service.ldapmemcachesize

"131072"

service.ldapmemcache 為 "yes",則將此值傳送至 LDAP SDK。這是快取將消耗之記憶體的最大容量 (以位元組為單位)。如果為 0,則快取記憶體無大小限制。

service.wcap.anonymous

.allowpubliccalendarwrite

"yes"

如果為 "yes",則允許匿名使用者寫入公開可寫入的行事曆。 

service.wcap.format

"text /calendar"

指定目前僅適用於 freebusy 之指令的預設輸出格式。 

service.wcap.

freebusybegin

"30"

指定基於目前時間的預設偏移天數,做為偵測 get_freebusy 的範圍開始。

service.wcap.

freebusyend

"30"

指定基於目前時間的預設偏移天數,做為偵測 get_freebusy 的範圍結束。

service.wcap.freebusy.

redirecturl

““ 

針對遷移的目的,當僅進行了部分遷移時,行事曆在來源資料庫與 Calendar Server 目標資料庫之間才會分開。如果在 Calendar Server 資料庫中找不到行事曆,則在來源資料庫的 URL 中查找。 

service.wcap.allow

createcalendars

"yes"

如果為 "yes",則允許建立行事曆。

service.wcap.allow

deletecalendars

"yes"

如果為 "yes",則允許刪除行事曆。

service.wcap.allow

changepassword

"no"

若為 "yes",則允許變更使用者密碼。

service.wcap.allow

publicwritablecalendars

"yes"

如果為 "yes",則允許使用者擁有公開可寫入行事曆。

service.wcap.allow

setprefs.cn

"no"

如果為 "yes",則允許 set_userprefs.wcap 屬性修改使用者喜好設定 cn (LDAP 使用者的一般名稱)。

service.wcap.allow

setprefs.givenname

"no"

如果為 "yes",則允許 set_userprefs.wcap 屬性修改使用者喜好設定 givenname (LDAP 使用者的名字)。

service.wcap.allow

setprefs.icsCalendar

"no"

如果為 "yes",則允許 set_userprefs.wcap 修改使用者喜好設定 icsCalendar (使用者的預設行事曆識別碼)。

service.wcap.allow

setprefs.mail

"no"

如果為 "yes",則允許 set_userprefs.wcap 屬性修改使用者喜好設定 mail (使用者的電子郵件位址)。

service.wcap.allowsetprefs.

preferredlanguage

"no"

如果為 "yes",則允許 set_userprefs.wcap 屬性修改使用者喜好設定 preferredlanguage (LDAP 使用者的喜好語言)。

service.wcap.allow

setprefs.sn

"no"

如果為 "yes",則允許 set_userprefs.wcap 屬性修改使用者喜好設定 sn (LDAP 使用者的姓氏)。

service.wcap.allow

setprefs.nswccalid

"no"

如果為 "yes",則允許 set_userprefs.wcap 屬性修改使用者喜好設定 nswccalid,即使用者的預設行事曆 ID。

service.wcap.login.

calendar.publicread

"no"

如果為 "yes",則預設使用者行事曆初始設定為公開讀取及私人寫入。如果為 "no",則預設使用者行事曆初始設定為私人讀取及寫入。

service.wcap.userprefs.

ldapproxyauth

"no"

如果為 "yes",則啟用 get_userprefs.wcap 指令的 LDAP 代理伺服器授權。如果為 "no",則執行匿名 LDAP 搜尋。

service.wcap.validateowners

"no"

如果為 "yes",則伺服器必須驗證行事曆的每個所有者均存在於目錄中 (透過 LDAP 或 CSAPI 相容的使用者目錄機制)。

service.wcap.version

"3.0"

WCAP 版本。 

E.2.10 Calendar Server SSL 配置參數

下表顯示 ics.conf SSL 配置參數以及每個參數的預設值和說明。當大多數 SSL 參數使用預設值時,有兩個參數要求您將系統預設值變更為 SSL 值,如下所示:

下表顯示 ics.conf 參數及其預設設定。驗證 ics.conf 參數是否具有適當的值:

表 E–9 SSL 的配置參數

參數 

預設值 

說明 

encryption.rsa.

nssslactivation

"on"

為 SSL 啟用 RSA 密碼加密系列服務。 

encryption.rsa.

nsssltoken

"internal"

指定 RSA 密碼加密系列記號的位置。 

encryption.rsa.

nssslpersonalityssl

"SampleSSLServerCert"

指定 RSA 密碼加密系列的證書名稱。 

service.http.tmpdir

/var/opt/SUNWis5/tmp

指定暫存目錄。 

service.http.uidir.

path

"html"

指定 UI 檔案所在的目錄。 

service.http.ssl.

cachedir

"."

指定 SSL 快取記憶體的實體路徑位置。 

service.http.ssl.

cachesize

"10000"

指定 SSL 快取記憶體資料庫的最大大小。 

service.http.ssl.

usessl

"no"

對於 SSL 配置,將此值變更為 "yes"

指定 cshttpd 程序是否應使用 SSL 子系統。

service.http.ssl.

port.enable

"no"

對於 SSL 配置,將此值變更為 “yes”。 


備註 –

此作業不會使 HTTP 程序無法偵聽其連接埠。您無法真正停用 HTTP,但可以將其指定至其他不工作的連接埠。

設定 service.http.enable="no"。因為此作業也會停用 HTTPS 程序。


service.http.ssl.

port

"443"

指定 cshttpd 程序在其上偵聽來自 Calendar Server 使用者的 HTTPS 請求的 SSL 連接埠號。

請勿將其設定為與 HTTP 所使用的預設連接埠 ("80") 相同的連接埠。

service.http.ssl.

securesession

"yes"

指定是否加密整個階段作業。 

local.ssldbpath

"/etc/opt/SUNWics5/config"

指定 SSL 證書資料庫的實體路徑位置。 

service.http.ssl.certdb.password — 已從 ics.conf 檔案移除此參數。它已被配置檔案取代。

sslpassword.com

sslpassword.conf 是文字檔案,包含憑證資料庫密碼。

此檔案由 certutil 公用程式而非 Calendar Server 使用。在下列目錄中建立 sslpassword.conf

/etc/opt/SUNWics5/config

service.http.ssl.

sourceurl

"https://localhost:443"

指定來源 URL 的 SSL 主機名稱和連接埠號。 

service.http.ssl.

ssl2.ciphers

""

指定 SSL2 的密碼。 

service.http.ssl.

ssl2.sessiontimeout

"0"

指定 SSL2 的階段作業逾時。 

service.http.ssl.

ssl3.ciphers

"rsa_rc4_40_md5,
rsa_rc2_40_md5,
rsa_des_sha,
rsa_rc4_128_md5,
rsa_3des_sha"

指定支援或有效的 SSL 密碼清單。 

service.http.ssl.

ssl3.sessiontimeout

"0"

指定 SSL 階段作業的逾時值。 

E.2.11 Calendar Server 網域配置參數

下表顯示網域配置參數及每個參數的預設值和說明。

表 E–10 用於多重網域支援的配置參數

參數 

預設值 

說明 

local.domain.language

"en"

此 Calendar Server 實例中的網域預設語言。 

local.schemaversion

"1"

指定 LDAP 模式的版本: 

  • "1" Sun LDAP Schema 1。另請參閱 service.dcroot

  • "2" Sun LDAP Schema 2。另請參閱 service.schema2root

service.dcroot

" "

指定 LDAP 目錄中的 DC 樹狀結構的根尾碼 (如果 local.schemaversion="1")。例如:"o=internet"

service.schema2root

" "

指定所有網域所在的根尾碼 (如果 local.schemaversion="2")。例如:"o=sesta.com"

service.defaultdomain

" "

指定該 Calendar Server 實例的預設網域。登入期間未提供網域名稱時使用。例如:"sesta.com"

service.loginseparator

"@+"

指定 Calendar Server 剖析 userid[login-separator]domain 時用於 login-separator 的分隔符號字串。Calendar Server 會依次嘗試每個分隔字元。

service.siteadmin.userid

" "

指定網域管理員的使用者 ID。 

service.siteadmin.cred

" "

指定網域管理員的密碼。 

service.virtualdomain.

support

"yes"

啟用 ("yes") 或停用 ("no") 多重網域的支援。


注意 – 注意 –

請勿將此參數變更為 "no"。Calendar Server 預設支援多重網域。


E.2.12 用於啟用電子郵件通知的配置參數

以下三個參數可允許或禁止系統傳送取消、邀請和回覆通知。

表 E–11 ics.conf 檔案中的警示通知配置參數

參數 

預設值 

說明 

ine.cancellation.enable

"yes"

決定是否在取消事件後將電子郵件通知傳送給與會者。 

ine.invitation.enable

"yes"

決定是否將電子郵件通知傳送給被邀請參與事件的與會者。 

ine.reply.enable

"yes"

決定是否在與會者回覆邀請時將電子郵件通知傳送給組織者。 

E.2.13 警示通知參數

下表顯示警示通知伺服器配置參數以及每個參數的預設值和說明。

表 E–12 ics.conf 檔案中的警示通知配置參數

參數 

預設值 

說明 

alarm.diskstat.

msgalarmdescription

"percentage calendar partition disk space available"

與磁碟空間不足訊息一起傳送的說明。 

alarm.diskstat.

msgalarmstatinterval

"3600"

監視磁碟空間的間隔秒數。 

alarm.diskstat.

msgalarmthreshold

"10"

觸發傳送警告訊息的可用磁碟空間百分比。 

alarm.diskstat.

msgalarmthresholddirection

"-1"

alarm.diskstat.msgalarmthreshold 是高於還是低於百分比。-1 為低於,1 為高於。

alarm.diskstat.

msgalarmwarninginterval

"24"

傳送有關磁碟空間不足警告訊息的間隔小時數。 

alarm.msgalarmnoticehost

"localhost"

用於傳送伺服器警示之 SMTP 伺服器的主機名稱。 

alarm.msgalarmnoticeport

"25"

用於傳送伺服器警示的 SMTP 連接埠。 

alarm.msgalarmnoticercpt

"Postmaster
@localhost"

將伺服器警示傳送至的電子郵件位址。 

alarm.msgalarmnoticesender

"Postmaster
@localhost"

伺服器傳送警示時用作寄件者的電子郵件位址。 

alarm.msgalarmnoticetemplate

""

用於傳送電子郵件警示的預設格式為︰ 

"From: %s\nTo: %s\nSubject: ALARM: %s of \"%s\" is n\n%s\n"

alarm.responsestat.

msgalarmdescription

"calendar service not responding"

與「無服務回應」訊息一起傳送的說明。 

alarm.responsestat.

msgalarmstatinterval

"3600"

監視服務的間隔秒數。 

alarm.responsestat.

msgalarmthreshold

"100"

如果沒有服務回應,則僅觸發傳送警告訊息。 

alarm.responsestat.

msgalarmthresholddirection

"-1"

指定 alarm.responsestat.

msgalarmthreshold 百分比是高於還是低於臨界值。

-1 表示低於,值 1 表示高於。

alarm.responsestat.

msgalarmwarninginterval

"24"

傳送發出的有關無服務回應警告訊息的間隔小時數。 

E.2.14 行事曆查找資料庫配置

下表顯示行事曆查找資料庫 (Calendar Lookup Database, CLD) 參數以及每個參數的預設值和說明。

表 E–13 ics.conf 檔案中的行事曆查找資料庫 (Calendar Lookup Database, CLD) 參數

參數 

預設值 

說明 

csapi.plugin.calendarlookup

"no"

啟用 ("yes") 或停用 ("no") 行事曆查找外掛程式。

csapi.plugin.calendarlookup.name

"*"

指定要載入的特定行事曆查找外掛程式的名稱。如果此值為星號 ("*"),則 Calendar Server 會載入所有外掛程式。

caldb.cld.type

"local"

針對所有項目皆位於同一台的機器或僅做為後端機器的機器,使用 "local"

針對僅做為前端機器的機器或同時做為前端與後端機器的機器,使用 "directory"

caldb.dwp.server.default

" "

如果 LDAP 伺服器資料庫中的使用者行事曆項目或資源行事曆項目不具有 icsDWPHost 屬性,該參數將指定 Calendar Server 所使用之完全合格的預設 DWP 伺服器名稱。

若登入 Calendar Server 的使用者的 LDAP 項目 (login.wcap ) 沒有 icsDWPHost 屬性,則 Calendar Server 會使用此參數值來增加該屬性。

如果使用者 LDAP 項目已具有 icsDWPHost 屬性,則不會使用 caldb.dwp.server.default

該名稱必須可被您的網域名稱服務 (DNS) 解析成有效的 IP 位址。 

caldb.cld.cache.enable

"yes"

啟用 ("yes") 或停用 ("no") 行事曆查找資料庫 (CLD) 的快取記憶體選項。若要獲得 LDAP CLD 外掛程式的最佳效能,請設定為 "yes"

caldb.cld.cache.logfilesizemb

"10"

指定檢查點檔案的最大大小 (以百萬位元組為單位)。 

caldb.cld.cache.mempoolsizemb

"4"

指定共用記憶體的大小 (以百萬位元組為單位)。 

caldb.cld.cache.maxthread

"1000"

指定資料庫執行緒的最大數目。 

caldb.cld.cache.homedir.path

"."

為 CLD 快取記憶體選項指定資料庫事件、工作和警示檔案的位置。預設值 "." 指定這些檔案儲存在 /var/opt/SUNWics5/csdb/cld_cache 目錄中。

caldb.cld.cache.checkpointinterval

"60"

指定檢查點之間的間隔秒數。 

caldb.cld.cache.circularlogging

"yes"

指定為 CLD 快取記憶體選項同步化檢查點檔案之後是否移除這些檔案。 

caldb.dwp.server.host-name .ip

" "

指定儲存行事曆資料庫之伺服器的主機名稱。伺服器必須在執行 DWP (csdwpd) 服務。該名稱必須可被您的網域名稱服務 (DNS) 解析成有效的 IP 位址。此參數由 LDAP CLD 外掛程式使用。 

注意:在參數的每個部分中,host-name 必須相同且完全合格。例如:

caldb.dwp.server.sesta.com.ip="sesta.com"

caldb.dwp.connthreshold

"1"

伺服器取得新網路連線之前積存請求的最大數目。 

caldb.dwp.initconns

"2"

資料庫連線協定服務用戶端連線至每個資料庫連線協定服務主機的連線初始數目。 

caldb.dwp.initthreads

"2"

處理資料庫連線協定服務請求的執行緒初始數目。 

caldb.dwp.maxcons

"1000"

使用資料庫連線協定服務的伺服器所允許的連線最大數目。 

caldb.dwp.maxthreads

"20"

使用資料庫連線協定服務的伺服器所允許的執行緒最大數目。 

caldb.dwp.md5

"no"

指定伺服器是否執行所有資料庫連線協定服務請求的 MD5 (Message Digest 5) 單向雜湊檢查。(單向雜湊功能用於建立訊息認證的數位簽名。) 

  • "no" 停用 MD5 雜湊檢查。

  • "yes" 啟用 MD5 雜湊檢查。

caldb.dwp.server.hostname.ip

" "

指定在指定機器的主機名稱中使用資料庫連線協定 (DWP) 服務之伺服器的 IP 位址。 

caldb.dwp.server.hostname.port

"59779"

指定在指定機器的主機名稱中使用資料庫連線協定 (DWP) 服務之伺服器的連接埠號。 

caldb.dwp.server.back-end-server .admin

" "

在前端伺服器上,指定用於認證後端伺服器 DWP 連線的使用者 ID,其中 back-end-server 是該伺服器的名稱。 

caldb.dwp.server.back-end-server.cred

" "

在前端伺服器上,指定用於認證後端伺服器 DWP 連線的密碼,其中 back-end-server 為該伺服器的名稱。

caldb.dwp.stacksize

"65536"

資料庫連線協定服務執行緒的堆疊大小。 

caldb.cld.directory.ldapbasedn

無 

LDAP 外掛程式用於行事曆尋找機制時要向其認證的基底 DN。 

caldb.cld.directory.ldaphost

無 

LDAP 外掛程式用於行事曆尋找機制時要存取之 LDAP 伺服器的主機名稱。 

caldb.cld.directory.ldapbindcred

無 

LDAP 外掛程式用於行事曆尋找機制時在 local.authldapbinddn 設定中指定的使用者連結憑證 (密碼)。

caldb.cld.directory.ldapbinddn

無 

LDAP 外掛程式用於行事曆尋找機制時用於連結認證以搜尋使用者 DN 的 DN。 

caldb.cld.directory.ldapport

"389"

LDAP 外掛程式用於行事曆尋找機制時要存取之 LDAP 伺服器的連接埠號。 

csapi.plugin.authentication

"no"

如果為 "yes",則僅載入 csapi.plugin.authentication.name 中指定的外掛程式,如果未指定,則按字母順序載入所有認證類別外掛程式。對於認證,則按字母順序使用每個外掛程式。

csapi.plugin.authentication.name

" "

如果 csapi.plugin.loadall 為 "no" 且 csapi.plugin.authentication 為 "yes",則僅載入此特定的外掛程式。如果未指定或為空白 (" "),則載入所有認證類別外掛程式。

logfile.dwp.buffersize

"0"

資料庫連線協定服務記錄緩衝區的大小 (以位元組為單位)。 

logfile.dwp.expirytime

"604800"

資料庫連線協定服務記錄檔過期之前的秒數。 

logfile.dwp.flushinterval

"60"

清除資料庫連線協定服務記錄檔緩衝區的間隔秒數。 

logfile.logdir

"logs"

資料庫連線協定服務記錄檔的目錄位置。 

logfile.dwp.loglevel

"Notice"

決定伺服器將為資料庫連線協定服務記錄的詳細資訊層級。每個資料庫連線協定記錄項目均被指定以下層級之一 (從最嚴重的開始)︰Critical、Error、Warning、Notice、Information 和 Debug。如果您將此喜好設定設定為 Critical,伺服器將記錄最少的詳細資訊。如果您想要伺服器記錄最多的詳細資訊,請指定 Debug。例如,如果您指定 Warning,則僅記錄 Critical、Error 和 Warning 層級的記錄項目。 

logfile.dwp.maxlogfiles

"10"

記錄目錄中資料庫連線協定相關的記錄檔的最大數目。 

logfile.dwp.maxlogfilesize

"2097152"

每個資料庫連線協定記錄檔的最大大小 (以位元組為單位)。 

logfile.dwp.maxlogsize

"20971520"

用於儲存所有資料庫連線協定記錄檔的最大磁碟空間 (以位元組為單位)。 

logfile.dwp.minfreediskspace

"5242880"

需要用於記錄資料庫連線協定服務活動的最小可用磁碟空間 (以位元組為單位)。達到此值後,伺服器將嘗試透過清除舊記錄檔來釋放磁碟空間。如果空間無法被釋放,則所有記錄將暫停。 

logfile.dwp.rollovertime

"86400"

旋轉資料庫連線協定服務記錄檔之前的秒數。 

service.dwp.admin.userid

" "

在後端伺服器上,指定用於認證 DWP 連線的使用者 ID。此參數是選擇性的。如果後端伺服器未指定使用者 ID,則不會執行認證。 

service.dwp.admin.cred

" "

在後端伺服器上,指定用於認證 DWP 連線的密碼。此參數是選擇性的。如果後端伺服器未指定密碼,則不會執行認證。 

service.dwp.calendarhostname

"localhost"

資料庫連線協定服務執行於其上之機器的主機名稱。 

service.dwp.maxthreads

"1000"

可並行運作的資料庫連線協定服務執行緒的最大數目。 

service.dwp.numprocesses

"1"

應在某個伺服器上執行之同步運作的資料庫連線協定 (DWP) 服務 (csdwpd) 程序的最大數目。

如需有關具有多個 CPU 的伺服器的資訊,請參閱21.8 使用跨多個 CPU 的負載平衡功能

service.dwp.enable

"no"

如果為 "yes",則在啟動所有服務時啟動 csdwpd 服務,並在停止所有服務時停止 csdwpd

service.dwp.idletimeout

"86400"

關閉閒置的資料庫連線協定服務的永久性連線之前的時間 (以秒為單位)。 

service.dwp.port

"59779"

資料庫連線協定服務偵聽的連接埠號。此值為 LDAP CLD 外掛程式的預設連接埠。 

service.dwp.ldap.enable

"yes"

為資料庫連線協定 (csdwpd ) 服務的遠端使用者認證啟用 ("yes") 或停用 ("no") LDAP。

service.calendarsearch.ldap

"yes"

指定 Calendar Server 是先搜尋 LDAP 目錄然後搜尋行事曆資料庫 ("yes"),還是僅搜尋行事曆資料庫 ("no")。

E.2.15 Calendar Server LDAP 資料快取記憶體配置參數

下表說明 ics.conf 檔案中 LDAP 資料快取記憶體的配置參數。

表 E–14 LDAP 資料快取記憶體配置參數

參數 

說明 

local.ldap.cache.enable

啟用 ("yes") 或停用 ("no") LDAP 資料快取記憶體。預設為 "no"

local.ldap.cache.checkpointinterval

指定檢查點執行緒靜止的秒數。預設時間為 "60" 秒。

local.ldap.cache.circularlogging

指定是否移除舊的快取記憶體檔案。預設為 "yes"

local.ldap.cache.homedir.path

指定 LDAP 資料快取記憶體資料庫的實體位置。預設為 /var/opt/SUNWics5/csdb/ldap_cache

local.ldap.cache.logfilesizemb

指定檢查點檔案的最大大小 (以百萬位元組為單位)。預設為 "10" 百萬位元組。

local.ldap.cache.maxthreads

指定 LDAP 資料快取記憶體資料庫執行緒的最大數目。預設為 "1000"

local.ldap.cache.mempoolsizemb

指定共用記憶體的百萬位元組數目。預設為 "4" 百萬位元組。

local.ldap.cache.entryttl

指定 LDAP 資料快取記憶體項目的有效時間 (TTL) (以秒為單位)。預設為 "3600" 秒 (1 小時)。

local.ldap.cache.stat.enable

指定是否在記錄檔中記錄對 LDAP 資料快取記憶體的存取情況並列印統計資料。預設為 "no"

注意此參數僅適用於除錯模式。 

local.ldap.cache.stat.interval

指定各統計資料報告寫入記錄檔的間隔時間 (以秒為單位)。預設為 "1800" 秒 (30 分鐘)。

local.ldap.cache.cleanup.interval

指定各資料庫清除作業之間的間隔時間 (以秒為單位)。預設為 "1800" 秒 (30 分鐘)。

E.2.16 群組和資源行事曆配置參數

若要配置群組和資源行事曆,請使用下表中的參數。

表 E–15 資源行事曆的配置參數

參數 

預設值 

說明 

下列參數只適用於群組: 

local.lookupldap

searchattr.groupid

"groupid"

這是群組的唯一識別碼。類似於使用者的 uid

group.allow.doublebook

"no"

決定建立行事曆時群組行事曆是否可以在同一時段排程多個事件︰ 

  • "no" 不允許雙預定。

  • "yes" 允許雙預定。

    此參數僅在建立群組行事曆時才使用。

    建立群組行事曆之後,Calendar Server 將檢查行事曆特性 (ics50calprops.db) 以確定是否允許雙預定。

group.default.acl

請參閱右側的說明 

群組行事曆的預設存取控制清單。 

預設為:"@@o^a^r^g;@@o^c^wdeic^g;@^a^rsf^g"

group.invite.

autoprovision

"yes"

指定在將邀請傳送給沒有預設行事曆的群組時是否要建立群組行事曆。 

group.invite.

autoaccept

"no"

指定是否要自動接受參與群組的邀請。 

group.invite.expand

"yes"

指定在邀請時是否要展開群組,以顯示邀請的所有成員。 

下列參數只適用於資源: 

resource.allow.

doublebook

"no"

決定建立行事曆時從屬於某一資源 (如會議室或聲訊視頻設備) 的行事曆是否可以在同一時段排程多個事件︰ 

  • "no" 不允許雙預定。

  • "yes" 允許雙預定。

    此參數僅在建立資源行事曆時才使用。

    建立資源行事曆之後,Calendar Server 將檢查行事曆特性 (ics50calprops.db) 以決定是否允許雙預定。

    如果您需要為資源行事曆變更行事曆特性以允許或不允許雙預定,請使用帶有 -k 選項的 csresource

resource.default.acl

 

指定建立資源行事曆時所使用的預設存取控制權限。 

預設為:"@@o^a^r^g;@@o^c^wdeic^g;@^a^rsf^g"

resource.invite.

autoprovision

"yes"|"no"

指定將邀請傳送給尚無預設行事曆的資源時,是否要自動建立資源行事曆。 

resource.invite.

autoaccept

"yes"|"no"

指定是否要自動接受傳送給資源的邀請。 

下列參數適用於群組與資源: 

local.lookupldap

searchattr.owner

"owner"

要用於群組和資源所有者的屬性。預設為 "owner"。群組和資源使用同一屬性做為預設值;變更其中一項的屬性將會變更另一項的屬性。

local.lookupldap

searchattr.coowner

 

要用於群組和資源所有者的屬性。群組和資源使用同一屬性做為預設值;變更其中一項的屬性將會變更另一項的屬性。 

預設為 "icsSecondaryowners"

local.lookupldap

searchattr.defaultacl

 

群組和資源用於保存預設存取控制字串的屬性。 

預設為 "icsDefaultacl"

local.lookupldap

searchattr.doublebook

 

在群組和資源行事曆的自動佈建中使用的屬性,指定在同一時段是否可以排程多個事件。 

預設為 "icsDoublebooking"

local.lookupldap

searchattr.autoaccept

 

在群組和資源行事曆的自動佈建中使用的屬性,指定是否自動接受事件。 

預設為 "icsAutoaccept"

local.lookupldap

searchattr.timezone

 

在群組和資源行事曆的自動佈建中使用的屬性,指定行事曆所使用的時區。 

預設為 "icsTimezone"

E.2.17 Calendar Server 單次登入 (Single Sign-on, SSO) 配置參數

E.2.17.1 透過 Access Manager 配置 SSO

下表顯示您使用 Access Manager 時的 SSO 配置參數以及每個參數的預設值和說明。

表 E–16 ics.conf 檔案中的 SSO 配置參數 (透過 Access Manager)

參數 

預設值 

說明 

local.calendar.sso.

singlesignoff

”yes”

啟用 (”yes”) 或停用 (”no” ) Calendar Server 的 SSO。

local.calendar.sso.

amcookiename

“iPlanetDirectoryPro”

指定 Access Manager SSO cookie 的名稱。 

local.calendar.sso.

amnamingurl

”http://AccessManager:port
/amserver/namingservice”

指定 Access Manager SSO 命名服務的 URL

local.calendar.sso.

amloglevel

”3”

指定 Access Manager SSO 的記錄層級。範圍為從 1 (無訊息) 到 5 (詳細)。 

local.calendar.sso.

logname

“am_sso.log”

指定 Access Manager SSO API 記錄檔的名稱。 

E.2.17.2 透過通訊伺服器信任圈技術配置 SSO

下表顯示使用通訊伺服器信任圈技術時的 SSO 配置參數以及每個參數的預設值和說明。

表 E–17 ics.conf 檔案中使用通訊伺服器信任圈技術的 SSO 配置參數

參數 

預設值 

說明 

sso.appid

"ics50"

此 Calendar Server 安裝的唯一應用程式 ID。每個信任應用程式也必須具有唯一應用程式 ID。例如:sso.appid="ics50"

sso.appprefix

"ssogrp1"

要用於格式化 SSO cookie 的字首值。所有信任的應用程式均需要使用相同的值,因為僅包含該字首的 SSO cookie 才能被 Calendar Server 識別。 

應用程式前綴不能以連字符 (-) 結尾,因為 Calendar Server 會為值附加連字符。例如:

sso.appprefix="ssogrp1"

sso.appid.url

無 

sso.appid 指定的值的驗證 URL。例如:

"sso.ics50.url="http://siroe.com:80/
default.html"

sso.nnn.ip

無 

sso.appid 指定的值的 IP 位址。例如: sso.ics50.ip=

"123.12.456.123"

sso.cookiedomain

"."

使瀏覽器將 cookie 僅傳送至指定網域中的伺服器。 

值必須以小數點號 (.) 開頭。例如:

".sesta.com"

sso.enable

"1"

啟用或停用 SSO︰ 

  • "1" (預設) 啟用 SSO 功能。

  • "0" 停用 SSO 功能。

    如果 ics.conf 中缺少此參數,Calendar Server 將忽略 SSO 功能。

sso.singlesignoff

"true"

如果設定為 "true",則當使用者登出時,伺服器將移除所有與 sso.appprefix 值相符的使用者 SSO cookie。如果為 "false",則伺服器僅移除其 SSO 使用者 cookie。

sso.userdomain

" "

設定用做使用者 SSO 認證一部分的網域。 

sso.appid.url

" "

指定同層 SSO 主機的驗證 URL 值。每個信任的同層主機均需要一個參數。 

appid 是其 SSO cookie 將被信任的同層 SSO 主機的應用程式 ID。對於 Calendar Server,appidics50

verifyurl 可識別以下格式的可信任同級組織的 URL︰"http://host:port/VerifySSO?"。請勿省略 VerifySSO 後面的問號 (?)。

主機為主機的 URL,連接埠為主機的連接埠號。 

例如,對於 sesta.com 上連接埠號為 8883 的 Calendar Server︰

sso.ics50.url=

"http://sesta.com:8883/VerifySSO?"

E.2.18 Calendar Server 群組排程引擎 (Group Scheduling Engine, GSE) 配置參數

下表顯示群組排程引擎 (GSE) 配置參數以及每個參數的預設值和說明。

表 E–18 ics.conf 檔案中的群組排程引擎 (GSE) 配置參數

參數 

預設值 

說明 

gse.autorefresh

replystatus

"yes"

指定啟用還是停用自動更新功能。如果啟用自動更新,在與會者回覆事件組織者後,該與會者的回覆狀態將自動傳遞給該排程事件的其他與會者。 

  • "yes" 啟用自動更新。

  • "no" 停用自動更新。

gse.belowthreshold

timeout

"3"

指定伺服器開始掃描送進工作的排程佇列之前應等待的時間 (以秒為單位)。如果佇列中的工作多於所配置執行緒的最大數目,則最後一個執行緒將始終重新掃描工作佇列。因此,僅當工作數目小於所配置執行緒的最大數目時,此設定才能生效。 

增加此數目可減少伺服器掃描工作佇列的頻率,並提高整體效能。 

gse.maxthreads

"10"

指定伺服器用於處理排程佇列的並行運作執行緒的最大數目。每個執行緒處理佇列中的一個工作。 

gse.retryexpired

interval

"86400"

指定伺服器將重試以完成群組排程工作的最大時間長度 (以秒為單位)。如果時間超出指定的最大時間長度,伺服器會將工作視為重試過期狀態並報告錯誤。 

請注意,預設值 86400 秒相當於一天。 

gse.retryinterval

"300"

指定伺服器重試先前失敗工作的間隔時間 (以秒為單位)。伺服器僅在遇到網路錯誤時才重試失敗的工作。但是,伺服器會將大多數此類錯誤視為嚴重錯誤,且不進行重試。 

gse.stacksize

"65535"

指定群組排程執行緒的最大堆疊大小 (以位元組為單位)。 

E.2.19 Calendar Server Berkeley 資料庫配置參數

下表列出用於配置資料庫處理的 ics.conf 參數,並提供每個參數的預設值及說明。

表 E–19 ics.conf 檔案中的資料庫配置參數

參數 

預設值 

說明 

caldb.berkeleydb.

.checkpointinterval

"60"

檢查點檢查資料庫作業事件的間隔秒數。 

caldb.berkeleydb.

circularlogging

"yes"

如果為 "yes",則在同步化資料庫檢查點檔案的作業事件後移除這些檔案。請勿將其設定為 “no”,除非您已啟用自動備份。

caldb.berkeleydb.

deadlockinterval

"100"

檢查需要被打破的資料庫死結的間隔毫秒數。 

caldb.berkeleydb.

homedir.path

"."

儲存資料庫事件、工作和警示檔案的目錄 (程式可執行檔的相對位置或指定的絕對路徑)。預設為 ".",其指定: 

/var/opt/SUNWics5/csdb

caldb.berkeleydb.

logfilesizemb

"10"

資料庫檢查點檔案的最大百萬位元組。 

caldb.berkeleydb.

maxthreads

"10000"

必須準備資料庫環境以容納的執行緒的最大數目。 

caldb.berkeleydb.

mempoolsizemb

"4"

用於資料庫環境的共用記憶體的百萬位元組。 

caldb.calmaster

" "

負責管理資料庫的使用者或別名的電子郵件。 

caldb.counters

"yes"

如果為 "yes",將計數資料庫統計 (讀取、寫入和刪除)。

caldb.counters.

maxinstances

"100"

可以帶有計數器之行事曆的最大數目。使用 cscal 指令行公用程式可以為計數器啟用行事曆。

caldb.smtpmsgfmtdir

"en"

指定 /etc/opt/SUNWics5/config 下包含本土化版本檔案的目錄,這些檔案可用於格式化電子郵件通知。

例如,"en" 指定英語本土化版本的目錄,"fr" 指定法語本土化版本的目錄。 

caldb.smtpport

"25"

SMTP 主機的連接埠。 

local.caldb.deadlock.autodetect

"no"

定期檢查 Berkeley 資料庫是否處於死結狀態,如果是,則指示資料庫重設。 

E.2.20 行事曆資料庫的自動備份

下表列出自動備份程序 (csstored) 使用的參數以及可用的預設值,並說明 ics.conf 參數。

表 E–20 自動備份程序使用的 ics.conf 參數

參數 

預設值 

說明 

logfile.store.logname

defaultstore.log

記錄檔的名稱。 

logfile.logdir

"."

記錄目錄的路徑。 

caldb.berkeleydb.homedir.

path

無 

即時資料庫的路徑。 

caldb.berkeleydb.archive.

path

無 

歸檔備份的路徑。 

caldb.berkeleydb.hotbackup.

path

無 

緊急備份的路徑。 

caldb.berkeleydb.archive.

enable

"yes"

啟用/停用自動歸檔備份。 

caldb.berkeleydb.hotbackup.

enable

"yes"

啟用/停用自動緊急備份。 

caldb.berkeleydb.hotbackup.

mindays

"3"

磁碟上保存的緊急備份副本的最小數目。 

caldb.berkeleydb.hotbackup.

threshold

"70"

觸發清除舊的緊急備份副本的已佔用磁碟空間百分比。 

caldb.berkeleydb.archive.

interval

"86400"

每次備份之間的間隔 (以秒為單位)。預設為 24 小時,即 86400 秒。 

caldb.berkeleydb.archive.

mindays

"3"

磁碟上保存的歸檔備份副本的最小數目。 

caldb.berkeleydb.archive.

maxdays

"7"

磁碟上保存的歸檔備份副本的最大數目。 

caldb.berkeleydb.archive.

threshold

"70"

觸發清除舊的歸檔備份副本的已佔用磁碟空間百分比。 

caldb.berkeleydb.

circularlogging

"yes"

啟用/停用管理備份副本數目及其佔用的磁碟空間。 

caldb.berkeleydb.archive.

interval

"86400"

每次備份相隔的時間 (以秒為單位)。 

預設為 24 小時,即 86400 秒。 

service.store.enable

(不在 ics.conf 檔案中)

"yes"

允許使用 start-cal 啟動 csstored。如果您要禁止使用 start-cal 啟動 csstored,則必須將其增加至 ics.conf 檔案,並設定為 "no"

E.2.21 ENS 訊息的行事曆資料庫參數

下表說明用於配置行事曆資料庫的參數以及每個參數的預設值和說明。如果需要預設以外的值,您必須在 ics.conf 檔案中進行設定。

表 E–21 ENS 訊息的行事曆資料庫參數

參數 

預設值 

說明 

caldb.serveralarms.url

"enp:///ics/alarm"

指定 ENS 訊息的 URL。 

caldb.serveralarms.

contenttype

""

指定警示資料的內容類型。值可為 "text/xml""text/calendar"

caldb.berkeleydb.ensmsg.

createcal

"no"

在建立行事曆時建立 ENS 訊息。 

caldb.berkeleydb.ensmsg.

createcal.url

"enp:///ics/calendarcreate"

指定 ENS 訊息的 URL。 

caldb.berkeleydb.ensmsg.

createcal.contenttype

"text/xml"

指定訊息資料的內容類型︰"text/xml" (預設) 或 "text/calendar"

caldb.berkeleydb.ensmsg.

deletecal

"no"

在刪除行事曆時建立 ENS 訊息。 

caldb.berkeleydb.ensmsg.

deletecal.url

"enp:///ics/calendardelete"

指定 ENS 訊息的 URL。 

caldb.berkeleydb.ensmsg.

deletecal.contenttype

"text/xml"

指定訊息資料的內容類型︰"text/xml" (預設) 或 "text/calendar"

caldb.berkeleydb.ensmsg.

modifycal

"no"

在修改行事曆時建立 ENS 訊息。 

caldb.berkeleydb.ensmsg.

modifycal.url

"enp:///ics/calendarmodify"

ENS 訊息的 URL。 

caldb.berleleydb.ensmsg.

modifycal.contenttype

"text/xml"

指定訊息資料的內容類型︰"text/xml" (預設) 或 "text/calendar"

caldb.berkeleydb.ensmsg.

createevent

"no"

在建立事件時建立 ENS 訊息。 

caldb.berkeleydb.ensmsg.

createevent.url

"enp:///ics/caleventcreate"

指定 ENS 訊息的 URL。 

caldb.berleleydb.ensmsg.

createevent.contenttype

"text/xml"

指定訊息資料的內容類型︰"text/xml" (預設) 或 "text/calendar"

caldb.berkeleydb.ensmsg.

modifyevent

"no"

在修改事件時建立 ENS 訊息。 

caldb.berkeleydb.ensmsg.

modifyevent.url

"enp:///ics/caleventmodify"

指定 ENS 訊息的 URL。 

caldb.berleleydb.ensmsg.

modifyevent.contenttype

"text/xml"

指定訊息資料的內容類型︰"text/xml" (預設) 或 "text/calendar"

caldb.berkeleydb.ensmsg.

deleteevent

"no"

在刪除事件時建立 ENS 訊息。 

caldb.berkeleydb.ensmsg.

deleteevent.url

"enp:///ics/caleventdelete"

指定 ENS 訊息的 URL。 

caldb.berkeleydb.ensmsg.

deleteevent.contenttype

"text/xml"

指定訊息資料的內容類型︰"text/xml" (預設) 或 "text/calendar"

caldb.berkeleydb.ensmsg.

createtodo

"no"

在建立待辦事項時建立 ENS 訊息。 

caldb.berkeleydb.ensmsg.

createtodo.url

"enp:///ics/caltodocreate"

指定 ENS 訊息的 URL。 

caldb.berleleydb.ensmsg.

createtodo.contenttype

"text/xml"

指定訊息資料的內容類型︰"text/xml" (預設) 或 "text/calendar"

caldb.berkeleydb.ensmsg.

modifytodo

"no"

在修改待辦事項時建立 ENS 訊息。 

caldb.berkeleydb.ensmsg.

modifytodo.url

"enp:///ics/caltodomodify"

指定 ENS 訊息的 URL。 

caldb.berleleydb.ensmsg.

modifytodo.contenttype

"text/xml"

指定訊息資料的內容類型︰"text/xml" (預設) 或 "text/calendar"

caldb.berkeleydb.ensmsg.

deletetodo

"no"

在刪除待辦事項時建立 ENS 訊息。 

caldb.berkeleydb.ensmsg.

deletetodo.url

"enp:///ics/caltododelete"

指定 ENS 訊息的 URL。 

caldb.berkeleydb.ensmsg.

deletetodo.contenttype

"text/xml"

指定訊息資料的內容類型︰"text/xml" (預設) 或 "text/calendar"

E.2.22 事件通知伺服器 (ENS) 配置

可以將 Calendar Server 配置為使用稱為事件通知伺服器 (ENS) 的外部通用服務,該服務可接受按特定興趣分類的伺服器層級事件報告,並可通知其他已對特定種類的事件進行註冊的伺服器。Calendar Server 使用 ENS 來傳送和接收警示通知 (包括建立、刪除或修改行事曆事件和工作),以及一般作業警告和錯誤訊息。

下表顯示 ics.conf 中的事件通知伺服器 (Event Notification Server, ENS) 配置參數,以及每個參數的預設值和說明。

表 E–22 ics.conf 檔案中的事件通知伺服器 (ENS) 配置參數

參數 

預設值 

說明 

service.ens.enable

"yes"

如果為 "yes",則在啟動所有服務時啟動 enpd 服務,並在停止所有服務時停止 enpd。

service.ens.host

"localhost"

執行 ENS 的機器的主機名稱。 

service.ens.port

"57997"

執行 ENS 的機器的連接埠號。 

service.ens.library

"xenp"

ENS 外掛程式的名稱。 

service.notify.enable

"yes"

如果為 "yes",則在啟動所有服務時啟動 csnotifyd 服務,並在停止所有服務時停止 csnotifyd

service.notify.

maxretrytime

"-1"

csnotifyd 將持續重試且無法連絡 ENS 的次數。 

"-1" 可導致警示執行緒無限制重試。

service.notify.

retryinterval

"3"

連線失敗後嘗試重新連絡 ENS 之前,csnotifyd 等待的時間 (以秒為單位)。

service.notify.

startupretrytime

"0"

Calendar Server 在停止前保持嘗試連絡 ENS 的總秒數。此設定類似於 caldb.serveralarms.maxretrytime,除了其僅在警示執行緒首先啟動時才適用。警示執行緒成功啟動後,將使用 caldb.serveralarms.maxretrytime

"0" 告知警示執行緒若在啟動時無法連線至 ENS,則立即結束。

ens.startlistener

"0"

可以接受的值: 

  • "1"

  • "0"

caldb.berkeleydb.

alarmretrytime

"300"

可回復警示遞送錯誤之後的重試時間 (以秒為單位)。 

caldb.berkeleydb.ensmsg.

createcal

"no"

如果為 "yes",則在建立行事曆時使用以下格式建立事件通知服務訊息︰ 

enp://ics/createcal?calid=cal

caldb.berkeleydb.ensmsg.

modifycal

"no"

如果為 "yes",則在使用以下格式修改行事曆時建立事件通知服務訊息︰

enp://ics/modifycal?calid=cal

caldb.berkeleydb.ensmsg.

deletecal

"no"

如果為 "yes",則在使用以下格式刪除行事曆時建立事件通知服務訊息︰

enp://ics/deletecal?calid=cal

caldb.berkeleydb.ensmsg.

advancedtopics

"no"

指定修改事件通知如何發佈︰ 

  • 如果為 "yes",則系統會透過將 replyrefreshmodify 作業事件發佈至各自主題來區別它們︰

    caldb.berkeleydb.ensmsg.replyevent

    caldb.berkeleydb.ensmsg.refreshevent

    caldb.berkeleydb.ensmsg.modifyevent

  • 如果為 "no",則系統會將所有三種類型 (replyrefreshmodify) 均發佈至以下主題:

    caldb.berkeleydb.ensmsg.modifyevent

caldb.berkeleydb.ensmsg.

createevent

"no"

如果為 "yes",則在建立事件時建立 ENS 訊息。

caldb.berkeleydb.ensmsg.

deleteevent

"no"

如果為 "yes",則在刪除事件時建立 ENS 訊息。

caldb.berkeleydb.ensmsg.

modifyevent

"no"

如果為 "yes",則在修改事件時建立 ENS 訊息。

caldb.berkeleydb.ensmsg.

refreshevent

"no"

指定更新事件時 Calendar Server 是否應建立 ENS 訊息。 

caldb.berkeleydb.ensmsg.

refreshevent.contenttype

"text/xml"

指定事件更新之訊息資料的內容類型。值可為 "text/xml" 或 "text/calendar"。

caldb.berkeleydb.ensmsg.

refreshevent.url

"enp:///ics/caleventrefresh"

指定事件更新之 ENS 訊息的 URL。 

caldb.berkeleydb.ensmsg.

replyevent

"no"

指定 Calendar Server 是否應為事件回覆建立 ENS 訊息。 

caldb.berkeleydb.ensmsg.

replyevent.contenttype

"text/xml"

指定事件回覆之訊息資料的內容類型。值可為 "text/xml""text/calendar"

caldb.berkeleydb.ensmsg.

replyevent.url

"enp:///ics
/caleventreply"

指定事件回覆之 ENS 訊息的 URL。 

caldb.berkeleydb.ensmsg.

createtodo

"no"

如果為 "yes",則在使用以下格式建立待辦事項 (工作) 時建立事件通知服務訊息︰

enp://ics/createtodo?
uid=uid&rid=rid

caldb.berkeleydb.ensmsg.

modifytodo

"no"

如果為 "yes",則在修改工作時使用以下格式建立事件通知服務訊息︰ 

enp://ics/modifytodo?
uid=uid&rid=rid

caldb.berkeleydb.ensmsg.

deletetodo

"no"

如果為 "yes",則在使用以下格式刪除工作時建立事件通知服務訊息︰

enp://ics/deletetodo?uid=uid&rid=rid

caldb.berkeleydb.ensmsg.

qsize

"10000"

記憶體內部 ENS 訊息佇列的初始大小。此佇列可儲存警示提醒通知以外的所有 ENS 訊息。 

caldb.berkeleydb.ensmsg.

schedreq

"no"

如果為 "yes",則在使用以下格式刪除寫入行事曆的排程請求時建立事件通知服務訊息︰

enp://ics/schedreq?calid=cal
&method=method&type={event|todo}
&uid=uid&rid=rid

caldb.serveralarms

"yes"

如果為 "yes",將傳送警示電子郵件。 

caldb.serveralarms.

acktimeout

"30"

指定 ENS 的警示執行緒在發佈警示通知後等待 csnotifyd 回應的秒數。如果逾時過期,警示執行緒將假設警示通知不再處理,並會再次發佈警示通知。 

caldb.serveralarms.

dispatchtype

"ens"

指定 Calendar Server 警示的派送類型︰ 

  • 如果為 "ens",則伺服器使用外部 ENS 傳送和接收警示。

  • 如果為 "smtp",則伺服器將警示做為標準 SMTP 訊息傳送,且略過 ENS。

caldb.serveralarms.

initthreads

"10"

伺服器警示執行緒的初始數目。 

caldb.serveralarms.

maxretrytime

"-1"

警示執行緒將持續重試且無法連絡 ENS 的次數。 

"-1" 可導致警示執行緒無限制重試。

caldb.serveralarms.

maxthreads

"10"

伺服器警示執行緒的最大數目。 

caldb.serveralarms.

retryinterval

"5"

警示執行緒 (在 csadmind 中) 在嘗試重新連絡 ENS 之前等待的時間 (以秒為單位)。 

caldb.serveralarms.

stacksize

"65536"

伺服器警示執行緒的堆疊框架大小。 

caldb.serveralarms.startup

retrytime

"0"

Calendar Server 在失敗前保持嘗試連絡 ENS 的總秒數。此設定類似 caldb.serveralarms.maxretrytime 設定,除了僅在警示執行緒首先啟動時才適用。一旦警示執行緒成功啟動,將使用 caldb.serveralarms.maxretrytime。 

如果為 "0",則警示執行緒在啟動時無法連線至 ENS 的情況下,會立即結束。

caldb.smtphost

"localhost"

將警示電子郵件傳送至該 SMTP 主機。 

E.2.23 Calendar Server API 配置

下表顯示 Calendar Server API (CSAPI) 配置參數以及每個參數的預設值和說明。

表 E–23 ics.conf 檔案中的 CSAPI 配置參數

參數 

預設值 

說明 

csapi.plugin.authentication

"no"

如果值為 "yes",則僅載入 csapi.plugin.authentication.name 中指定的外掛程式。

csapi.plugin.accesscontrol

"no"

啟用 ("yes") 或停用 ("no") 存取控制外掛程式。

csapi.plugin.authentication

"no"

如果值為 "yes",則僅載入 csapi.plugin.authentication.name 中指定的外掛程式。

如果值為 "no" 或未指定,則按字母順序載入所有認證類別外掛程式。對於認證,則按字母順序使用每個外掛程式。

csapi.plugin.authentication.

name

" "

如果 csapi.plugin.loadall"no"csapi.plugin.authentication"yes",則僅載入此特定的外掛程式。如果未指定或為空白 (" "),則載入所有認證類別外掛程式。

csapi.plugin.database

"yes"

如果為 "yes",則僅載入 csapi.plugin.database.name 中指定的外掛程式。

如果為 "no" 或未指定,則按字母順序載入所有資料庫外掛程式。

csapi.plugin.database.name

"cs_caldb
_berkeley"

如果 csapi.plugin.loadall"no"csapi.plugin.database"yes",則僅載入此外掛程式。如果未指定或為空白 (" "),則按字母順序載入所有資料庫外掛程式。

csapi.plugin.datatranslator

"yes"

如果為 "yes",則僅載入 csapi.plugin.datatranslator.name 中指定的外掛程式,或者,如果未指定,則按字母順序載入所有資料轉譯器類別外掛程式。對於資料轉換,則按字母順序使用每個外掛程式。

csapi.plugin.datatranslator.

name

"cs_data
translatorcsv"

如果 csapi.plugin.loadall"no"csapi.plugin.datatranslator"yes",則載入此特定的外掛程式。

如果為空白 (" ") 或未指定,則載入所有資料轉譯器類別外掛程式。

csapi.plugin.dbtranslator

"yes"

啟用 ("yes") 或停用 ("no")「資料庫至輸出」格式的外掛程式。

csapi.plugin.dbtranslator.name

"*"

如果 csapi.plugin.dbtranslator"yes",則︰

  • 如果為 "*",則載入所有「資料庫至輸出」格式的外掛程式。

  • 如果此值為程式庫名稱,則僅載入此特定的外掛程式。

 

如果 csapi.plugin.dbtranslator"no",則忽略此設定。

csapi.plugin.loadall

"no"

如果為 "yes",則載入外掛程式目錄中的所有外掛程式。(外掛程式具有 .so 副檔名。)

如果為 "no",則僅載入其各自參數所標幟的特定類別的外掛程式。例如,將 csapi.plugin.authentication 設定為 "yes" 可以載入認證類別外掛程式。

csapi.plugin.userprefs

"no"

如果為 "yes",則僅載入 csapi.plugin.userprefs.name 中指定的外掛程式,或者,如果未指定,則按字母順序載入所有使用者喜好設定類別外掛程式。對於使用者喜好設定,則按字母順序使用每個外掛程式。

csapi.plugin.userprefs.

name

" "

如果 csapi.plugin.loadall"no"csapi.plugin.userprefs"yes",則使用此參數。如果未指定或為空白 (" "),則載入所有使用者喜好設定類別外掛程式。否則,僅載入此特定外掛程式。

E.3 計數器配置 (counter.conf) 檔案

Calendar Server 計數器 (統計) 配置參數位於以下檔案中︰

/etc/opt/SUNWics5/config/counter.conf

counter.conf 檔案為 ASCII 文字檔案,每行定義一個計數器及其參數︰名稱、類型、大小 (以位元組為單位) 和說明。包含空格的參數必須置於雙引號 (" ") 中。註釋行必須以驚嘆號 (!) 開頭。註釋行僅用於提供資訊。

計數器名稱的第一部分可識別與 csstats 公用程式配合使用的計數器物件。如需有關指令行公用程式的更多資訊,請參閱附錄 DCalendar Server 指令行公用程式參照


備註 –

請勿修改 counter.conf 檔案,除非用戶支援人員指導您這樣做。


本小節說明 Calendar Server counter.conf 參數,包括︰

E.3.1 警示計數器

下表顯示每個警示計數器的名稱、類型、大小和說明。

表 E–24 counter.conf 檔案中的警示計數器

名稱 

類型 

大小 

說明 

alarm.high

GAUGE 

最高記錄值。 

alarm.low

GAUGE 

最低記錄值。 

alarm.current

GAUGE 

目前監視值。 

alarm.warningstate

GAUGE 

警告狀態︰是 (1) 或否 (0)。 

alarm.countoverthreshold

COUNTER 

超出臨界值的次數。 

alarm.countwarningsent

COUNTER 

已傳送的警告數目。 

alarm.timelastset.desc

TIME 

最後一次設定目前值的時間。 

alarm.timelastwarning

TIME 

最後一次傳送警告的時間。 

alarm.timereset

TIME 

最後一次執行重設的時間。 

alarm.timestatechanged.desc

TIME 

最後一次變更警示狀態的時間。 

E.3.2 磁碟使用計數器

下表顯示每個磁碟使用計數器的名稱、類型、大小和說明。

表 E–25 counter.conf 檔案中的磁碟使用計數器

名稱 

類型 

大小 

說明 

diskusage.availSpace

GAUGE 

磁碟分割區中的可用空間總量。 

diskusage.lastStatTime

TIME 

最後一次取得統計資料的時間。 

diskusage.calPartitionPath

STRING 

512 

行事曆分割區路徑。 

diskusage.percentAvail

GAUGE 

磁碟分割區的可用空間百分比。 

diskusage.totalSpace

GAUGE 

磁碟分割區的空間總量。 

E.3.3 HTTP 計數器

下表顯示每個 HTTP 計數器的名稱、類型、大小和說明。

表 E–26 counter.conf 檔案中的 HTTP (httpstat) 計數器

名稱 

類型 

大小 

說明 

httpstat.avgConnectionTime

GAUGE 

平均連線回應時間。 

httpstat.currentStartTime

TIME 

Calendar Server 的啟動時間。 

httpstat.lastConnectionTime

TIME 

最後一次接受新用戶端連線的時間。 

httpstat.maxConnections

COUNTER 

允許的並行運作連線的最大數目。 

httpstat.maxSessions

COUNTER 

允許的 WCAP 階段作業的最大數目。 

httpstat.numConnections

COUNTER 

允許的連線的總數。 

httpstat.numCurrentConnections

GAUGE 

作用中連線的目前數目。 

httpstat.numCurrentSessions

GAUGE 

WCAP 階段作業的目前數目。 

httpstat.numFailedConnections

COUNTER 

允許的失敗連線的總數。 

httpstat.numGoodLogins.desc

COUNTER 

由目前 HTTP 伺服器提供服務之成功登入的數目。 

httpstat.numFailedLogins

COUNTER 

由目前 HTTP 伺服器提供服務之失敗登入的數目。 

E.3.4 群組排程計數器

下表顯示每個群組排程引擎 (GSE) 計數器的名稱、類型、大小和說明。

表 E–27 counter.conf 檔案中的群組排程引擎 (GSE) 計數器

名稱 

類型 

大小 

說明 

gsestat.lastWakeUpTime

TIME 

GSE 最後一次喚醒並處理工作的時間。 

gsestat.lastJobProcessedTime

TIME 

GSE 最後一次處理工作的時間。 

gsestat.numJobsProcessed

COUNTER 

GSE 所處理的工作總數。 

gsestat.numActiveWorkerThreads

COUNTER 

作用中工作者執行緒的總數。 

E.3.5 認證計數器

下表顯示每個認證計數器的名稱、類型、大小和說明。

表 E–28 counter.conf 檔案中的認證 (authstat) 計數器

名稱 

類型 

大小 

說明 

authstat.lastLoginTime

TIME 

使用者最後一次登入的時間。 

authstat.numSuccessfulLogins

COUNTER 

允許的成功登入的總數。 

authstat.numFailedLogins

COUNTER 

允許的失敗登入的總數。 

E.3.6 WCAP 計數器

下表顯示每個 WCAP 計數器的名稱、類型、大小和說明。

表 E–29 counter.conf 檔案中的 WCAP (wcapstat) 計數器

名稱 

類型 

大小 

說明 

wcapstat.numRequests

COUNTER 

WCAP 請求的總數。 

E.3.7 資料庫計數器

下表顯示每個資料庫計數器的名稱、類型、大小和說明。

表 E–30 counter.conf 檔案中的資料庫 (dbstat) 計數器

名稱 

類型 

大小 

說明 

dbstat.numReads

COUNTER 

資料庫讀取作業的總次數。 

dbstat.numWrites

COUNTER 

資料庫寫入作業的總次數。 

dbstat.numDeletes

COUNTER 

資料庫刪除作業的總次數。 

dbstat.lastReadTime

TIME 

資料庫最後一次讀取的時間。 

dbstat.lastWriteTime

TIME 

資料庫最後一次寫入的時間。 

dbstat.lastDeleteTime

TIME 

資料庫最後一次刪除的時間。 

E.3.8 伺服器回應計數器

下表顯示每個伺服器回應計數器的名稱、類型、大小和說明。

表 E–31 counter.conf 檔案中的伺服器回應計數器

名稱 

類型 

大小 

比例 

說明 

serverresponse.lastStatTime

TIME 

 

最後一次取得統計資料的時間。 

serverresponse.responseTime

GAUGE 

伺服器回應時間 (以毫秒為單位)。 

E.3.9 階段作業狀態計數器

下表顯示每個階段作業狀態計數器的名稱、類型、大小和說明。

表 E–32 counter.conf 檔案中的階段作業狀態計數器

名稱 

類型 

大小 

比例 

說明 

sessstat.maxSessions.desc

COUNTER 

允許的 HTTP 階段作業的最大數目。 

sessstat.numCurrentSessions

GAUGE 

HTTP 階段作業的目前數目。 

E.4 Calendar Server 電子郵件通知

Calendar Server 可傳送E.4.1 Calendar Server 電子郵件通知配置參數和格式檔案中說明的電子郵件訊息類型。這些訊息的格式由表中列出的關聯格式 (.fmt) 檔案控制。格式檔案位於以下目錄中每個語言環境 (例如 /en 為英文,/fr 為法語) 的特定目錄中︰

/etc/opt/SUNWics5/config

例如,英文版本的工作 (待辦事項) 警示訊息格式在以下檔案中指定︰

/etc/opt/SUNWics5/config/en/mail_todoalarm.fmt

本小節說明以下內容:

E.4.1 Calendar Server 電子郵件通知配置參數和格式檔案

下表顯示每個 Calendar Server Mail 參數的郵件類型、ics.conf 參數名稱、預設格式檔案說明以及收件者。

表 E–33 ics.conf 檔案中的 Calendar Server 電子郵件格式

訊息類型 

參數 

格式檔案 (預設) 

說明 

收件者 

事件發佈 

calmail.imipeventpublish.

fname

"mail_eventpublish.fmt"

宣佈事件或現有事件的變更 

通知中列出的人員 

事件取消 

calmail.imipeventcancel.

fname

"mail_eventcancel.fmt"

宣佈事件取消 

通知中列出的人員 

回覆事件 

calmail.imipeventreply.

fname

"mail_eventreply.fmt"

回覆事件通知。 

通知中列出的人員 

請求事件 

calmail.imipeventrequest.

fname

"mail_eventrequest.fmt"

訂閱事件通知。 

通知中列出的人員 

事件警示 

calmail.eventreminder.

fname

"mail_eventreminder.fmt"

提醒即將發生的事件 

提醒通知中列出的人員 

週期性事件通知 

calmail.imipevent

notificationrecur.fname

"mail_event

notificationrecur.fmt"

週期性事件的通知 

通知中列出的人員 

事件取消通知 

calmail.imipeventcancel

notification.fname

"mail_eventcancel

notification.fmt"

已取消事件的通知 

通知中列出的人員 

週期性事件取消通知 

calmail.imipeventcancel

notificationrecur.fname

"mail_eventcancel

notificationrecur.fmt"

已取消的週期性事件的通知 

通知中列出的人員 

與會者回覆:接受通知 

calmail.imipeventaccept

notification.fname

"mail_eventaccept

notification.fmt"

將與會者已接受邀請這一事項通知事件組織者。 

事件組織者 

與會者回覆:拒絕通知 

calmail.imipeventdecline

notification.fname

"mail_eventdecline

notification.fmt"

將與會者已拒絕邀請這一事項通知事件組織者。 

事件組織者 

與會者回覆:暫訂接受通知 

calmail.imipeventtentative

acceptnotification.fname

"mail_eventtentative

acceptnotification.fmt"

將與會者已暫訂接受邀請這一事項通知事件組織者。 

事件組織者 

與會者回覆:週期性事件的接受通知 

calmail.imipeventaccept

notificationrecur.fname

"mail_eventaccept

notificationrecur.fmt"

將與會者已接受週期性事件邀請這一事項通知事件組織者。 

事件組織者 

與會者回覆:週期性事件的拒絕通知 

calmail.imipeventdecline

notificationrecur.fname

"mail_eventdecline

notificationrecur.fmt"

將與會者已拒絕週期性事件邀請這一事項通知事件組織者。 

事件組織者 

與會者回覆:週期性事件的暫訂接受通知 

calmail.imipevent

tentativeaccept

notificationrecur.fname

"mail_eventtentative

acceptnotificationrecur.fmt"

將與會者已暫訂接受週期性事件邀請這一事項通知事件組織者。 

事件組織者 

工作發佈 

calmail.imiptodopublish.

fname

"mail_todopublish.fmt"

宣佈工作或現有工作的變更 

通知中列出的人員 

工作取消 

calmail.imiptodocancel.fname

"mail_todocancel.fmt"

宣佈工作取消 

通知中列出的人員 

回覆工作 

calmail.imiptodoreply.

fname

"mail_todoreply.fmt"

回覆工作通知 

通知中列出的人員 

待辦事項請求 

calmail.imiptodorequest.

fname

"mail_todorequest.fmt"

訂閱待辦事項通知。 

通知中列出的人員 

工作警示 

calmail.todoreminder.

fname

"mail_todoreminder.fmt"

提醒即將執行的工作 

提醒通知中列出的人員 

Calendar Server 透過將特定事件或工作與格式檔案內容相結合,來產生通知訊息。事件或工作中資料欄位的值可輸出至訊息。通知訊息還可以包含 MIME 標頭行及關聯的特殊值。使用特殊字元序列 (格式記號),您可以在訊息中包含事件、工作和 MIME 標頭的值。格式檔案中的行是特殊字元序列組成的格式字串,在產生郵件訊息時,這些字串將由行事曆資料欄位的實際值所取代。特殊字元序列由兩個字元組成,第一個為百分比符號 (%),第二個表示特定格式記號。

以下小節說明特殊字元序列︰

E.4.2 Calendar Server 用於事件通知的特殊字元序列

下表顯示事件通知所使用的特殊字元序列的格式代碼和含義。

表 E–34 事件通知的特殊字元序列

格式代碼 

涵義 

%0

本土化格式的起始時間 

%1

本土化格式的結束時間 

%A

iCalendar 格式的 exdates (以分號分隔的 ISO 8601 日期字串清單,可列出要排除的日期)

%a

iCalendar 格式的 rdates (以分號分隔的 ISO 8601 日期字串清單,可列出週期性日期)

%B

起始時間 (另請參閱 %Z)

%b

輸出 iCalendar 格式的起始時間和結束時間。如果起始時間參數具有等於日期的值,則僅輸出日期的月/日/年部分。如果結束時間包含與起始時間相同的月/日/年的值,則僅產生起始時間。 

%C

建立時間 

%c

事件類別 

%d

事件說明。(另請參閱 %F)

%E

結束時間 (另請參閱 %Z)

%e

iCalendar 格式的異常規則 

%F

事件說明 - 可換行,iCalendar 格式 (另請參閱 %d)

%G

事件的地理位置 (緯度和經度) 

%g

組織者的電子郵件位址。(不保證此值的可靠性。) 

%K

mailto:url 格式的組織者電子郵件

%k

警示計數 

%L

位置 

%l

iCalendar 格式的週期性規則 

%M

修改時間 

%N

新一行 

%n

DTSTAMP 配合使用的目前時間戳記

%P

優先順序 

%r

週期性 ID (如果此事件不重複發生,則為空白) 

%S

事件序列號碼 

%s

摘要 

%t

事件狀態 

%U

唯一的事件識別碼 

%Z

與時間欄位代碼合用,以強制時間在 UTC 中被描繪。(%B 以本地時間顯示起始時間,而 %ZB 以 UTC 時間顯示起始時間。)

%%

顯示百分比 (%) 字元

%

指定由代碼識別的資料的子格式。(如需詳細資訊,請參閱E.4.3 Calendar Server 通知日期子格式字串。)

E.4.3 Calendar Server 通知日期子格式字串

日期時間值可採用多種不同的格式。使用子格式,您可以提供附加資訊以說明日期時間值應採用何種格式。如果未指定子格式,伺服器將使用預設格式來輸出日期。使用子格式欄位可讓您指定要使用的確切格式。

例如,%B 指定輸出字串包含事件的起始時間。此預設格式可輸出日期、時間、時區以及有關日期的所有可能內容。日期值的子格式字串為 strftime 格式字串 (請參閱E.4.6 日期的特殊字元序列)。如果您僅需要起始時間的月份和年份,則不應使用 %B,而應使用:%(%m %Y)B

E.4.3.1 範例

以下範例︰


The event begins: %B%N
 The event ends: %(%b %d, %Y %I:%M %p)E%N

可產生類似以下通知的輸出︰


The event begins Feb 02, 1999 23:30:00 GMT Standard Time
 The event ends Feb 03, 1999 02:30 AM

E.4.4 Calendar Server 通知條件式列印格式

有時,您希望僅在特定條件下列印某行。例如,以下行︰


title: %S%N
 start: %B%N
 end: %E%N  

可產生類似以下通知的輸出︰


title: Staff Meeting
 start: Feb 04, 1999 09:00:00
 end: Feb 04, 1999 10:00:00 

但是,以下兩個條件可讓上述範例產生易誤解或錯誤的結果︰

在這些情況下,最好不要列印結束時間。依預設,當時間戳記具有 all-day 屬性時,僅列印年、月和日。此外,如果事件起始時間具有 all-day 屬性,且事件在開始當天結束,則會設定特殊的條件式旗標。僅當未設定特殊的條件式旗標時才使用 ? 修飾鍵來列印條件式值。

例如,如果您將上述範例中的行變更為︰


title: %S%N
 start: %B%N
 end: %?E%N 

同一天開始和結束的整日事件的最後一行將不會列印。它將為典型整日事件 (如生日或紀念日) 產生以下輸出︰


title: Staff Meeting
 start: Feb 04, 1999

? 旗標可與其他修飾鍵結合使用。例如:

The event ends: %?(%b %d, %Y %I:%M %p)E%N

E.4.5 工作通知的特殊字元序列

下表顯示工作通知的特殊字元序列的格式代碼和含義。

表 E–35 工作通知的特殊字元序列

格式代碼 

涵義 

%A

iCalendar 格式的 exdates (以分號分隔的 ISO 8601 日期字串清單,可列出要排除的日期)

%a

iCalendar 格式的 rdates (以分號分隔的 ISO 8601 日期字串清單,可列出週期性日期)

%B

起始時間 (另請參閱 %Z)

%C

建立時間 

%c

工作類別 

%D

截止日期和時間。 

%d

工作說明。(另請參閱 %F)

%E

IMIP 格式的截止日期和時間 

%e

iCalendar 格式的異常規則 

%F

工作說明 - 可換行,iCalendar 格式 (另請參閱 %d)

%G

此工作的地理位置、緯度和經度。 

%g

組織者的電子郵件位址 (無法保證此值的可靠性) 

%K

mailto:URL 格式的組織者電子郵件

%k

警示計數 

%L

位置 

%l

iCalendar 格式的週期性規則 

%M

修改時間 

%N

新一行 

%n

"now" (目前的時間戳記,與 DTSTAMP 配合使用)

%P

優先順序 

%r

週期性 ID (如果此工作不週期性出現,則為空白) 

%S

工作的序列號碼 

%s

摘要 

%t

狀態 

%U

UID

%Z

與時間欄位代碼結合使用,以強制時間以 UTC 格式描繪 (%B 以本地時間顯示起始時間,而 %ZB 以 UTC 時間顯示起始時間)

%%

顯示 % 字元

% (子格式代碼)

為代碼所識別的資料指定子格式 (如需詳細資訊,請參閱E.4.3 Calendar Server 通知日期子格式字串)

E.4.6 日期的特殊字元序列

下表顯示日期特殊字元序列的格式代碼和含義。


備註 –

本小節中出現的特殊日期格式代碼僅為方便使用。Calendar Server 不會重寫任何代碼,而僅使用作業系統所採用的日期格式。


表 E–36 日期的特殊字元序列

格式代碼 

涵義 

%a

縮寫的工作日名稱 

%A

完整的工作日名稱 

%b

縮寫的月份名稱 

%B

完整的月份名稱 

%c

適用於語言環境的日期和時間表示方法 

%d

一月中的某天,十進位數字 (01 - 31)

%H

24 小時制的小時 (00 - 23)

%I

12 小時制的小時 (01 - 12)

%j

一年中的某天,十進位數字 (001 - 366)

%m

月份,十進位數字 (01 - 12)

%M

分鐘,十進位數字 (00 - 59)

%p

目前語言環境的上午/下午指示器 (12 小時制時鐘) 

%S

秒,十進位數字 (00 - 59)

%U

一年中的某一週 (十進位數字),以星期日做為一週的第一天 ( 00 - 53)

%w

工作日,十進位數字 (0 - 6;星期日為 0)

%W

一年中的某一週 (十進位數字),以星期一做為一週的第一天 ( 00 - 53)

%x

目前語言環境的日期表示方法 

%X

目前語言環境的時間表示方法 

%y

不包含世紀的年份,十進位數字 (00 - 99 )

%Y

包含世紀的年份,十進位數字 

%Z

時區名稱或縮寫;如果時區未知,則無字元 

%%

百分比符號 

E.4.7 簡單事件提醒通知範例

以下範例顯示預設事件提醒通知訊息格式︰


1  EVENT REMINDER
 2  ~~MIME-Version: 1.0%N
 3  ~~Content-Type: text/plain; charset=%s%N
 4  ~~Content-Transfer-Encoding: %x%N%N
 5      Summary: %s%N
 6        Start: %(%a, %d %b %Y %I:%M %p)B%N
 7        End: (%a, %d %b %Y %I:%M %p)E%N
 8      Location: %L%N%N
 9  Description: %N%d%N

         

此範例中每行的說明如下︰

以下範例類似上述範例產生的通知訊息︰


From: jsmith@sesta.com (James Smith)
 Date: Wed, 15 Nov 1999 19:13:49
 To: jsmith@sesta.com
 Subject: EVENT REMINDER
 MIME-Version: 1.0
 Content-Type: text/plain; charset=us-ascii
 Content-Transfer-Encoding: 7bit
   Summary: smtp_rig event 1
       Start: Tues, 16 Nov 1999 02:00 PM
       End: Tues, 16 Nov 1999 03:00 PM
   Location: Green Conference Room
   Description: This is the description for a randomly generated event.

E.4.8 複雜事件提醒通知範例

以下範例顯示較為複雜的多重訊息。此範例包含文字部分和 IMIP PUBLISH 部分。


EVENT PUBLICATION
 ~~MIME-Version: 1.0%N
 ~~Content-Type: multipart/mixed; boundary="%b"%N%N
 This is a multi-part message in MIME format.%N
 ~~--%b%N
 ~~Content-Type: text/plain; charset=%s%N
 ~~Content-Transfer-Encoding: %x%N%N
     Summary: %s%N
       Start: %(%a, %d %b %Y %I:%M %p)B%N
       End: %(%a, %d %b %Y %I:%M %p)E%N
     Location: %L%N%N
    Description: %N%d%N%N
 ~~--%b%N
 ~~Content-Type: text/calendar; method=%m; component=%c; charset=%s%N
 ~~Content-Transfer-Encoding: %x%N%N
 BEGIN:VCALENDAR%N
PRODID:-//iPlanet/Calendar Hosting Server//EN%N
 METHOD:PUBLISH%N
 VERSION:2.0%N
 BEGIN:VEVENT%N
 ORGANIZER:%K%N
 DTSTAMP:%Zn%N
 DTSTART:%ZB%N
 DTEND:%ZE%N
 SUMMARY:%s%N
UID:%U%N
 %R
 %A
 %a
 %e
 %l
 SEQUENCE:%S%N
 LOCATION:%L%N
 GEO:%G%N
 %F
 STATUS:%t%N
 END:VEVENT%N
 END:VCALENDAR%N
 ~~--%b--