第 3 章管理 Calendar Server

您可以透過執行指令行公用程式和編輯 ics.conf 配置檔案來管理 Calendar Server。

若要執行指令行公用程式，您必須以對 Calendar Server 執行時所在的系統具有管理權限的使用者身份登入。

啟動和停止 Calendar Server

使用 start-cal 和 stop-cal 公用程式


註	Calendar Server 提供 csstart 和 csstop 公用程式僅為與舊版相容。建議您使用 start-cal 和 stop-cal 公用程式來啟動和停止 Calendar Server。

start-cal 和 stop-cal 公用程式位於 cal_svr_base/opt/SUNWics5/cal/sbin 目錄中。您必須在安裝 Calendar Server 的本機上執行這些公用程式。如需瞭解可能會發生的問題，請參閱疑難排解 start-cal 和 stop-cal 公用程式。

enpd — 事件通知服務 (ENS)

csnotifyd — 通知服務

csadmind — 管理服務

csdwpd — 資料庫連線協定 (DWP) 服務，此分散式資料庫服務僅透過遠端 Calendar Server 資料庫配置才能啟動

cshttpd — HTTP 服務

若要使用 start-cal 指令啟動 Calendar Server，請：

以對系統具有管理權限的使用者身份登入。

變更至 cal_svr_base/opt/SUNWics5/cal/sbin 目錄。

啟動 CalendarServer：

./start-cal

若要使用 stop-cal 指令停止 Calendar Server，請：

以對 Calendar Server 執行時所在的系統具有管理權限的使用者身份登入。

變更至 cal_svr_base/opt/SUNWics5/cal/sbin 目錄。

停止 Calendar Server：

./stop-cal

疑難排解 start-cal 和 stop-cal 公用程式

start-cal 公用程式未啟動所有的 Calendar Server 程序。例如，start-cal 可能啟動了 enpd、csnotifyd 和 csadmind 程序，但未啟動 cshttpd。在此情況下，您必須停止所有的 Calendar Server 程序，然後嘗試重新啟動 Calendar Server。

stop-cal 公用程式未停止所有的 Calendar Server 程序。例如，stop-cal 可能停止了 cshttpd 父程序，而未停止任何 cshttpd 子程序。在此情況下，您必須停止其餘 Calendar Server 程序。

若要在 Solaris 系統上停止 Calendar Server 程序，請：

以對 Calendar Server 執行時所在的系統具有管理權限的使用者身份登入。

透過為每種服務輸入 ps 指令，確定其餘 Calendar Server 程序的程序 ID (PID)：

ps -elf | grep cs-process

其中，cs-process 為 enpd、csnotifyd、csdwpd、csadmind 或 cshttpd。例如：

ps -elf | grep cshttpd

使用仍在執行的各程序的 PID，輸入 pkill -15 指令終止該程序。例如：

pkill -15 9875

再次輸入各 ps 指令，確定所有 Calendar Server 程序均已停止。

如果某個 Calendar Server 程序仍在執行，請輸入 pkill -9 指令終止該程序。例如：

pkill -9 9875


小心	停止所有 Calendar Server 程序之後，在重新啟動 Calendar Server 之前，請考量執行 csdb 公用程式 check 指令，以檢查是否已發生任何行事曆資料庫損毀。如需有關 check 指令的資訊，請參閱檢查與重建行事曆資料庫。

配置 Calendar Server 逾時值

配置 csadmind 的逾時值

配置一般使用者的 HTTP 逾時值

配置 csadmind 的逾時值

表格 3-1 描述 ics.conf 檔案中由管理 (csadmin) 服務使用的 Calendar Server 逾時參數。

表格 3-1 管理服務 (csadmin) 的 HTTP 逾時值
參數	說明
service.admin.idletimeout	指定 csadmind 服務在使閒置的 HTTP 連線逾時之前等待的秒數。預設為 120 秒 (2 分鐘)。
service.admin.resourcetimeout	指定 csadmind 服務在使資源行事曆的 HTTP 階段作業逾時之前等待的秒數。預設為 900 秒 (15 分鐘)。
service.admin.sessiontimeout	指定 csadmind 服務在使 HTTP 階段作業逾時之前等待的秒數。預設為 1800 秒 (30 分鐘)。

配置一般使用者的 HTTP 逾時值

表格 3-2 描述 ics.conf 檔案中套用於一般使用者的 Calendar Server HTTP 逾時參數。

