Sun Java System Calendar Server 管理指南 |
第 10 章
管理 Calendar Server本章說明如何管理 Calendar Server,並包含以下小節:
您可以透過執行指令行公用程式和編輯 ics.conf 配置檔案來管理 Calendar Server。
若要執行指令行公用程式,您必須以對 Calendar Server 執行時所在的系統具有管理權限的使用者身份登入。
如需更多資訊,請參閱附錄 D 「Calendar Server 指令行公用程式參照」和附錄 A 「Calendar Server 配置參數」。
啟動和停止 Calendar Server您可以使用 start-cal 和 stop-cal 指令啟動和停止 Calendar Server。請參閱 使用 start-cal 和 stop-cal 公用程式。
註
Calendar Server 提供 csstart 和 csstop 公用程式僅為與舊版相容。如果可能,請使用 start-cal 和 stop-cal 公用程式來啟動和停止 Calendar Server。
本小節包含以下主題:
使用 start-cal 和 stop-cal 公用程式
start-cal 和 stop-cal 公用程式均位於 cal_svr_base/opt/SUNWics5/cal/sbin 目錄中。您必須在安裝 Calendar Server 的本機上執行這些公用程式。如需瞭解可能會發生的問題,請參閱疑難排解 start-cal 和 stop-cal 公用程式。
start-cal 公用程式會以如下順序啟動 Calendar Server 服務:
如需有關以上服務的說明,請參閱「Calendar Server 服務」。
若要使用 start-cal 指令啟動 Calendar Server,請:
若要使用 stop-cal 指令停止 Calendar Server,請:
疑難排解 start-cal 和 stop-cal 公用程式
啟動和停止 Calendar Server 時,可能會發生以下問題:
- start-cal 公用程式未啟動所有的 Calendar Server 程序。例如,start-cal 可能啟動了 enpd、csnotifyd 和 csadmind 程序,但未啟動 cshttpd。在此情況下,您必須停止所有的 Calendar Server 程序,然後嘗試重新啟動 Calendar Server。
- stop-cal 公用程式未停止所有的 Calendar Server 程序。例如,stop-cal 可能停止了 cshttpd 父程序,而未停止任何 cshttpd 子程序。在此情況下,您必須停止其餘 Calendar Server 程序。
- 在執行 Calendar Server 的 Linux 系統上,如果您使用 ps 指令搜尋行事曆程序,其結果可能會令人費解。在 Linux 中,ps 指令傳回執行中的執行緒清單而不是程序清單。尚無用於僅顯示程序的解決方法。
若要在 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 指令的資訊,請參閱檢查與重建行事曆資料庫。
管理群組排程引擎佇列群組排程引擎 (GSE) 保留將用於更新元件資料庫的事件佇列。管理員可以變更逾時值,以調整 Calendar Server 掃描佇列的時間間隔。還可以列出佇列中的事件,並在必要時刪除特定事件。
本小節包含以下主題:
關於 GSE
GSE 可讓 Calendar Server 使用者建立事件並邀請其他與會人員。如果某位與會人員位於同一 Calendar Server 上,則該事件會排程在該與會人員的行事曆中。如果某位與會人員不在同一 Calendar Server 上,則系統會透過電子郵件傳送邀請。然後,與會人員可接受或拒絕邀請,GSE 將用回覆更新事件。
關於 GSE 佇列
GSE 佇列實際是由 GSE 管理的獨立的資料庫。Calendar Server 在佇列中掃描元件資料庫所需的更新。
您可以透過調整此掃描的頻率來調校 Calendar Server。此操作可以透過變更 ics.conf 檔案中 gse.belowthresholdtimeout 的逾時值完成。請參閱第 19 章 「調校 Calender Server 效能」。
GSE 佇列項目可使用 csschedule 來管理 (列出或刪除)。您必須在安裝 Calendar Server 的本機上執行 csschedule。
列出 GSE 佇列中的項目
若要列出 GSE 佇列中的項目,請使用 csschedule 公用程式的 list 指令。例如,列出 GSE 佇列中的所有項目:
csschedule list
列出儲存在 GSE 佇列中的前十個項目:
csschedule -c 10 list
列出 GSE 佇列中,calid 為 Holiday_Schedule 的行事曆的所有項目:
csschedule -v list Holiday_Schedule
刪除 GSE 佇列中的項目
若要刪除 GSE 佇列中的項目,請使用 csschedule 公用程式的 delete 指令。例如,刪除 GSE 佇列中的所有項目:
csschedule -v delete
刪除 GSE 佇列中 calA 行事曆的一個項目,該項目的第一個排程時間為 2001 年 11 月 30 日 13:30:45、偏移數為 1、唯一識別碼為 1111、週期性 ID 為 0、序列號為 0:
csschedule -v -t 20011130T133045Z -o 1 -u 1111 -r 0 -n 0 delete calA
監視 Calendar Server若要監視 Calendar Server 的活動,請使用 csmonitor、csstats 和 cstool 公用程式。本小節說明以下工作:
列出計數器統計資料
csstats 公用程式可顯示行事曆配置 (counter.conf) 檔案中定義的計數器物件的統計資訊。計數器物件 (如 httpstat、authstat、wcapstat 或 dbstat) 可顯示有關 Calendar Server 的資訊,包括:
如需有關 Calendar Server 計數器統計資料的更多資訊,請參閱計數器配置 (counter.conf) 檔案。
若要列出統計資訊:
若要列出統計資訊,請使用 csstats 公用程式的 list 指令。例如,顯示有關可用計數器物件和類型的基本資訊:
csstats list
特別列出有關 httpstat 計數器物件的統計資料:
csstats list http
列出有關 wcapstat 計數器物件的統計資料:
在此範例中,請將頻率設定為每 10 秒一次,持續一個小時。
csstats -i 360 -s 10 list wcap
監視 Calendar Server 日誌檔
每個 Calendar Server 服務都會將狀態資訊寫入其自身的日誌檔中。每個日誌檔都會以其相關的服務名稱來命名,如表格 10-1 所示:
在 Solaris 作業系統上,Calendar Server 日誌檔儲存在以下預設目錄中:
/var/opt/SUNWics5/logs
每個日誌檔會根據所配置的時間和大小限制,更替為具有新名稱的新日誌檔,如下所示:
ServiceName.TimeStamp.#
例如:
admin.log.8.1083013284
http.log.8.1083013284日誌事件嚴重性級別
對於報告給日誌檔的事件,Calendar Server 提供了八個嚴重性級別,如表格 10-2 中所說明。
表格 10-2 Calendar Server 日誌錯誤嚴重性級別
嚴重性級別
涵義
CRITICAL
嚴重情況。
ERROR
錯誤情況。
WARNING
警告情況。
NOTICE
正常,但是重要的情況。此為每個行事曆服務的預設報告級別。
INFORMATION
資訊。
DEBUG
除錯級別訊息。
每個日誌事件以單行表示,每行顯示以下內容:相關的時間標記、伺服器主機名稱、嚴重性級別、程序名稱 (程序 ID)、事件類型、優先順序以及說明。透過修改 ics.conf 檔案中的某些配置設定,可以為 Calendar Server 報告給日誌檔的事件指定嚴重性級別。如需相關資訊,請參閱行事曆日誌資訊配置。
您應定期檢查日誌檔,瞭解是否存在 EMERGENCY、ALERT、CRITICAL、ERROR 以及 WARNING 等級別的錯誤,一旦發現錯誤,應執行 Calendar Server 來檢查事件,以找出可能的問題。Calendar Server 正常作業期間會產生 NOTICE 和 INFORMATION 級別的日誌事件,這些事件可協助您監視伺服器活動。
對 Calendar Server 執行 Ping 作業若要驗證 Calendar Server 服務是否正在偵聽指定的連接埠號,請使用 cstool 公用程式的 ping 指令。對某種服務執行 ping 作業不會驗證該服務是否確實正在執行,但會指示該服務是否可以接受套接字連線。
Calendar Server 服務選項為:
必須執行 Calendar Server,才能執行 cstool。
例如,對主機名稱為 calserver 的機器執行 ping 作業,以查看 cshttpd 服務是否正在偵聽連接埠 80:
cstool -p 80 -h calserver ping http
依預設,cstool 會等待 120 秒,以查看有無回應;但您可以使用 -t timeout 選項變更該值。
如需完整的公用程式參照材料,請參閱 Calendar Server 指令行公用程式參照。
更新 Calendar Server 配置在目前發行版本中,請勿使用 cstool refresh 指令來更新配置,而應使用 stop-cal 和 start-cal 指令。如需更多資訊,請參閱啟動和停止 Calendar Server。
關閉舊的 Calendar Express UI如果您已安裝新的 Communications Express UI,則不必關閉舊的 Calendar Express UI。但是,如果您要關閉舊的 Calendar Express UI,可透過重新命名以下檔案完成:default.html。
default.html 檔案位於以下目錄中:
/opt/SUNWics5/cal/html