附錄 E Calendar Server 配置參數

附錄 E
Calendar Server 配置參數

Sun Java™ Calendar Server 配置參數儲存在配置檔案 ics.conf 和 counter.conf 中。

本章提供以下資訊︰

編輯 ics.conf 配置檔案

配置參數 (ics.conf) 檔案

計數器配置 (counter.conf) 檔案

通知訊息

編輯 ics.conf 配置檔案

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

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

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



小心	僅能依 Sun 文件的說明或客戶支援代表的指導來修改 ics.conf 檔案中的參數之設定。例如：Calendar Server 不啟用遠端管理。請勿變更 service.admin.port 參數，因為 Calendar Server 已將其設定為需要的值。否則，csadmind 程序可能無法正確執行。

若要編輯 ics.conf 檔案︰

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

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

使用文字編輯器 (如 Solaris 作業系統上的 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 檔案中，請將參數及其關聯值增加至該檔案。

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

變更 ics.conf 檔案中的參數後，停止然後重新啟動 Calendar Server 以使新的配置值生效。(如果您願意，也可以先停止 Calendar Server，然後再編輯 ics.conf 檔案。)

如需更多資訊，請參閱啟動和停止 Calendar Server。

配置參數 (ics.conf) 檔案

ics.conf 檔案中的配置參數包括︰

本機配置

下表顯示本機配置參數以及每個參數的預設值和說明。

表 E-1 ics.conf 檔案中的本機配置參數
參數	預設值	說明
local.autoprovision	"yes"	啟用 ("yes") 或停用 ("no") Calendar Server 使用者的自動佈建。
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。
local.lookupldap.search.minwildcardsize	"3"	指定與會人員查找搜尋中萬用字元搜尋的最小字串大小。零 (0) 表示始終進行萬用字元搜尋。
local.caldb.deadlock.autodetect	"no"	定期檢查 Berkeley 資料庫是否處於死結狀態，如果是，則指示資料庫重設。
local.enduseradmincred	" "	用於 LDAP 使用者喜好設定認證的連結憑證 (密碼)。
local.enduseradmindn	" "	用於連結 LDAP 使用者喜好設定主機的 DN。必須指定該 DN。如果為 " " (未指定)，則假定為匿名連結。
local.hostname	" "	安裝 Calendar Server 之機器的主機名稱。
local.installeddir	" "	安裝 Calendar Server 的目錄路徑位置。預設為 cal_svr_base/opt/SUNWics5/cal。
local.instancedir	"."	安裝此 Calendar Server 實例之程式和資料的目錄路徑位置。預設為 cal_svr_base/opt/SUNWics5/cal/sbin。
local.plugindir.path	" "	安裝此 Calendar Server 實例之 CSAPI Plug-in 的目錄路徑位置。
local.rfc822header.allow8bit	"n"	允許 (y) 或不允許 (n) 在該伺服器傳送的電子郵件訊息中使用 8 位元標頭。
local.servergid	"icsgroup"	Calendar Server 檔案 (如計數器和日誌) 的群組 ID (GID)。
local.serveruid	"icsuser"	Calendar Server 檔案 (如計數器和日誌) 的使用者 ID (UID)。
local.sitelanguage	"en"	此 Calendar Server 實例的預設語言。
local.smtp.defaultdomain	" "	用於查找與會人員之行事曆 ID (與電子郵件位址對應) 的預設網域名稱。例如，如果此設定的值為 "sesta.com"，則 jsmith 解析為 jsmith@sesta.com。
local.supportedlanguages	"en"	此 Calendar Server 實例支援的使用者語言。
local.ugldapbasedn	" "	LDAP 使用者喜好設定的基底 DN。必須指定此基底 DN，且不能為空。
local.ugldaphost	"localhost"	儲存 LDAP 使用者喜好設定之機器的主機名稱。
local.instance.lockdir.path	cal_svr_base/opt/SUNWics5/cal/lib/lock	指定該伺服器實例之鎖定檔案的儲存位置。
local.instance.pidfile.path	cal_svr_base/etc/opt/SUNWics5/config	指定該伺服器實例之 PID 檔案的儲存位置。
local.instance.counter.path	cal_svr_base/opt/SUNWics5/cal/lib/counter	指定該伺服器實例之計數器檔案的儲存位置。
local.instance.use.tmpfs	"false"	如果為 "true"，則根據 service.http.sessiondir.path 和 service.admin.sessiondir.path 的值覆蓋階段作業資料庫之基於記憶體的檔案系統 (tmpfs)。
local.ugldapicsextendeduserprefs	"ceColorSet, ceFontFace, ceFontSizeDelta, ceDateOrder, ceDateSeparator, ceClock, ceDayHead, ceDayTail, ceInterval, ceToolText, ceToolImage, ceDefaultAlarmStart, ceSingleCalendarTZID, ceAllCalendarTZIDs, ceDefaultAlarmEmail, ceNotifyEmail, ceNotifyEnable, ceDefaultView, ceExcludeSatSun, ceGroupInviteAll"	Calendar Server LDAP 模式延伸的值。
local.ugldapport	"389"	儲存 LDAP 使用者喜好設定之機器的連接埠號。
local.ugldappoolsize	"1"	為 LDAP 使用者喜好設定維護的 LDAP 用戶端連線的最小數目。
local.ugldapmaxpool	"1024"	為 LDAP 使用者喜好設定維護的 LDAP 用戶端連線的最大數目。
local.domain.language	"en"	網域的語言。

行事曆儲存區配置

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

表 E-2 ics.conf 檔案中的行事曆儲存區配置參數
參數	預設值	說明
calstore.anonymous.calid	"anonymous"	用於匿名登入的行事曆 ID (calid)。
user.allow.doublebook	"yes"	決定建立行事曆時使用者行事曆是否可以為同一時段排程一個以上的事件︰ "no" 不允許雙預定。 "yes" 允許雙預定。此參數僅在建立使用者行事曆時才使用。建立使用者行事曆之後，Calendar Server 將檢查行事曆特性 (ics50calprops.db) 以決定是否允許雙預定。如果您需要為使用者行事曆變更行事曆特性以允許或不允許雙預定，請使用帶有 -k 選項的 cscal。
calstore.calendar.default.acl	"@@o^a^r^g;@@o^c^wdeic^g;@^a^fs^g;@^c^^g;@^p^r^g"	指定使用者建立行事曆時所使用的預設存取控制權限。格式由以分號分隔的存取控制項目 (ACE) 引數字串的清單指定。如需有關 ACE 格式的詳細資訊，請參閱行事曆存取控制。若要使用指令行公用程式為一個或多個行事曆指定存取控制項目，請參閱 cscal。
calstore.calendar.owner.acl	"@@o^a^rsf^g;@@o^c^wdeic^g"	指定行事曆所有者的預設存取控制設定。注意：當使用者使用 Calendar Express 使用者介面中的 [私密性] 對話方塊指定存取權限時，它們將以相反的次序套用。例如，@@o^a^rsf^g;@@o^c^wdeic^g 將套用為 @@o^c^wdeic^g;@@o^a^rsf^g。
calstore.calendar.create.lowercase	"no"	指定在建立新行事曆或使用 LDAP CLD Plug-in 查找行事曆時，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" 表示完全展開群組。
calstore.recurrence.bound	"60"	可由週期性擴充建立之事件的最大數目。
calstore.subscribed.include.defaultcalendar	"yes"	指定使用者的預設行事曆是否包含在使用者的訂閱行事曆清單中。
calstore.subscribed.remove.defaultcalendar	"no"	指定是否可以從使用者的訂閱行事曆清單中移除使用者的預設行事曆。
calstore.userlookup.maxsize	"200"	從使用者搜尋的 LDAP 查找傳回之結果的最大數目。值 "0" 表示無限制。
calstore.virtualdomain.mode	"n"	指定 Calendar Server 是否處於受限制的虛擬網域模式中 ("y" 或 "n")。
calstore.unqualifiedattendee.fmt1.type	"uid"	為事件的與會人員執行目錄查找時，指定 Calendar Server 如何處理字串，如 jdoe 或 jdoe:tv。值可為︰ uid cn gid res mailto cap
calstore.unqualifiedattendee.fmt2.type	"mailto"	為事件的與會人員執行目錄查找時，指定 Calendar Server 如何處理帶有 at 符號 (@) 的字串，如 jdoe@foo.com。值可為︰ uid cn gid res mailto cap
calstore.unqualifiedattendee.fmt3.type	"cn"	為事件的與會人員執行目錄查找時，指定 Calendar Server 如何處理帶有空格的字串，如 john doe。值可為︰ uid cn gid res cap
store.partition.primary.path	"."	儲存行事曆資訊之主磁碟分割區的位置。

行事曆日誌資訊配置

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

表 E-3 ics.conf 檔案中的行事曆日誌配置參數
參數	預設值	說明
logfile.admin.logname	"admin.log"	用於記錄管理工具之日誌檔的名稱。
logfile.buffersize	"0"	日誌緩衝區的大小 (以位元組為單位)。
logfile.dwp.logname	"dwp.log"	用於記錄與資料庫連線協定相關的管理工具的日誌檔之名稱。
logfile.expirytime	"604800"	日誌檔過期之前的秒數。
logfile.flushinterval	"60"	清除日誌檔緩衝區的間隔秒數。
logfile.http.logname	"http.log"	cshttpd 服務之目前日誌檔的名稱。
logfile.http.access.logname	"httpd.access"	目前 http 存取日誌檔的名稱。
logfile.logdir	"logs"	日誌檔的目錄位置。
logfile.loglevel	"Notice"	決定伺服器將記錄的詳細資訊層級。每個日誌項目均被指定以下層級之一 (從最嚴重的開始)︰CRITICAL、ALERT、ERROR、WARNING、NOTICE、INFORMATION 和 DEBUG。如果您設定為 CRITICAL，Calendar Server 則記錄最少的詳細資訊。如果您想要伺服器記錄最多的詳細資訊，請指定 DEBUG。例如，如果設定為 WARNING，則僅記錄 CRITICAL、ERROR 和 WARNING 層級的日誌項目。
logfile.maxlogfiles	"10"	日誌目錄中日誌檔的最大數目。
logfile.maxlogfilesize	"2097152"	每個日誌檔的最大大小 (以位元組為單位)。
logfile.maxlogsize	"20971520"	用於儲存所有日誌檔的最大磁碟空間 (以位元組為單位)。
logfile.minfreediskspace	"5242880"	必須可用於記錄的最小可用磁碟空間 (以位元組為單位)。達到此值後，Calendar Server 將嘗試透過清除舊日誌檔來釋放磁碟空間。如果空間無法被釋放，記錄將暫停。
logfile.notify.logname	"notify.log"	csnotifyd 服務的日誌檔名稱。
logfile.rollovertime	"86400"	旋轉日誌檔之前的秒數。

服務配置

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

表 E-4 ics.conf 檔案中的服務配置參數
參數	預設值	說明
service.authcachesize	"10000"	Calendar Server 將維護的已認證使用者 ID (UID) 和密碼的最大數目。
service.authcachettl	"900"	快取使用者 UID 和密碼之前的秒數。
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"	指定建立資源行事曆時所使用的預設存取控制權限。
service.admin.alarm	"yes"	啟用 ("yes") 或停用 ("no") 管理工具的警示通知。
service.admin.calmaster.cred	" "	被指定為 Calendar Server 管理員之使用者 ID 的密碼。此值在安裝時提供，而且是安裝程式所必需的。
service.admin.calmaster.userid	"calmaster"	被指定為 Calendar Server 管理員之人員的使用者 ID。此值在安裝時提供，而且是安裝程式所必需的。
service.admin.calmaster.overrides.accesscontrol	"no"	指示 Calendar Server 管理員是否可以置換存取控制。
service.admin.calmaster.wcap.allowgetmodifyuserprefs	"no"	指示 Calendar Server 管理員是否可以使用 WCAP 指令取得和設定使用者喜好設定。
service.admin.checkpoint	"yes"	如果為 "yes"，則啟動 csadmind 資料庫的檢查點執行緒。
service.admin.dbcachesize	"8388608"	用於管理階段作業之 Berkeley 資料庫的最大快取記憶體大小 (以位元組為單位)。
service.admin.deadlock	"yes"	如果為 "yes"，則啟動 csadmind 資料庫的死結偵測執行緒。
service.admin.diskusage	"no"	如果為 "yes"，則啟動 csadmind 的低磁碟空間監視執行緒。
service.admin.enable	"yes"	如果為 "yes"，則在啟動所有服務時啟動 csadmind 服務，並在停止所有服務時停止 csadmind。
service.admin.idletimeout	"120"	使 HTTP 連線在 csadmind 中逾時之前的秒數。
service.admin.ldap.enable	"yes"	如果為 "yes"，則為 service.admin.calmaster.userid 中所指定使用者的使用者認證啟用 LDAP。
service.admin.maxsessions	"100"	所允許的管理階段作業的最大數目。
service.admin.maxthreads	"10"	每個管理階段作業的執行中執行緒的最大數目。
service.admin.numprocesses		所允許的並行運作之管理程序的最大數目。
service.admin.port CAUTION	不可用	請勿自行設定此參數。此參數由系統設定。您無法在 Calendar Server 上進行遠端管理。如果您變更此連接埠號，csadmind 可能無法啟動。
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.domainname	" "	此安裝的網域名稱。
service.dnsresolveclient	"no"	如果為 "yes"，系統將根據 DNS 檢查用戶端 IP 位址 (如果允許 HTTP 存取)。
service.http.admins	"calmaster"	以空格分隔的對此 Calendar Server 具有管理權限之使用者 ID 的清單。
service.http.allowadminproxy	"no"	如果為 "yes"，則允許經由代理登入。
service.http.allowanonymouslogin	"yes"	如果為 "yes"，則允許匿名 (無登入) 存取。
service.http.calendarhostname	" "	用於擷取 HTML 文件的 HTTP 主機。若要讓使用者使用完全合格的主機名稱存取行事曆資料，該值必須為執行 Calendar Server 的機器之完全合格的主機名稱 (包括機器名稱、DNS 網域和字尾)，如 mycal@sesta.com。如果未指定，則使用本機 HTTP 主機。
service.http.cookies	"yes"	告知伺服器是否支援 cookie (yes/no)。必須將此值設定為 "yes" 才能啟用單次登入。
service.http.dbcachesize	"8388608"	用於 HTTP 階段作業之 Berkeley 資料庫的最大快取記憶體大小。
service.http.domainallowed	" "	如果已指定且不為 " "，則進行過濾以允許基於 TCP 網域的存取。例如，"ALL:LOCAL.sesta.com" 將允許對 sesta.com 網域中的任何人進行本機 HTTP 存取。多個過濾器由 CR-LF (換行) 分隔。
service.http.domainnotallowed	" "	如果已指定且不為 " "，則進行過濾以拒絕基於 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.logaccess	"no"	如果為 "yes"，則完全記錄至伺服器的 HTTP 連線。
service.http.maxsessions	"5000"	cshttpd 服務中 HTTP 階段作業的最大數目。
service.http.maxthreads	"20"	cshttpd 服務中 HTTP 所請求服務之執行緒的最大數目。
service.http.numprocesses	"1"	應在某個伺服器上執行之並行運作的 HTTP 服務 (cshttpd) 程序的最大數目。對於具有多個 CPU 的伺服器，請參閱使用跨多個 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	"/var/opt/SUNWics5/tmp"	相對於可執行檔的目錄，其中儲存檔案的所有 URL 參照。
service.http.uidir.path	"html"	包含預設行事曆用戶端的目錄。如果僅允許 WCAP 存取，則設定為 ""。
service.http.renderhtml	"no"	為 Calendar Express 中的事件啟用或停用 [事件標題] 和 [說明] 欄位中 HTML 和 JavaScript 的描繪。描繪不適用於事件的任何其他文字欄位或工作的任何文字欄位。
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.http.listenaddr	"INADDR_ANY"	在 Solaris 作業系統上，指定 HTTP 服務將為用戶端請求偵聽的 TCP 位址。"INADDR_ANY" 表示任一位址。
service.plaintextloginpause	"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.allowcreatecalendars	"yes"	如果為 "yes"，則允許建立行事曆。
service.wcap.allowdeletecalendars	"yes"	如果為 "yes"，則允許刪除行事曆。
service.wcap.allowchangepassword	"no"	如果為 "yes"，則允許使用者經由該伺服器變更他們的密碼。
service.wcap.allowpublicwritablecalendars	"yes"	如果為 "yes"，則允許使用者擁有公開可寫入的行事曆。
service.wcap.allowsetprefs.cn	"no"	如果為 "yes"，則允許 set_userprefs.wcap 屬性修改使用者喜好設定 "cn" (LDAP 使用者的一般名稱)。
service.wcap.allowsetprefs.givenname	"no"	如果為 "yes"，則允許 set_userprefs.wcap 屬性修改使用者喜好設定 "givenname" (LDAP 使用者的給定名稱)。
service.wcap.allowsetprefs.icsCalendar	"no"	如果為 "yes"，則允許 set_userprefs.wcap 屬性修改使用者喜好設定 "icsCalendar" (使用者的預設行事曆識別碼)。
service.wcap.allowsetprefs.mail	"no"	如果為 "yes"，則允許 set_userprefs.wcap 屬性修改使用者喜好設定 "mail" (使用者的電子郵件位址)。
service.wcap.allowsetprefs.preferredlanguage	"no"	如果為 "yes"，則允許 set_userprefs.wcap 屬性修改使用者喜好設定 "preferredlanguage" (LDAP 使用者的喜好語言)。
service.wcap.allowsetprefs.sn	"no"	如果為 "yes"，則允許 set_userprefs.wcap 屬性修改使用者喜好設定 "sn" (LDAP 使用者的姓氏)。
service.wcap.allowsetprefs.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 版本。

SSL 配置

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

service.http.ssl.usessl = yes

service.http.ssl.port.enable = yes

表 E-5 顯示 ics.conf 參數及其預設設定。驗證您的 ics.conf 參數是否具有適當的值：

表 E-5 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"	在 SSL 配置中，將此值變更為 yes。指定 cshttpd 程序是否應使用 SSL 子系統。
service.http.ssl.port.enable	"no" 若要啟用 SSL，請設定為：yes	在 SSL 配置中，將此值變更為 yes。指定 HTTPS 是否在 HTTP 連接埠上偵聽，從而使其成為 SSL 連接埠。注意：此操作不會使 HTTP 程序無法偵聽此同一連接埠。
service.http.ssl.port	"443"	指定 cshttpd 程序的 SSL 連接埠號，系統將在此處接收來自 Calendar Server 使用者的 HTTPS 請求。
service.http.ssl.securelogin	"yes"	指定是否加密登入。
service.http.ssl.securesession	"yes"	指定是否加密整個階段作業。
service.http.ssl.certdb.path	"alias"	指定 SSL 證書資料庫的實體路徑位置。
service.http.ssl.certdb.password	"password"	指定 SSL 證書資料庫的存取密碼。
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-6 託管網域支援的配置參數
參數	預設值	說明
service.virtualdomain.support	"n"	啟用 ("y") 或停用 ("n") 對託管 (虛擬) 網域的支援。
local.schemaversion	"1"	指定 LDAP 模式的版本： "1" = Sun LDAP 模式 1。另請參閱 service.dcroot。 "2" = Sun LDAP 模式 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。

警示通知配置

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

表 E-7 ics.conf 檔案中的警示通知配置參數
參數	預設值	說明
alarm.diskstat.msgalarmdescription	"percentage calendar partition diskspace available"	與磁碟空間不足訊息一起傳送的說明。
alarm.diskstat.msgalarmstatinterval	"3600"	監視磁碟空間的間隔秒數。
alarm.diskstat.msgalarmthreshold	"10"	觸發傳送警告訊息的可用磁碟空間百分比。
alarm.diskstat.msgalarmthresholddirection	"-1"	alarm.diskavail.msgalarmthreshold 是高於還是低於百分比。-1 為低於，1 為高於。
alarm.diskstat.msgalarmwarninginterval	"24"	傳送有關磁碟空間不足警告訊息的間隔小時數。
alarm.diskavail.msgalarmdescription	"percentage calendar partition diskspace available"	伺服器磁碟空間不足時傳送的警告文字。
alarm.diskavail.msgalarmstatinterval	"3600"	伺服器在每次檢查可用磁碟空間之間等待的秒數。
alarm.diskavail.msgalarmthreshold	"10"	觸發伺服器傳送警告訊息的可用磁碟空間百分比。
alarm.diskavail.msgalarmthresholddirection	"-1"	alarm.diskavail.msgalarmthreshold 是高於還是低於可接受的百分比。-1 為低於，1 為高於。
alarm.diskavail.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 %u\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"	傳送發出的有關無服務回應警告訊息的間隔小時數。

行事曆查找資料庫配置

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

表 E-8 ics.conf 檔案中的行事曆查找資料庫 (CLD) 參數
參數	預設值	說明
csapi.plugin.calendarlookup	"n"	啟用 ("y") 或停用 ("n") 行事曆查找 Plug-in。
csapi.plugin.calendarlookup.name	"*"	指定要載入的特定行事曆查找 Plug-in 的名稱。如果此值為星號 ("*")，Calendar Server 將載入所有 Plug-in。
caldb.cld.type	"local"	指定要使用的 CLD Plug-in 的類型︰ "local" 指定所有行事曆均儲存在本機伺服器上，該伺服器正在執行 Calendar Server 且未載入任何 Plug-in。 "directory" 指定 LDAP CLD Plug-in，此 Plug-in 使用行事曆所有者的 icsDWPHost LDAP 屬性以決定儲存指定行事曆的伺服器。
caldb.dwp.server.default = "server-name"	" "	如果 LDAP 伺服器資料庫中的使用者行事曆項目或資源行事曆項目不具有 icsDWPHost 屬性，該參數將指定 Calendar Server 所使用之完全合格的預設 DWP 伺服器名稱。如果透過 Calendar Express 或使用 WCAP 指令登入 Calendar Server 的使用者不具有 icsDWPHost 屬性，Calendar Server 將使用此參數自動佈建屬性。如果使用者已經具有 icsDWPHost 屬性，則不使用 caldb.dwp.server.default。該名稱必須可被您的網域名稱服務 (DNS) 解析成有效的 IP 位址。
caldb.cld.cache.enable	"yes"	啟用 ("yes") 或停用 ("no") 行事曆查找資料庫 (CLD) 的快取記憶體選項。若要獲得 LDAP CLD Plug-in 的最佳效能，請設定為 "yes"。
caldb.cld.cache.logfilesizemb	"10"	為 CLD 快取記憶體指定檢查點檔案的最大大小 (以百萬位元組為單位)。
caldb.cld.cache.mempoolsizemb	"4"	指定 CLD 快取記憶體選項的共用大小 (以百萬位元組為單位)。
caldb.cld.cache.maxthread	"1000"	為 CLD 快取記憶體選項指定資料庫執行緒的最大數目。
caldb.cld.cache.homedir.path	"."	為 CLD 快取記憶體選項指定資料庫事件、工作和警示檔案的位置。預設值 "." 指定這些檔案儲存在 cal_svr_base/var/opt/SUNWics5/csdb/cld_cache 目錄中。
caldb.cld.cache.checkpointinterval	"60"	為 CLD 快取記憶體選項指定檢查點檢查的間隔秒數。
caldb.cld.cache.circularlogging	"yes"	指定為 CLD 快取記憶體選項同步化檢查點檔案之後是否移除這些檔案。
caldb.dwp.server.host-name.ip = "host-name"	" "	指定儲存行事曆資料庫之伺服器的主機名稱。伺服器必須在執行 DWP (csdwpd) 服務。該名稱必須可被您的網域名稱服務 (DNS) 解析成有效的 IP 位址。此參數由 LDAP CLD Plug-in 使用。注意：在參數的每個部分中，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	"n"	指定伺服器是否執行所有資料庫連線協定服務請求的 MD5 (Message Digest 5) 單向雜湊檢查。(單向雜湊功能用於建立訊息認證的數位簽名。) "n" 停用 MD5 雜湊檢查。 "y" 啟用 MD5 雜湊檢查。
caldb.dwp.server.hostname.ip	" "	指定在指定機器的主機名稱中使用資料庫連線協定 (DWP) 服務之伺服器的 IP 位址。
caldb.dwp.server.hostname.port	"9779"	指定在指定機器的主機名稱中使用資料庫連線協定 (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 Plug-in 用於行事曆尋找機制時要向其認證的基底 DN。
caldb.cld.directory.ldaphost		LDAP Plug-in 用於行事曆尋找機制時要存取之 LDAP 伺服器的主機名稱。
caldb.cld.directory.ldapbindcred		LDAP Plug-in 用於行事曆尋找機制時在 local.authldapbinddn 設定中指定的使用者連結憑證 (密碼)。
caldb.cld.directory.ldapbinddn		LDAP Plug-in 用於行事曆尋找機制時用於連結認證以搜尋使用者 DN 的 DN。
caldb.cld.directory.ldapport	"389"	LDAP Plug-in 用於行事曆尋找機制時要存取之 LDAP 伺服器的連接埠號。
csapi.plugin.authentication	"n"	如果為 "y"，則僅載入 csapi.plugin.authentication.name 中指定的 Plug-in，如果未指定，則按字母順序載入所有認證類別 Plug-in。對於認證，則按字母順序使用每個 Plug-in。
csapi.plugin.authentication.name	" "	如果 csapi.plugin.loadall 為 "n" 且 csapi.plugin.authentication 為 "y"，則僅載入此特定 Plug-in。如果未指定或為 " "，則載入所有認證類別 Plug-in。
logfile.dwp.buffersize	"0"	資料庫連線協定服務日誌緩衝區的大小 (以位元組為單位)。
logfile.dwp.expirytime	"604800"	資料庫連線協定服務日誌檔過期之前的秒數。
logfile.dwp.flushinterval	"60"	清除資料庫連線協定服務日誌檔緩衝區的間隔秒數。
logfile.dwp.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 的伺服器，請參閱使用跨多個 CPU 的負載平衡功能。
service.dwp.enable	"no"	如果為 "yes"，則在啟動所有服務時啟動 csdwpd 服務，並在停止所有服務時停止 csdwpd。
service.dwp.idletimeout	"86400"	關閉閒置的資料庫連線協定服務的永久性連線之前的時間 (以秒為單位)。
service.dwp.port	"59779"	資料庫連線協定服務偵聽的連接埠號。此值為 LDAP CLD Plug-in 的預設連接埠。
service.dwp.ldap.enable	"yes"	為資料庫連線協定 (csdwpd) 服務的遠端使用者認證啟用 ("yes") 或停用 ("no") LDAP。
service.calendarsearch.ldap	"yes"	指定 Calendar Server 是先搜尋 LDAP 目錄然後搜尋行事曆資料庫 ("yes")，還是僅搜尋行事曆資料庫 ("no")。

單次登入 (SSO) 配置

透過 Identity Server 配置 SSO

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

透過 Identity Server 配置 SSO

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

表 E-9 ics.conf 檔案中的 SSO 配置參數 (透過 Identity Server)
參數	預設值	說明
local.calendar.sso.singlesignoff	"yes"	啟用 ("yes") 或停用 ("no") Calendar Server 的 SSO。
local.calendar.sso.amcookiename	"iPlanetDirectoryPro"	指定 Identity Server SSO cookie 的名稱。
local.calendar.sso.amnamingurl	"http://IdentityServer:port/amserver/namingservice"	指定 Identity Server SSO 命名服務的 URL。
local.calendar.sso.amloglevel	3	指定 Identity Server SSO 的日誌級別。範圍為從 1 (無訊息) 到 5 (詳細)。
local.calendar.sso.logname	"am_sso.log"	指定 Identity Server SSO API 日誌檔的名稱。

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

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

表 E-10 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.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 = "verifyurl"	" "	指定同層 SSO 主機的驗證 URL 值。每個信任的同層主機均需要一個參數。 appid 是其 SSO cookie 將被信任的同層 SSO 主機的應用程式 ID。對於 Calendar Server，appid 為 ics50。 "verifyurl" 可識別以下格式的信任同層主機的 URL︰"http://host:port/VerifySSO?"。請勿省略 VerifySSO 後面的問號 (?)。主機為主機的 URL，連接埠為主機的連接埠號。例如，對於 sesta.com 上連接埠號為 8883 的 Calendar Server︰ sso.ics50.url = "http://sesta.com:8883/VerifySSO?"

群組排程引擎 (GSE) 配置

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

表 E-11 ics.conf 檔案中的群組排程引擎 (GSE) 配置參數
參數	預設值	說明
gse.autorefreshreplystatus	"yes"	指定啟用還是停用自動更新功能。如果啟用自動更新，在與會人員回覆事件召集人後，該與會人員的回覆狀態將自動傳遞給此排程事件的其他與會人員。 "yes" 啟用自動更新。 "no" 停用自動更新。
gse.belowthresholdtimeout	"3"	指定伺服器開始掃描送進工作的排程佇列之前應等待的時間 (以秒為單位)。如果佇列中的工作多於所配置執行緒的最大數目，則最後一個執行緒將始終重新掃描工作佇列。因此，僅當工作數目小於所配置執行緒的最大數目時，此設定才能生效。增加此數目可減少伺服器掃描工作佇列的頻率，並提高整體效能。
gse.maxthreads	"10"	指定伺服器用於處理排程佇列的並行運作執行緒的最大數目。每個執行緒處理佇列中的一個工作。
gse.retryexpiredinterval	"86400"	指定伺服器將重試以完成群組排程工作的最大時間長度 (以秒為單位)。如果時間超出指定的最大時間長度，伺服器會將工作視為重試過期狀態並報告錯誤。請注意，預設值 86400 秒相當於一天。
gse.retryinterval	"300"	指定伺服器重試先前失敗工作的間隔時間 (以秒為單位)。伺服器僅在遇到網路錯誤時才重試失敗的工作。但是，伺服器會將大多數此類錯誤視為嚴重錯誤，且不進行重試。
gse.stacksize	"65535"	指定群組排程執行緒的最大堆疊大小 (以位元組為單位)。

資料庫配置

下表顯示資料庫配置參數以及每個參數的預設值和說明。

表 E-12 ics.conf 檔案中的資料庫配置參數
參數	預設值	說明
caldb.berkeleydb.checkpointinterval	"60"	檢查點檢查資料庫異動的間隔秒數。
caldb.berkeleydb.circularlogging	"yes"	如果為 "yes"，則在同步化資料庫檢查點檔案的異動後移除這些檔案。
caldb.berkeleydb.deadlockinterval	"100"	檢查需要被打破的資料庫死結的間隔毫秒數。
caldb.berkeleydb.homedir.path	"."	儲存資料庫事件、工作和警示檔案的目錄 (程式可執行檔的相對位置或指定的絕對路徑)。預設為 "."，它指定︰ cal_svr_base/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"	指定 cal_svr_base/etc/opt/SUNWics5/config 下包含本土化版本檔案的目錄，這些檔案可用於格式化電子郵件通知。例如，"en" 指定英語本土化版本的目錄，"fr" 指定法語本土化版本的目錄。
caldb.smtpport	"25"	SMTP 主機的連接埠。

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

表 E-13 說明參數、預設值和說明。如果需要預設以外的值，您必須將參數增加至 ics.conf 檔案。

表 E-13 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"。

Calendar Server API 配置

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

表 E-14 ics.conf 檔案中的 CSAPI 配置參數
參數	預設值	說明
csapi.plugin.authentication	"n"	如果為 ("y")，則僅載入 csapi.plugin.authentication.name 中指定的 Plug-in。
csapi.plugin.accesscontrol	"n"	啟用 ("y") 或停用 ("n") 存取控制 Plug-in。
csapi.plugin.authentication	"n"	如果為 "y"，則僅載入 csapi.plugin.authentication.name 中指定的 Plug-in，如果未指定，則按字母順序載入所有認證類別 Plug-in。對於認證，則按字母順序使用每個 Plug-in。
csapi.plugin.authentication.name	" "	如果 csapi.plugin.loadall 為 "n" 且 csapi.plugin.authentication 為 "y"，則僅載入此特定 Plug-in。如果未指定或為 " "，則載入所有認證類別 Plug-in。
csapi.plugin.database	"y"	如果為 "y"，則僅載入 csapi.plugin.database.name 中指定的 Plug-in，如果未指定，則按字母順序載入所有資料庫 Plug-in。
csapi.plugin.database.name	"cs_caldb_berkeley10"	如果 csapi.plugin.loadall 為 "n" 且 csapi.plugin.database 為 "y"，則僅載入此 Plug-in。如果未指定或為 " "，則按字母順序載入所有資料庫 Plug-in。
csapi.plugin.datatranslator	"y"	如果為 "y"，則僅載入 csapi.plugin.datatranslator.name 中指定的 Plug-in，如果未指定，則按字母順序載入所有資料轉換器類別 Plug-in。對於資料轉換，則按字母順序使用每個 Plug-in。
csapi.plugin.datatranslator.name	"cs_datatranslatorcsv10"	如果 csapi.plugin.loadall 為 "n" 且 csapi.plugin.datatranslator 為 "y"，則使用此參數。如果未指定或為 " "，則載入所有資料轉換器類別 Plug-in。否則，僅載入此特定 Plug-in。
csapi.plugin.dbtranslator	"y"	啟用 ("y") 或停用 ("n") 資料庫至輸出格式的 Plug-in。
csapi.plugin.dbtranslator.name	"*"	如果 csapi.plugin.dbtranslator 設定為 "y"，則︰如果此值為 "*"，載入所有資料庫至輸出格式的 Plug-in。如果此值為程式庫名稱，僅載入此特定 Plug-in。如果 csapi.plugin.dbtranslator 為 "n"，則忽略此設定。
csapi.plugin.loadall	"n"	如果為 "y"，則載入 Plug-in 目錄中的所有 Plug-in。對於 Solaris 作業系統，這些 Plug-in 均具有 .so 副檔名。如果為 "n"，則僅載入其各自參數標記的特定類別的 Plug-in。例如，將 csapi.plugin.authentication 設定為 yes 可以載入認證類別 Plug-in。
csapi.plugin.userprefs	"n"	如果為 "y"，則僅載入 csapi.plugin.userprefs.name 中指定的 Plug-in，如果未指定，則按字母順序載入所有使用者喜好設定類別 Plug-in。對於使用者喜好設定，則按字母順序使用每個 Plug-in。
csapi.plugin.userprefs.name	" "	如果 csapi.plugin.loadall 為 "n" 且 csapi.plugin.userprefs 為 "y"，則使用此參數。如果未指定或為 " "，則載入所有使用者喜好設定類別 Plug-in。否則，僅載入此特定 Plug-in。

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

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

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

表 E-15 ics.conf 檔案中的事件通知伺服器 (ENS) 配置參數
參數	預設值	說明
service.ens.enable	"yes"	如果為 "yes"，則在啟動所有服務時啟動 enpd 服務，並在停止所有服務時停止 enpd。
service.ens.host	"localhost"	執行事件通知伺服器之機器的主機名稱。
service.ens.port	"57997"	執行事件通知伺服器之機器的連接埠號。
service.ens.library	"xenp"	事件通知伺服器 Plug-in 的名稱。
service.notify.enable	"yes"	如果為 "yes"，則在啟動所有服務時啟動 csnotifyd 服務，並在停止所有服務時停止 csnotifyd。
service.notify.maxretrytime	"-1"	csnotifyd 將持續重試且無法聯絡事件通知伺服器的次數。 "-1" 可導致警示執行緒無限制重試。
service.notify.retryinterval	"3"	連線失敗後嘗試重新聯絡事件通知伺服器之前，csnotifyd 等待的時間 (以秒為單位)。
service.notify.startupretrytime	"0"	Calendar Server 在停止前保持嘗試聯絡事件通知伺服器的總秒數。此設定類似 caldb.serveralarms.maxretrytime，除了僅在警示執行緒首先啟動時才適用。一旦警示執行緒成功啟動，將使用 caldb.serveralarms.maxretrytime。 "0" 告知警示執行緒若在啟動時無法連線至事件通知伺服器，則立即結束。
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" - 透過將修改事件通知發佈至各自主題︰caldb.berkeleydb.ensmsg.replyevent、caldb.berkeleydb.ensmsg.refreshevent 或 caldb.berkeleydb.ensmsg.modifyevent，以在回覆、更新或修改異動之間區別。 "no" - 將修改事件通知發佈至 caldb.berkeleydb.ensmsg.modifyevent 主題，而不管異動是回覆、更新還是修改。
caldb.berkeleydb.ensmsg.createevent	"no"	如果為 "yes"，則在建立事件時建立事件通知服務訊息嗎？
caldb.berkeleydb.ensmsg.deleteevent	"no"	如果為 "yes"，則在刪除事件時建立 ENS 訊息嗎？
caldb.berkeleydb.ensmsg.modifyevent	"no"	如果為 "yes"，則在修改事件時建立 ENS 訊息嗎？
caldb.berkeleydb.ensmsg.refreshevent	"no"	指定 ("yes" 或 "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"	指定 ("yes" 或 "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"	指定事件通知伺服器的警示執行緒在發佈警示通知後，等待 csnotifyd 回應的秒數。如果逾時過期，警示執行緒將假定警示通知不再處理，並會再次發佈警示通知。
caldb.serveralarms.dispatchtype	"ens"	指定 Calendar Server 警示的派送類型︰ "ens" 告知伺服器使用外部事件通知伺服器來傳送和接收警示。 "smtp" 告知伺服器將警示作為標準 SMTP 訊息傳送，且繞過事件通知伺服器。
caldb.serveralarms.initthreads	"10"	事件通知伺服器執行緒的最初數目。
caldb.serveralarms.maxretrytime	"-1"	警示執行緒將持續重試且無法聯絡事件通知伺服器的次數。 "-1" 可導致警示執行緒無限制重試。
caldb.serveralarms.maxthreads	"10"	事件通知伺服器執行緒的最大數目。
caldb.serveralarms.retryinterval	"5"	警示執行緒 (在 csadmind 中) 在嘗試重新聯絡事件通知伺服器之前等待的時間 (以秒為單位)。
caldb.serveralarms.stacksize	"65536"	事件通知伺服器執行緒的堆疊框架大小。
caldb.serveralarms.startupretrytime	"0"	Calendar Server 在失敗前保持嘗試聯絡事件通知伺服器的總秒數。此設定類似 caldb.serveralarms.maxretrytime 設定，除了僅在警示執行緒首先啟動時才適用。一旦警示執行緒成功啟動，將使用 caldb.serveralarms.maxretrytime。 "0" 告知警示執行緒若在啟動時無法連線至事件通知伺服器，則立即結束。
caldb.smtphost	"localhost"	將警示電子郵件傳送至該 SMTP 主機。

使用者介面 (UI) 配置

下表顯示使用者介面 (UI) 配置參數以及每個參數的預設值和說明。

表 E-16 ics.conf 檔案中的使用者介面配置參數
參數	預設值	說明
ui.config.file	" "	Calendar Server 可以在啟動時讀取能夠隱藏部分使用者介面的選擇性、基於 xml 的配置檔案。Calendar Server 僅允許一個配置檔案，且此設定的值決定要使用之檔案的名稱。Calendar Server 可在使用者介面 xml 和 xslt 檔案所在的資料目錄中查找此檔案，該資料目錄為︰ cal_svr_base/opt/SUNWics5/cal/data Calendar Server 可提供以下提供使用者介面自訂版本的檔案︰ nogroup_config.xml - 停用群組排程 ui_config.xml - 預設使用者介面
ui.allow.anyone	"yes"	允許 Calendar Express 顯示並使用「所有使用者」存取控制清單 (ACL)。
ui.allow.domain	"no"	允許 Calendar Express 顯示並使用「此網域」存取控制清單 (ACL)。
ui.proxyaddress.url	" "	指定要在 HTML UI JavaScript 檔案中前置的代理伺服器位址。例如："https://web_portal.sesta.com/"
ui.base.url	" "	指定基底伺服器位址。例如："https://proxyserver"
ine.invitation.enable	"yes"	控制事件邀請的通知︰ "yes" - 已傳送通知。 "no" - 未傳送通知。
ine.cancellation.enable	"yes"	控制事件取消的通知︰ "yes" - 已傳送通知。 "no" - 未傳送通知。
ui.eventdialog.inform.enable	"no"	指定在使用者建立或編輯事件時，Calendar Express 是否應顯示 [通知事件] 選項。
ui.toolbar.repainting.enable	"yes"	啟用 ("yes") 或停用 ("no") Calendar Express 工具列的 [重新繪製] (或 [更新])。設定為 "no" 可以提昇效能，因為不執行工具列的 XML 和 XSLT 變換。如果設定為 "no"，則按一下任一檢視上的 [更新] 可使 Calendar Express 使用者返回預設檢視。如果已啟用瀏覽器快取記憶體選項 (下一個參數)，則不使用工具列的 [重新繪製] 選項。
browser.cache.enable	"no"	啟用 ("yes") 或停用 ("no") 瀏覽器快取記憶體選項。如需更多資訊，請參閱使用更新檢視選項。
render.xslonclient.enable	"yes"	透過將 XSLT 處理工作下載至一般使用者的瀏覽器，可以啟用 ("yes") 或停用 ("no") 用戶端描繪。如需更多資訊，請參閱用戶端瀏覽器中的 XSL 描繪。

csmonitor 公用程式配置

下表顯示 csmonitor 公用程式配置參數以及每個參數的預設值和說明。

表 E-17 ics.conf 檔案中的 csmonitor 公用程式配置參數
參數	預設值	說明
service.monitor.continuous	"0"	指定 csmonitor 是否應持續迴圈︰ "0" - 不持續迴圈。 "1" - 持續迴圈。此選項需要較多的系統資源，但在除錯模式下十分有用。
service.monitor.loopsdelay	"60"	指定兩個監視迴圈之間的延遲 (以秒為單位)。
service.monitor.emailaddress.from	無	指定 csmonitor 傳送訊息的電子郵件位址。
service.monitor.emailaddress.to	無	指定 csmonitor 應將訊息傳送至的電子郵件位址。
service.monitor.csdb.logthreshold	"90"	指定被視為正常的最大磁碟佔用率的臨界值 (以總磁碟空間的百分比表示)。如果行事曆資料庫 (csdb 目錄) 所在磁碟的佔用率超出此值，csmonitor 將傳送警告電子郵件訊息。
logfile.monitor.logname	"csmonitor.log"	指定 csmonitor 日誌檔名稱。
logfile.monitor.maxlogfilesize	"2097152"	指定日誌檔的最大大小。如果日誌檔超出此大小，csmonitor 會將日誌儲存為 csmonitor.log.timestamp，並重設日誌。
service.monitor.dbglevel	"0"	指定除錯級別。此值越高，csmonitor 傳送的訊息就越精確、越詳細。

計數器配置 (counter.conf) 檔案

Calendar Server 計數器 (統計資料) 配置參數位於以下檔案中︰

cal_svr_base/etc/opt/SUNWics5/config/counter.conf

counter.conf 檔案為 ASCII 文字檔案，每行定義一個計數器及其參數︰名稱、類型、大小 (以位元組為單位) 和說明。包含空格的參數必須置於雙引號 (" ") 中。註釋行必須以驚嘆號 (!) 開頭。註釋行僅用於提供資訊。

計數器名稱的第一部分可識別與 csstats 公用程式配合使用的計數器物件。如需有關指令行公用程式的更多資訊，請參閱附錄 D 「Calendar Server 指令行公用程式參照」。



注意	請勿修改 counter.conf 檔案，除非客戶支援人員指導您這樣做。

本小節說明 Calendar Server counter.conf 參數，包括︰

警示計數器

下表顯示每個警示計數器的名稱、類型、大小和說明。

表 E-18 counter.conf 檔案中的警示計數器
名稱	類型	大小	說明
alarm.high	GAUGE	4	最高記錄值。
alarm.low	GAUGE	4	最低記錄值。
alarm.current	GAUGE	4	目前監視值。
alarm.warningstate	GAUGE	4	警告狀態︰是 (1) 或否 (0)。
alarm.countoverthreshold	COUNTER	4	超出臨界值的次數。
alarm.countwarningsent	COUNTER	4	已傳送的警告數目。
alarm.timelastset.desc	TIME	4	最後一次設定目前值的時間。
alarm.timelastwarning	TIME	4	最後一次傳送警告的時間。
alarm.timereset	TIME	4	最後一次執行重設的時間。
alarm.timestatechanged.desc	TIME	4	最後一次變更警示狀態的時間。

磁碟使用率計數器

下表顯示每個磁碟使用率計數器的名稱、類型、大小和說明。

表 E-19 counter.conf 檔案中的磁碟使用率計數器
名稱	類型	大小	說明
diskusage.availSpace	GAUGE	5	磁碟分割區中的可用空間總量。
diskusage.lastStatTime	TIME	4	最後一次取得統計資料的時間。
diskusage.calPartitionPath	STRING	512	行事曆分割區路徑。
diskusage.percentAvail	GAUGE	4	磁碟分割區的可用空間百分比。
diskusage.totalSpace	GAUGE	5	磁碟分割區的空間總量。

HTTP 計數器

下表顯示每個 HTTP 計數器的名稱、類型、大小和說明。

表 E-20 counter.conf 檔案中的 HTTP (httpstat) 計數器
名稱	類型	大小	說明
httpstat.avgConnectionTime	GAUGE	4	平均連線回應時間。
httpstat.currentStartTime	TIME	4	Calendar Server 的啟動時間。
httpstat.lastConnectionTime	TIME	4	最後一次接受新用戶端連線的時間。
httpstat.maxConnections	COUNTER	4	允許的並行運作連線的最大數目。
httpstat.maxSessions	COUNTER	4	允許的 WCAP 階段作業的最大數目。
httpstat.numConnections	COUNTER	4	允許的連線的總數。
httpstat.numCurrentConnections	GAUGE	4	作用中連線的目前數目。
httpstat.numCurrentSessions	GAUGE	4	WCAP 階段作業的目前數目。
httpstat.numFailedConnections	COUNTER	4	允許的失敗連線的總數。
httpstat.numGoodLogins.desc	COUNTER	4	由目前 HTTP 伺服器提供服務之成功登入的數目。
httpstat.numFailedLogins	COUNTER	4	由目前 HTTP 伺服器提供服務之失敗登入的數目。

群組排程計數器

下表顯示每個群組排程引擎 (GSE) 計數器的名稱、類型、大小和說明。

表 E-21 counter.conf 檔案中的群組排程引擎 (GSE) 計數器
名稱	類型	大小	說明
gsestat.lastWakeUpTime	TIME	4	GSE 最後一次喚醒並處理工作的時間。
gsestat.lastJobProcessedTime	TIME	4	GSE 最後一次處理工作的時間。
gsestat.numJobsProcessed	COUNTER	4	GSE 所處理的工作總數。
gsestat.numActiveWorkerThreads	COUNTER	4	作用中工作者執行緒的總數。

認證計數器

下表顯示每個認證計數器的名稱、類型、大小和說明。

表 E-22 counter.conf 檔案中的認證 (authstat) 計數器
名稱	類型	大小	說明
authstat.lastLoginTime	TIME	4	使用者最後一次登入的時間。
authstat.numSuccessfulLogins	COUNTER	4	允許的成功登入的總數。
authstat.numFailedLogins	COUNTER	4	允許的失敗登入的總數。

WCAP 計數器

下表顯示每個 WCAP 計數器的名稱、類型、大小和說明。

表 E-23 counter.conf 檔案中的 WCAP (wcapstat) 計數器
名稱	類型	大小	說明
wcapstat.numRequests	COUNTER	4	WCAP 請求的總數。

資料庫計數器

下表顯示每個資料庫計數器的名稱、類型、大小和說明。

表 E-24 counter.conf 檔案中的資料庫 (dbstat) 計數器
名稱	類型	大小	說明
dbstat.numReads	COUNTER	4	資料庫讀取作業的總次數。
dbstat.numWrites	COUNTER	4	資料庫寫入作業的總次數。
dbstat.numDeletes	COUNTER	4	資料庫刪除作業的總次數。
dbstat.lastReadTime	TIME	4	資料庫最後一次讀取的時間。
dbstat.lastWriteTime	TIME	4	資料庫最後一次寫入的時間。
dbstat.lastDeleteTime	TIME	4	資料庫最後一次刪除的時間。

伺服器回應計數器

下表顯示每個伺服器回應計數器的名稱、類型、大小和說明。

表 E-25 counter.conf 檔案中的伺服器回應計數器
名稱	類型	大小	比例	說明
serverresponse.lastStatTime	TIME	4		最後一次取得統計資料的時間。
serverresponse.responseTime	GAUGE	4	2	伺服器回應時間 (以毫秒為單位)。

階段作業狀態計數器

下表顯示每個階段作業狀態計數器的名稱、類型、大小和說明。

表 E-26 counter.conf 檔案中的階段作業狀態計數器
名稱	類型	大小	比例	說明
sessstat.maxSessions.desc	COUNTER	4	4	允許的 HTTP 階段作業的最大數目。
sessstat.numCurrentSessions	GAUGE	4	2	HTTP 階段作業的目前數目。

通知訊息

Calendar Server 可傳送表 E-27 中說明的各種類型的電子郵件訊息。這些訊息的格式由表中列出的關聯格式 (.fmt) 檔案控制。格式檔案位於以下目錄的每個本機特定目錄 (如 /en 為英語，/fr 為法語) 中︰

cal_svr_base/etc/opt/SUNWics5/config

例如，英文版本的工作警示訊息格式在以下檔案中指定︰

cal_svr_base/etc/opt/SUNWics5/config/en/mail_todoalarm.fmt

本小節說明以下內容：

Calendar Server Mail 參數

Calendar Server Mail 參數

下表顯示每個 Calendar Server Mail 參數的訊息類型、參數名稱、預設格式檔案說明以及收信人。

表 E-27 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.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-28 事件通知的特殊字元序列
格式代碼	涵義
%0	本土化格式的起始時間
%1	本土化格式的結束時間
%A	iCalendar 格式的 exdates (以分號分隔的 ISO8601 日期字串清單，可列出要排除的日期)
%a	iCalendar 格式的 rdates (以分號分隔的 ISO8601 日期字串清單，可列出週期性日期)
%B	起始時間 (另請參閱 %Z)
%b	輸出 iCalendar 格式的起始時間和結束時間。如果起始時間包含參數 value=date，則僅輸出日期的月/日/年部分。如果結束時間包含與起始時間相同的月/日/年的值，則僅產生起始時間。
%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	唯一的事件識別碼
%u	事件的 URL
%Z	與時間欄位代碼合用，以強制時間在 UTC 中被描繪。(%B 以本地時間顯示起始時間，而 %ZB 則以 UTC 時間顯示起始時間。)
%%	顯示百分比 (%) 字元
% (子格式代碼)	指定由代碼識別的資料之子格式。(如需詳細資訊，請參閱日期子格式。)

日期子格式

日期-時間值可採用多種不同的格式。使用子格式，您可以提供附加資訊以說明日期-時間值應採用何種格式。如果未指定子格式，伺服器將使用預設格式來輸出日期。使用子格式欄位可讓您指定要使用的確切格式。

例如，%B 指定輸出字串包含事件的起始時間。此預設格式可輸出日期、時間、時區以及有關日期的所有可能內容。日期值的子格式字串為 strftime 格式的字串 (請參閱日期的特殊字元序列)。如果您僅需要起始時間的月份和年份，應使用 %(%m %Y)B，而不是 %B。

範例

以下範例︰

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

條件列印

有時，您希望僅在特定條件下列印某行。例如，以下行︰

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-29 工作通知的特殊字元序列
格式代碼	涵義
%A	iCalendar 格式的 exdates (以分號分隔的 ISO8601 日期字串清單，可列出要排除的日期)
%a	iCalendar 格式的 rdates (以分號分隔的 ISO8601 日期字串清單，可列出週期性日期)
%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
%u	工作的 URL
%Z	與時間欄位代碼合用，以強制時間在 UTC 中被描繪 (%B 以本地時間顯示起始時間，而 %ZB 以 UTC 時間顯示起始時間)
%%	顯示 % 字元
% (子格式代碼)	指定由代碼識別的資料之子格式 (如需詳細資訊，請參閱「日期子格式」)

日期的特殊字元序列

下表顯示日期特殊字元序列的格式代碼和含義。



註	本小節中出現的特殊日期格式代碼僅為方便使用。Calendar Server 不會重寫任何 strftime 代碼，而僅使用作業系統所採用的日期格式。

表 E-30 日期的特殊字元序列
格式代碼	涵義
%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	目前語言環境的 A.M./P.M. 指示器 (12 小時制時鐘)
%S	秒，十進位數字 (00 - 59)
%U	一年中的某一週 (十進位數字)，以星期日作為一週的第一天 (00 - 53)
%w	工作日，十進位數字 (0 - 6；星期日為 0)
%W	一年中的某一週 (十進位數字)，以星期一作為一週的第一天 (00 - 53)
%x	目前語言環境的日期表示方法
%X	目前語言環境的時間表示方法
%y	不包含世紀的年份，十進位數字 (00 - 99)
%Y	包含世紀的年份，十進位數字
%Z	時區名稱或縮寫；如果時區未知，則無字元
%%	百分比符號

簡單事件提醒通知範例

以下範例顯示預設事件提醒通知訊息格式︰

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

此範例中每行的說明如下︰

第 1 行為訊息主題。

第 2 行以 ~~ 開頭，指出此為 MIME 包裝行。即特殊字元序列的取代與內部 MIME 物件 (而不是事件或工作) 關聯。特殊序列 %N 可以換行。主題行不需要特殊的新行序，但其他所有行均需要。

第 3 行也是 MIME 標頭行。它包含特殊字元序列 %s，此特殊字元序列將由與傳送的事件或工作關聯的字元集所取代。

第 4 行為最後一個 MIME 行，%x 為此訊息所需的內容傳輸編碼字串。

第 5 行列出事件摘要並以 %s 呼叫事件摘要。

第 6 行列出事件起始時間。它充份利用了特殊字元序列 %B 上的子格式字串。如需詳細資訊，請參閱「日期子格式」。

第 7 行列出事件結束時間。

第 8 行列出事件的位置。

第 9 行列出事件的說明。

以下範例類似上述範例產生的通知訊息︰

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.

複雜事件提醒通知範例

以下範例顯示較為複雜的多重訊息。此範例包含文字部分和 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--

上一個目錄索引下一個

上一個目錄索引下一個
Sun Java System Calendar Server 管理指南