表格 3-2 ics.conf 中用於一般使用者的 HTTP 逾時值 (cshttpd 服務)
參數	說明
service.http.idletimeout	指定 cshttpd 服務在使閒置的 HTTP 連線逾時之前等待的秒數。預設為 120 秒 (2 分鐘)。
service.http.resourcetimeout	指定 cshttpd 服務在使資源行事曆的 HTTP 階段作業逾時之前等待的秒數。預設為 900 秒 (15 分鐘)。
service.http.sessiontimeout	指定 cshttpd 服務在使 HTTP 階段作業逾時之前等待的秒數。預設為 1800 秒 (30 分鐘)。

配置單一登入 (SSO)

單一登入 (SSO) 允許使用者認證一次，即可使用多個信任的應用程式，而無需再次認證。Sun ONE 通訊伺服器 (包括 Calendar Server 和 Messaging Server) 可以按照以下說明實施 SSO：

透過 Identity Server 配置 SSO

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

透過 Identity Server 配置 SSO

Sun ONE 伺服器 (包括 Calendar Server 和 Messaging Server) 可以使用 Sun ONE Identity Server 6.1 或更高版本實施 SSO。

Identity Server 充當 Sun ONE 伺服器的 SSO 閘道。也就是說，只要其他 Sun ONE 伺服器被正確配置為使用 SSO，使用者登入 Identity Server 後便可存取這些伺服器。

確定已安裝並配置了 Sun ONE Identity Server 和 Sun ONE Directory Server。如需有關安裝和配置這些產品的資訊，請參閱「Sun Java Enterprise System 安裝指南」。

為 Calendar Server 配置 SSO 的方法是設定表格 3-3 所示的參數，然後重新啟動 Calendar Server 以使值生效。如有必要，請在設定各參數時移除註釋字元 (!)。

注意當您設定 local.calendar.sso.amnamingurl 參數時，必須使用完全合格的 Identity Server 名稱。

若要為 Messaging Server 配置 SSO，請參閱「Sun ONE Messaging Server 6.0 管理員指南」。

使用者使用其 Directory Server LDAP 使用者名稱和密碼登入 Identity Server。(透過另一台伺服器 [如 Calendar Server 或 Messaging Server] 登入的使用者將無法使用 SSO 來存取其他 Sun ONE 伺服器。)

登入之後，使用者可以使用適當的 URL，透過 Calendar Express 存取 Calendar Server。如果其他 Sun ONE 伺服器 (如 Messaging Server) 被正確配置為使用 SSO，使用者也可以存取這些伺服器。

表格 3-3 用於透過 Identity Server 使用 SSO 的 Calendar Server 配置參數
參數	說明
local.calendar.sso.amnamingurl	指定 Identity Server SSO 命名服務的 URL。預設為 "http://IdentityServer:port/amserver/namingservice" 其中 IdentityServer 是完全合格的 Identity Server 名稱，而 port 是 Identity Server 連接埠號。
local.calendar.sso.amcookiename	指定 Identity Server SSO cookie 的名稱。預設為 "iPlanetDirectoryPro"。
local.calendar.sso.amloglevel	指定 Identity Server SSO 的日誌級別。範圍為從 1 (無訊息) 到 5 (詳細)。預設為 "3"。
local.calendar.sso.logname	指定 Identity Server SSO API 日誌檔的名稱。預設為 "am_sso.log"。
local.calendar.sso.singlesignoff	啟用 ("yes") 或停用 ("no") 從 Calendar Server 到 Identity Server 的單一登出。如果已啟用，則登出 Calendar Server 的使用者還會登出 Identity Server，並且使用者透過 Identity Server 啟動的所有其他階段作業 (如 Messaging Server 網路郵件階段作業) 都會終止。由於 Identity Server 是認證閘道，因此通常已啟用從 Identity Server 到 Calendar Server 的單一登出。預設為 "yes"。

透過 Identity Server 使用 SSO 的注意事項

只要 Identity Server 階段作業有效，行事曆階段作業就有效。如果使用者登出 Identity Server，則行事曆階段作業會自動關閉 (單一登出)。

SSO 應用程式必須位於同一網域中。

SSO 應用程式必須可以存取 Identity Server 驗證 URL (命名服務)。

瀏覽器必須支援 cookie。

