Sun Java System Calendar Server 管理指南 |
附錄 E
Calendar Server 配置參數Sun Java Calendar Server 配置參數儲存在配置檔案 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 檔案中的參數。參數的慣例包括︰
- 變更 ics.conf 檔案中的參數後,停止然後重新啟動 Calendar Server 以使新的配置值生效。(如果您願意,也可以先停止 Calendar Server,然後再編輯 ics.conf 檔案。)
如需更多資訊,請參閱啟動和停止 Calendar Server。
配置參數 (ics.conf) 檔案ics.conf 檔案中的配置參數包括︰
本機配置
下表顯示本機配置參數以及每個參數的預設值和說明。
行事曆儲存區配置
下表顯示行事曆儲存區配置參數以及每個參數的預設值和說明。
表 E-2 ics.conf 檔案中的行事曆儲存區配置參數
參數
預設值
說明
calstore.anonymous.calid
"anonymous"
用於匿名登入的行事曆 ID (calid)。
user.allow.doublebook
"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︰
無效值會導致伺服器使用 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。值可為︰
calstore.unqualifiedattendee.fmt2.type
"mailto"
為事件的與會人員執行目錄查找時,指定 Calendar Server 如何處理帶有 at 符號 (@) 的字串,如 jdoe@foo.com。值可為︰
calstore.unqualifiedattendee.fmt3.type
"cn"
為事件的與會人員執行目錄查找時,指定 Calendar Server 如何處理帶有空格的字串,如 john doe。值可為︰
store.partition.primary.path
"."
儲存行事曆資訊之主磁碟分割區的位置。
行事曆日誌資訊配置
下表顯示行事曆日誌配置參數以及每個參數的預設值和說明。
服務配置
下表顯示服務配置參數以及每個參數的預設值和說明。
表 E-4 ics.conf 檔案中的服務配置參數
參數
預設值
說明
service.authcachesize
"10000"
Calendar Server 將維護的已認證使用者 ID (UID) 和密碼的最大數目。
service.authcachettl
"900"
快取使用者 UID 和密碼之前的秒數。
resource.allow.doublebook
"no"
決定建立行事曆時從屬於某一資源 (如會議室或聲訊視頻設備) 的行事曆是否可以為同一時段排程一個以上的事件︰
此參數僅在建立資源行事曆時才使用。
建立資源行事曆之後,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 值,如下所示:
表 E-5 顯示 ics.conf 參數及其預設設定。驗證您的 ics.conf 參數是否具有適當的值:
託管網域配置
下表顯示託管 (虛擬) 網域配置參數以及每個參數的預設值和說明。
警示通知配置
下表顯示警示通知伺服器配置參數以及每個參數的預設值和說明。
行事曆查找資料庫配置
下表顯示行事曆查找資料庫 (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) 單向雜湊檢查。(單向雜湊功能用於建立訊息認證的數位簽名。)
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
下表顯示您使用 Identity Server 時的 SSO 配置參數以及每個參數的預設值和說明。
透過通訊伺服器信任圈技術配置 SSO
下表顯示使用通訊伺服器信任圈技術時的 SSO 配置參數以及每個參數的預設值和說明。
群組排程引擎 (GSE) 配置
下表顯示群組排程引擎 (GSE) 配置參數以及每個參數的預設值和說明。
資料庫配置
下表顯示資料庫配置參數以及每個參數的預設值和說明。
ENS 訊息的行事曆資料庫參數
表 E-13 說明參數、預設值和說明。如果需要預設以外的值,您必須將參數增加至 ics.conf 檔案。
Calendar Server API 配置
表 E-14 顯示 Calendar Server API (CSAPI) 配置參數以及每個參數的預設值和說明。
事件通知伺服器 (ENS) 配置
可以將 Calendar Server 配置為使用稱為事件通知伺服器 (ENS) 的外部通用服務,該服務可接受按特定興趣分類的伺服器層級事件報告,並可通知其他已對特定種類的事件進行註冊的伺服器。Calendar Server 使用 ENS 來傳送和接收警示通知 (包括建立、刪除或修改行事曆事件和工作),以及一般作業警告和錯誤訊息。
表 E-15 顯示 ics.conf 中的事件通知伺服器 (ENS) 配置參數以及每個參數的預設值和說明。
使用者介面 (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 可提供以下提供使用者介面自訂版本的檔案︰
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 公用程式配置參數以及每個參數的預設值和說明。
計數器配置 (counter.conf) 檔案Calendar Server 計數器 (統計資料) 配置參數位於以下檔案中︰
cal_svr_base/etc/opt/SUNWics5/config/counter.conf
counter.conf 檔案為 ASCII 文字檔案,每行定義一個計數器及其參數︰名稱、類型、大小 (以位元組為單位) 和說明。包含空格的參數必須置於雙引號 (" ") 中。註釋行必須以驚嘆號 (!) 開頭。註釋行僅用於提供資訊。
計數器名稱的第一部分可識別與 csstats 公用程式配合使用的計數器物件。如需有關指令行公用程式的更多資訊,請參閱附錄 D 「Calendar Server 指令行公用程式參照」。
本小節說明 Calendar Server counter.conf 參數,包括︰
警示計數器
下表顯示每個警示計數器的名稱、類型、大小和說明。
磁碟使用率計數器
下表顯示每個磁碟使用率計數器的名稱、類型、大小和說明。
HTTP 計數器
下表顯示每個 HTTP 計數器的名稱、類型、大小和說明。
群組排程計數器
下表顯示每個群組排程引擎 (GSE) 計數器的名稱、類型、大小和說明。
認證計數器
下表顯示每個認證計數器的名稱、類型、大小和說明。
表 E-22 counter.conf 檔案中的認證 (authstat) 計數器
名稱
類型
大小
說明
authstat.lastLoginTime
TIME
4
使用者最後一次登入的時間。
authstat.numSuccessfulLogins
COUNTER
4
允許的成功登入的總數。
authstat.numFailedLogins
COUNTER
4
允許的失敗登入的總數。
WCAP 計數器
下表顯示每個 WCAP 計數器的名稱、類型、大小和說明。
資料庫計數器
下表顯示每個資料庫計數器的名稱、類型、大小和說明。
伺服器回應計數器
下表顯示每個伺服器回應計數器的名稱、類型、大小和說明。
表 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 透過將特定事件或工作與格式檔案內容相結合,來產生通知訊息。事件或工作中資料欄位的值可輸出至訊息。通知訊息還可以包含 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。
範例
以下範例︰
可產生類似以下通知的輸出︰
條件列印
有時,您希望僅在特定條件下列印某行。例如,以下行︰
可產生類似以下通知的輸出︰
但是,以下兩個條件可讓上述範例產生易誤解或錯誤的結果︰
在這些情況下,最好不要列印結束時間。依預設,當時間標記具有 all-day 屬性時,則僅列印年、月和日。此外,如果事件起始時間具有 all-day 屬性且事件在開始當天結束,則會設定特殊條件旗標。僅在未設定特殊條件旗標時使用 ? 修飾鍵來列印條件值。
例如,如果您將上述範例中的行變更為︰
同一天開始和結束的整日事件的最後一行將不會列印。它將為典型整日事件 (如生日或紀念日) 產生以下輸出︰
? 旗標可與其他修飾鍵結合使用。例如:
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 時間顯示起始時間)
%%
顯示 % 字元
% (子格式代碼)
指定由代碼識別的資料之子格式 (如需詳細資訊,請參閱「日期子格式」)
日期的特殊字元序列
下表顯示日期特殊字元序列的格式代碼和含義。
簡單事件提醒通知範例
以下範例顯示預設事件提醒通知訊息格式︰
此範例中每行的說明如下︰
- 第 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--