如果您使用的是 Sun ONE Portal Server 閘道，請設定以下 Calendar Server 參數：

service.http.ipsecurity="no"

render.xslonclient.enable="no"

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

透過通訊伺服器信任圈技術 (即不透過 Identity Server) 配置 SSO 時，請考量以下幾點：

每個信任的應用程式必須配置為使用 SSO。

如果 default.html 頁面位於瀏覽器的快取記憶體中，則 SSO 無法正常運作。使用 SSO 之前，請務必重新載入瀏覽器中的 default.html 頁面。例如，在 Netscape Navigator 中，按住 Shift 鍵，然後按一下 [重新載入]。

SSO 僅作用於主幹 URL。例如，SSO 可作用於 http://servername，但不能作用於 http://servername/command.shtml?view 之類的 URL。

表格 3-4 描述透過通訊伺服器信任圈技術使用 SSO 的 Calendar Server 配置參數。

表格 3-4 透過通訊伺服器信任圈技術使用的 Calendar Server SSO 參數
參數	說明
sso.enable = "1"	此參數必須設定為 "1" (預設) 才能啟用 SSO。設定為 "0" 會停用 SSO。
sso.appid = "ics50"	此參數指定用於特定 Calendar Server 安裝的唯一應用程式 ID。每個信任應用程式也必須具有唯一應用程式 ID。預設為 "ics50"。
sso.appprefix = "ssogrp1"	此參數指定用於格式化 SSO cookie 的字首值。所有信任應用程式都必須使用同一值，因為 Calendar Server 僅能識別帶有此字首的 SSO cookie。預設為 "ssogrp1"。
sso.cookiedomain = ".sesta.com"	此參數可使瀏覽器僅向指定網域中的伺服器傳送 cookie。該值必須以句點 (.) 開頭。
sso.singlesignoff = "true"	如果值為 "true" (預設)，則在用戶端登出時清除該用戶端上字首值符合 sso.appprefix 中配置的值的所有 SSO cookie。
sso.userdomain = "sesta.com"	此參數可將使用的網域設定為使用者 SSO 認證的一部分。
sso.appid.url = "verifyurl" 例如： sso.ics50.url = "http://sesta.com:8883/VerifySSO?" sso.msg50.url = "http://sesta.com:8882/VerifySSO?"	此參數會為 Calendar Server 配置設定同層 SSO 主機的驗證 URL 值。每個信任同層 SSO 主機都需要一個參數。此參數包括：應用程式 ID (appid)，用於識別 SSO cookie 將被接受的每個同層 SSO 主機。驗證 URL ("verifyurl")，包括主機 URL、主機連接埠號和 VerifySSO? (包括結尾 ?)。在此範例中，Calendar Server 應用程式 ID 為 ics50，主機 URL 為 sesta.com，連接埠為 8883。 Messenger Express 應用程式 ID 為 msg50，主機 URL 為 sesta.com，連接埠為 8882。

表格 3-5 描述透過通訊伺服器信任圈技術使用 SSO 的 Messaging Server 配置參數。

表格 3-5 透過通訊伺服器信任圈技術使用的 Messaging Server SSO 參數
參數	說明
local.webmail.sso.enable = 1	此參數必須設定為非零值才能啟用 SSO。
local.webmail.sso.prefix = ssogrp1	此參數指定在格式化由 HTTP 伺服器設定的 SSO cookie 時使用的字首。
local.webmail.sso.id = msg50	此參數指定用於 Messaging Server 的唯一應用程式 ID (msg50)。每個信任應用程式也必須具有唯一應用程式 ID。
local.webmail.sso.cookiedomain = sesta.com	此參數指定由 HTTP 伺服器設定的所有 SSO cookie 的 cookie 網域值。
local.webmail.sso.singlesignoff = 1	如果設定為非零值，則在用戶端登出時清除該用戶端上字首值符合 local.webmail.sso.prefix 中配置的值的所有 SSO cookie。
local.sso.appid.url = "verifyurl" 例如： local.sso.ics50.verifyurl = http://sesta.com:8883/VerifySSO? local.sso.msg50.verifyurl = http://sesta.com:8882/VerifySSO?	此參數會為 Messaging Server 配置設定同層 SSO 主機的驗證 URL 值。每個信任同層 SSO 主機都需要一個參數。此參數包括以下項目：應用程式 ID (appid)，用於識別 SSO cookie 將被接受的每個同層 SSO 主機。驗證 URL ("verifyurl")，包括主機 URL、主機連接埠號和 VerifySSO? (包括結尾 ?)。在此範例中，Messaging Server 應用程式 ID 為 msg50，主機 URL 為 sesta.com，連接埠為 8882。 Calendar Express 應用程式 ID 為 ics50，主機 URL 為 sesta.com，連接埠為 8883。

如需有關配置 Messaging Server 為使用 SSO 的更多資訊，請參閱「Sun ONE Messaging Server 6.0 管理員指南」。

配置 LDAP 行事曆查找資料庫 (CLD) 外掛程式

LDAP CLD 外掛程式允許在多台後端伺服器上為單一行事曆實例分佈使用者行事曆和資源行事曆，從而提供行事曆資料庫水平可延伸性。LDAP CLD 外掛程式使用 icsDWPHost 性質確定某個行事曆所在的後端伺服器。


註	在 Calendar Server 5.1.1 和更高版次中，CLD 外掛程式的主要版本號碼從 1 變更為 2。次要版本號碼仍為 0。如果您自己已撰寫 CLD 外掛程式，則必須修改該外掛程式，以支援這一新的主要版本號碼。

LDAP CLD 外掛程式如何運作

用於 LDAP CLD 外掛程式的 Calendar Server 配置

LDAP CLD 外掛程式如何運作

LDAP CLD 外掛程式允許將行事曆資料庫分佈在多台後端伺服器上。資料庫中的每個行事曆都由唯一行事曆 ID (calid) 標識，其格式如下：

userid 是 Calendar Server 實例的唯一使用者 ID。

domain 是使用者的可選網域名稱。

calendar-name 是特定使用者唯一的可選行事曆名稱。

Calendar Server 會按照如下說明存取後端伺服器上的行事曆資料：

當 Calendar Express 一般使用者存取行事曆時，LDAP CLD 外掛程式會從行事曆的 calid 中擷取 userid，然後在 LDAP 伺服器資料庫中查找行事曆所有者。

找到行事曆所有者之後，該外掛程式會使用所有者的 icsDWPHost LDAP 性質確定行事曆所在的後端伺服器之主機名稱。該主機名稱必須可被您的網域名稱服務 (DNS) 解析成有效的 IP 位址。

使用主機名稱，Calendar Server 可使用資料庫連線協定 (DWP) 存取後端伺服器上的行事曆資料。DWP 是一個內部協定，它會以 csdwpd 服務的形式來執行，並為行事曆資料庫提供網路功能。

使用 DWP，Calendar Server 可將行事曆資料傳送至使用者登入的伺服器，然後 Calendar Express 會將該資料描繪在一般使用者的瀏覽器中。



註	如果您的站台使用的是 LDAP CLD 外掛程式並使用 cscal 公用程式建立新行事曆，則按照使用者的 icsDWPHost LDAP 性質所示，必須在使用者的行事曆所在 (或將在) 的同一後端伺服器上建立新的行事曆。如果您嘗試在其他後端伺服器上建立行事曆，Calendar Server 將傳回錯誤。如需更多資訊，請參閱 cscal。

用於 LDAP CLD 外掛程式的 Calendar Server 配置

多台前端伺服器與多台後端伺服器

多台前端/後端伺服器

執行同一 Solaris 作業系統。

執行同一 Calendar Server 版次 (包括修補程式)。

將同一連接埠號用於 DWP 連接埠 (service.dwp.port 參數)。預設連接埠號為 "59779"。

多台前端伺服器與多台後端伺服器

下圖顯示執行單一 Calendar Server 實例的兩台前端伺服器和兩台後端伺服器。如果願意，您還可以配置兩台以上的前端或後端伺服器。

此配置可讓伺服器受到防火牆，以限制對 LDAP 和行事曆資料庫的存取。行事曆資料庫分佈在兩台後端伺服器上。

前端伺服器的 CPU 使用率很高，CPU 大部分時間都用於描繪一般使用者的行事曆資料。後端伺服器的磁碟使用率很高，CPU 大部分時間都用於存取行事曆資料庫。

配置前端伺服器

若要配置前端伺服器，請在每台前端伺服器上的 ics.conf 檔案中設定以下參數。

啟用行事曆資料庫查找外掛程式：

csapi.plugin.calendarlookup = "y"

指定 Calendar Server 載入所有外掛程式：

csapi.plugin.calendarlookup.name = "*"

設定用於 LDAP CLD 外掛程式的行事曆查找外掛程式類型：

caldb.cld.type = "directory"

設定 DWP 服務 (csdwpd) 的連接埠號：

service.dwp.port = "59779"

預設為 "59779"。所有已配置的前端和後端伺服器的連接埠號必須相同。

設定該配置中每台後端伺服器的伺服器名稱：

caldb.dwp.server.backend-server-1.ip = "backend-server-1"
caldb.dwp.server.backend-server-2.ip = "backend-server-2"
...
caldb.dwp.server.backend-server-n.ip = "backend-server-n"

伺服器名稱必須完全合格，並且可由您的網域名稱服務 (DNS) 解析成有效的 IP 位址。在該參數的各個部分中，伺服器名稱必須完全相同並且完全合格。例如：

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

伺服器名稱還必須符合適當行事曆所有者的 icsDWPHost LDAP 性質所使用的名稱。

設定預設 DWP 伺服器名稱：

caldb.dwp.server.default = "server-name"

其中 server-name 是 Calendar Server 所使用的完全合格的預設伺服器名稱 (如果在 LDAP 伺服器資料庫中使用者或資源項目沒有 icsDWPHost 性質)。該名稱必須可被您的網域名稱服務 (DNS) 解析成有效的 IP 位址。例如：

caldb.dwp.server.default = "calendar.sesta.com"

重新啟動 Calendar Server 以使變更生效。

用於前端伺服器的範例配置參數

以下範例顯示用於一台前端伺服器與兩台後端伺服器 (名為 calendar.sesta.com 和 calendar.siroe.com) 的配置參數。預設 DWP 伺服器為 calendar.sesta.com。

配置後端伺服器

若要配置後端伺服器，請在每台後端伺服器上的 ics.conf 檔案中設定以下參數。

啟用 DWP 服務 (csdwpd) 並設定 DWP 連接埠號：

service.dwp.enable = "y"
service.dwp.port = "59779"

預設連接埠號為 "59779"。所有已配置的前端和後端伺服器的連接埠號必須相同。

停用 HTTP 服務，因為後端伺服器不需要該服務 (管理服務應設定為預設值 "yes")：

service.http.enable = "no"
service.admin.enable = "yes"

設定用於 LDAP CLD 外掛程式的行事曆查找外掛程式類型：

caldb.cld.type = "local"

將 csapi.plugin.calendarlookup 設定為 "n"，因為後端伺服器不需要查找任何行事曆資料：

csapi.plugin.calendarlookup = "n"

重新啟動 Calendar Server 以使變更生效。

用於後端伺服器的範例配置參數

多台前端/後端伺服器

下圖顯示三台前端/後端伺服器，每台伺服器都連線至行事曆資料庫。此配置可讓行事曆分佈於不同的地理區域，各行事曆位於其所有者登入 Calendar Server 時所在的伺服器上。

配置前端/後端伺服器

若要配置前端/後端伺服器，請在每台伺服器上的 ics.conf 檔案中設定以下參數。

啟用 DWP 服務 (csdwpd)：

service.dwp.enable = "y"

設定 DWP 服務 (csdwpd) 的連接埠號：

service.dwp.port = "59779"

預設為 "59779"。所有已配置的前端和後端伺服器的連接埠號必須相同。

啟用行事曆查找外掛程式：

csapi.plugin.calendarlookup = "y"

讓 Calendar Server 載入所有外掛程式：

csapi.plugin.calendarlookup.name = "*"

指定 Calendar Server 應使用的行事曆查找外掛程式類型：

caldb.cld.type = "directory"

設定預設 DWP 伺服器名稱：

caldb.dwp.server.default = "server-name"

caldb.dwp.server.default = "calendar.sesta.com"

為該配置中所有前端/後端伺服器 (包括本機伺服器) 設定伺服器名稱：

caldb.dwp.server.server-1.ip = "server-1"
caldb.dwp.server.server-2.ip = "server-2"
...
caldb.dwp.server.server-n.ip = "server-n"

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

伺服器名稱還必須符合適當行事曆所有者的 icsDWPHost LDAP 性質所使用的名稱。

重新啟動 Calendar Server 以使變更生效。

用於每台前端/後端伺服器的範例配置參數

以下範例顯示用於每台前端/後端伺服器的配置參數。這些伺服器為 sesta.com、siroe.com 和 varrius.com。預設 DWP 伺服器為 sesta.com。

維護前端和後端伺服器之間的安全

前端伺服器使用資料庫連線協定 (DWP) 與後端伺服器進行通訊。由於 DWP 使用 HTTP 作為傳輸機制，因此 Calendar Server 6.0 使用表格 3-6 和表格 3-7 中的配置參數，為前端和後端伺服器之間的 DWP 連線提供認證。

這些參數是可選的，並且依預設不包括在 ics.conf 檔案中。若要認證 DWP 連線，您必須新增所需參數至每台前端和後端伺服器上的 ics.conf 檔案。

表格 3-6 用於認證 DWP 連線的後端配置參數
參數	說明
service.dwp.admin.userid	在後端伺服器上，指定用於認證 DWP 連線的使用者 ID。如果後端伺服器未指定使用者 ID，則不會執行認證。
service.dwp.admin.cred	在後端伺服器上，指定用於認證 DWP 連線的密碼。如果後端伺服器未指定密碼，則不會執行認證。

表格 3-7 用於認證 DWP 連線的前端配置參數
參數	說明
caldb.dwp.server.back-end-server.admin	在前端伺服器上，指定用於認證後端伺服器 DWP 連線的使用者 ID，其中 back-end-server 是該伺服器的名稱。
caldb.dwp.server.back-end-server.cred	在前端伺服器上，指定用於認證後端伺服器 DWP 連線的密碼，其中 back-end-server 是該伺服器的名稱。

若要設定前端和後端伺服器之間 DWP 連線的認證，請執行以下步驟：

在每台前端伺服器上的 ics.conf 檔案中，新增以下參數：

caldb.dwp.server.back-end-server.admin = "userid"
caldb.dwp.server.back-end-server.cred = "password"

其中 back-end-server 是後端伺服器的名稱，userid 和 password 是您希望 Calendar Server 用於認證連線的使用者 ID 和密碼。

在 back-end-server 所指定的每台後端伺服器上的 ics.conf 檔案中，新增以下參數：

service.dwp.admin.userid = "userid"
service.dwp.admin.cred = "password"

其中 userid 和 password 與您在前端伺服器上指定的使用者 ID 和密碼相同。

當前端伺服器首次連線至後端伺服器時，會傳送這些參數所指定的使用者 ID 和密碼。後端伺服器會檢查這些參數，如果兩個參數都符合，則認證成功。然後，後端伺服器會將階段作業 ID 傳送回前端伺服器。在以後針對後端伺服器的 DWP 指令中，前端伺服器會使用該階段作業 ID。

來自同一前端伺服器的後續連線不需要再次進行認證，除非發生以下情況：

後端伺服器重新啟動。

階段作業因兩台伺服器之間無活動而過期。

如果您有多台前端和後端伺服器，則可以對每台伺服器使用同一使用者 ID 和密碼。

如果後端伺服器未在該參數中指定使用者 ID 和密碼，則不會執行認證。

提昇 LDAP CLD 外掛程式的效能

若要提昇 Calendar Server 與 LDAP CLD 外掛程式配合的效能，請務必將以下配置參數設定為 "yes" (即每個參數的預設值)：

caldb.cld.cache.enable 會啟用 CLD 快取記憶體選項。此選項會為行事曆使用者儲存 DWP 主機伺服器資訊 (icsDWPHost LDAP 性質)，從而減少對 LDAP 目錄伺服器的呼叫。

service.calendarsearch.ldap 指定使用 LDAP 或使用者偏好設定外掛程式來執行行事曆搜尋。

清除 CLD 快取記憶體

如果您要使用 CLD 快取記憶體選項並已更新 ics.conf 參數的伺服器名稱或已將行事曆移至其他後端伺服器，則應清除 CLD 快取記憶體，以移除伺服器名稱。CLD 快取記憶體中的過期項目會妨礙前端伺服器建立與正確後端伺服器之間的連線，或會導致某個行事曆在被移動後，Calendar Server 無法找到該行事曆。

停止 Calendar Server。

移除 cal_svr_base/var/opt/SUNWics5/csdb/cld_cache 目錄中的所有檔案，但請勿移除 cld_cache 目錄本身。

重新啟動 Calendar Server。

將行事曆移至其他後端伺服器

若要將使用者行事曆或資源行事曆從一台後端伺服器移至另一台後端伺服器，請執行以下步驟：

在原始伺服器上，使用 csuser 公用程式 (用於使用者行事曆) 或 csresource 公用程式 (用於資源行事曆) 停用行事曆使用者。例如，停用使用者 ID 和 calid 為 bkamdar 的使用者：

csuser disable bkamdar

在原始伺服器上，使用 csexport 公用程式將行事曆從行事曆資料庫匯出至檔案。例如：

csexport -c bkamdar calendar bkamdar.ics

如果使用者具有多個行事曆，則必須對每個行事曆執行這一步驟。

將匯出的行事曆 (*.ics) 檔案從原始伺服器複製到新伺服器中。

在新伺服器上，使用 csimport 公用程式將行事曆從檔案匯入行事曆資料庫。例如：

csimport -c bkamdar calendar bkamdar.ics

同樣，對於所匯出的每個行事曆都必須執行這一步驟。

在 LDAP 目錄伺服器上，使用 csattribute 公用程式更新行事曆所有者的 icsDWPHost LDAP 性質，以指向新的後端伺服器。若要更新某個性質，必須先刪除該性質，然後使用新值新增該性質。例如，將新伺服器名稱設定為 sesta.com：

csattribute -a icsDWPHost delete bkamdar
csattribute -a icsDWPHost=sesta.com add bkamdar

在新伺服器上，使用 csuser 公用程式 (用於使用者行事曆) 或 csresource 公用程式 (用於資源行事曆) 啟用行事曆使用者。例如：

csuser enable bkamdar

在新伺服器上，使用以下指令驗證這些性質是否正確以及每個行事曆的移動是否正確。例如：

cscal -v -o bkamdar list bkamdar
...
csattribute -v list bkamdar

在原始伺服器上，刪除您剛移動的所有行事曆。例如：

cscal -o bkamdar delete bkamdar

-o 選項會刪除主要所有者為 bkamdar 的所有行事曆。

管理 LDAP 性質

若要管理 Calendar Server 所使用的 LDAP 性質，請使用 csattribute 公用程式。

列出 LDAP 性質


註	如果您的站台使用的是 LDAP CLD 外掛程式，請勿使用 csattribute 變更 icsDWPHost 性質來指定新的後端主機伺服器。修改 icsDWPHost 不會在新的後端主機上建立新的行事曆。如需更多資訊，請參閱配置 LDAP 行事曆查找資料庫 (CLD) 外掛程式。

若要列出使用者或資源的 LDAP 性質，請使用 csattribute 公用程式的 add 指令。例如，列出使用者 TChang 的 LDAP 性質：

新增 LDAP 性質

若要新增性質至 LDAP 伺服器，請使用 csattribute 公用程式的 add 指令。例如，將 LDAP 性質 icsCalendar 與值 Conference_Schedule 新增給使用者 TChang：

刪除 LDAP 性質

若要刪除 LDAP 伺服器的性質，請使用 csattribute 公用程式的 delete 指令。例如，從 TChang 中刪除 LDAP 性質 icsCalendar：

管理群組排程引擎 (GSE) 佇列

群組排程可讓 Calendar Server 使用者建立一個事件 (如會議)，然後邀請其他與會人員。透過使用空閒/忙碌查找功能，使用者可以確定被邀請者何時可以實際參與某個事件。

如果某位與會人員位於同一 Calendar Server 上，則該事件會排程在該與會人員的行事曆中。如果某位與會人員不在同一 Calendar Server 上，則系統會透過電子郵件傳送邀請。與會人員可以接受或拒絕此邀請。

Calendar Server 使用者還可以透過並排檢視各與會人員的行事曆來比較群組排程。

若要管理 GSE 佇列中的項目，請使用 csschedule 公用程式。您必須在安裝 Calendar Server 的本機上執行 csschedule。

列出 GSE 佇列中的項目

若要列出 GSE 佇列中的項目，請使用 csschedule 公用程式的 list 指令。例如，列出 GSE 佇列中的所有項目：

列出 GSE 佇列中，calid 為 Holiday_Schedule 的行事曆的所有項目：

刪除 GSE 佇列中的項目

若要刪除 GSE 佇列中的項目，請使用 csschedule 公用程式的 delete 指令。例如，刪除 GSE 佇列中的所有項目：

刪除 GSE 佇列中 calA 行事曆的一個項目，該項目的第一個排程時間為 2001 年 11 月 30 日 13:30:45、偏移數為 1、唯一識別碼為 1111、週期性 ID 為 0、序列號為 0：

監視 Calendar Server

若要監視 Calendar Server 的活動，請使用 csmonitor、csstats 和 cstool 公用程式。本節描述以下工作：

列出計數器統計資料

監視 Calendar Server 日誌檔

列出計數器統計資料

csstats 公用程式可顯示行事曆配置 (counter.conf) 檔案中定義的計數器物件的統計資訊。計數器物件 (如 httpstat、authstat、wcapstat 或 dbstat) 可顯示有關 Calendar Server 的資訊，包括：

最大並行運作的連線數和連線總數

成功和失敗的登入與連線總數

資料庫讀取、寫入和刪除數

若要列出統計資訊，請使用 csstats 公用程式的 list 指令。例如，顯示有關可用計數器物件和類型的基本資訊：

在一小時內每 10 秒鐘列出一次有關 wcapstat 計數器物件的統計資料：

監視 Calendar Server 日誌檔

每個 Calendar Server 服務都會將狀態資訊寫入其自身的日誌檔中。每個日誌檔都會以其相關的服務名稱來命名，如表格 3-8 所示：

表格 3-8 Calendar Server 日誌檔
服務名稱	日誌檔名稱
管理服務 (csadmind)	admin.log
分散式資料庫服務 (csdwpd)	dwp.log
HTTP 服務 (cshttpd)	http.log
通知服務 (csnotifyd)	notify.log

在 Solaris 系統上，Calendar Server 日誌檔儲存在以下預設目錄中：

每個日誌檔會根據所配置的時間和大小限制，更替為具有新名稱的新日誌檔，如下所示：

日誌事件嚴重性級別

對於報告給日誌檔的事件，Calendar Server 提供了八個嚴重性級別，如表格 3-9 所示。

表格 3-9 Calendar Server 日誌錯誤嚴重性級別
嚴重性級別	涵義
EMERGENCY	系統不可用。此級別表示事件的嚴重性最高 (最嚴重)。
ALERT	必須立即採取動作。
CRITICAL	嚴重情況。
ERROR	錯誤情況。
WARNING	警告情況。
NOTICE	正常，但是重要的情況。此為每個行事曆服務的預設報告級別。
INFORMATION	資訊。
DEBUG	除錯級別訊息。

每個日誌事件以單行表示，每行顯示以下內容：相關的時間標記、伺服器主機名稱、嚴重性級別、程序名稱 (程序 ID)、事件類型、優先順序以及說明。透過修改 ics.conf 檔案中的某些配置設定，可以為 Calendar Server 報告給日誌檔的事件指定嚴重性級別。如需相關資訊，請參閱行事曆日誌資訊配置。

您應定期檢查日誌檔，瞭解是否存在 EMERGENCY、ALERT、CRITICAL、ERROR 以及 WARNING 等級別的錯誤，一旦發現錯誤，應運作 Calendar Server 來檢查事件，以找出可能的問題。Calendar Server 正常運作期間會產生 NOTICE 和 INFORMATION 級別的日誌事件，這些事件可協助您監視伺服器活動。


註	當您請求 Calendar Server 技術支援時，可能需要提供日誌檔，以協助解決問題。

對 Calendar Server 執行 Ping 作業

若要驗證 Calendar Server 服務是否正在偵聽指定的連接埠號，請使用 cstool 公用程式的 ping 指令。對某種服務執行 ping 作業不會驗證該服務是否確實正在執行，但會指示該服務是否可以接受套接字連線。

http — HTTP 服務 (cshttpd)

admin — 管理服務 (csadmind)



註	在目前版次中，您無法對 DWP 服務 (csdwpd)、事件通知服務 (enpd) 或通知服務 (csnotifyd) 執行 ping 作業。

例如，對主機名稱為 calserver 的機器執行 ping 作業，以查看 cshttpd 服務是否正在偵聽連接埠 80：

依預設，cstool 會等待 120 秒，以查看有無回應；但您可以使用 -t timeout 選項變更該值。

重新整理 Calendar Server 配置

在目前版次中，請勿使用 cstool refresh 指令來重新整理配置，而應使用 stop-cal 和 start-cal 指令。如需更多資訊，請參閱啟動和停止 Calendar Server。