test

Sun Java System Calendar Server 6 2005Q4 管理指南

第 12 章 管理 Calendar Server

本章及使用由 Messaging Server 建立的網域中之後的小節說明如何管理 Calendar Server，其中包含以下小節：

您可以透過執行 Delegated Administrator 公用程式 (以前的 User Management 公用程式) 或 Calendar Server 指令行公用程式和編輯 ics.conf 配置檔案來管理 Calendar Server。

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

如需更多資訊，請參閱附錄 DCalendar Server 指令行公用程式參照。

備註 –

其他管理主題包含在其他獨立章節中。其中包括以下主題︰

啟動和停止 Calendar Server

本小節包含如何使用 start-cal 和 stop-cal，並包含以下主題︰

關於 start-cal 和 stop-cal

您可以使用 start-cal 和 stop-cal 指令啟動和停止 Calendar Server。start-cal 和 stop-cal 公用程式位於 cal_svr_base/SUNWics5/cal/sbin 目錄中。您必須在安裝 Calendar Server 的本機上執行這些公用程式。

備註 –

Calendar Server 提供 csstart 和 csstop 公用程式僅為與舊版相容。如果可能，請使用 start-cal 和 stop-cal 公用程式啟動和停止 Calendar Server。

start-cal 公用程式會以如下順序啟動 Calendar Server 服務：

  1. enpd — 事件通知服務 (ENS)

  2. csnotifyd — 通知服務

  3. csadmind — 管理服務

  4. csdwpd — 資料庫連線協定 (DWP) 服務，此分散式資料庫服務僅當您具有遠端 Calendar Server 資料庫配置時才啟動

  5. cshttpd — HTTP 服務

  6. csstored — 自動備份服務

如需這些服務的說明，請參閱Calendar Server 服務

Procedure使用 start-cal 啟動 Calendar Server

步驟

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

  2. 變更至 cal_svr_base/SUNWics5/cal/sbin 目錄。

  3. 啟動 CalendarServer：


    ./start-cal

Procedure使用 stop-cal 停止 Calendar Server

步驟

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

  2. 變更至 cal_svr_base/SUNWics5/cal/sbin 目錄。

  3. 停止 Calendar Server：


    ./stop-cal

啟用或停用自動備份

自動備份由 csstored 程序進行管理，該程序在發出 start-cal 時會自動啟動。然而，您也可以隨意啟用或停用自動備份。預設為停用自動備份。即使自動備份未啟用，csstored 程序也可執行。

有兩種類型的自動備份︰緊急備份和歸檔檔案備份。您可以分別啟用或停用它們。

csstored 程序必須在發出 start-cal 之前進行配置，否則您將收到一條通知您 csstored 尚未配置的錯誤訊息。此後，您將每 24 小時收到一次同樣的訊息，直到將其配置為止。

如需有關自動備份的資訊和配置 csstored 的說明，請參閱第 10 章, 配置自動備份 (csstored)。

以下是用於啟用和停止自動備份的工作清單：

Procedure啟用緊急備份

步驟

  1. 在指令行變更至 ics.conf 所在的目錄︰

    cd /etc/opt/SUNWics5/config

  2. 透過將以下 ics.conf 參數設定為 “yes”，啟用緊急備份︰

    caldb.berkeleydb.hotbackup.enable="yes"

  3. 指定緊急備份目錄的目錄路徑︰

    caldb.berkeleydb.hotbackup.path=
   /var/opt/SUNWics5/hotbackup_directory

    預設為目前目錄。

  4. 完成編輯 ics.conf 檔案之後，請重新啟動 Calendar Server︰

    cal_svr_base/SUNWics5/cal/sbin/start-cal

    無需停止行事曆服務即可編輯 ics.conf 檔案，但是您必須重新啟動服務以使變更生效。

Procedure啟用歸檔檔案備份

步驟

  1. 在指令行變更至 ics.conf 所在的目錄︰

    cd /etc/opt/SUNWics5/config

  2. 透過將以下 ics.conf 參數設定為 “yes”，啟用歸檔檔案備份︰

    caldb.berkeleydb.archive.enable=”yes”

  3. 指定歸檔檔案目錄的目錄路徑︰

    caldb.berkeleydb.archive.path=
   /var/opt/SUNWics5/hotbackup_directory

    預設為目前目錄。

  4. 完成編輯 ics.conf 檔案之後，請重新啟動 Calendar Server︰

    cal_svr_base/SUNWics5/cal/sbin/start-cal

    無需停止行事曆服務即可編輯 ics.conf 檔案，但是您必須重新啟動服務以使變更生效。

Procedure停用緊急備份

依預設，備份已停用。如果您先前已啟用備份但現在想將其停用，請執行下列步驟︰

步驟

  1. 在指令行變更至 ics.conf 所在的目錄︰

    cd /etc/opt/SUNWics5/config

  2. 透過將以下 ics.conf 參數設定為 "no"，停用緊急備份︰

    caldb.berkeleydb.hotbackup.enable="no"

  3. 完成編輯 ics.conf 檔案之後，請重新啟動 Calendar Server︰

    cal_svr_base/SUNWics5/cal/sbin/start-cal

    無需停止行事曆服務即可編輯 ics.conf 檔案，但是您必須重新啟動服務以使變更生效。

Procedure停用歸檔檔案備份

依預設，備份已停用。如果您先前已啟用備份但現在想將其停用，請執行下列步驟︰

步驟

  1. 在指令行變更至 ics.conf 所在的目錄︰

    cd /etc/opt/SUNWics5/config

  2. 透過將以下 ics.conf 參數設定為 "no"，停用歸檔檔案備份︰

    caldb.berkeleydb.archive.enable="no"

  3. 完成編輯 ics.conf 檔案之後，請重新啟動 Calendar Server︰

    cal_svr_base/SUNWics5/cal/sbin/start-cal

    無需停止行事曆服務即可編輯 ics.conf 檔案，但是您必須重新啟動服務以使變更生效。

管理群組排程引擎佇列

群組排程引擎 (GSE) 保留將用於更新元件資料庫的事件佇列。管理員可以變更逾時值，以調整 Calendar Server 掃描佇列的時間間隔。還可以列出佇列中的事件，並在必要時刪除特定事件。

本小節包含以下主題：

關於 GSE

GSE 可讓 Calendar Server 使用者建立事件並邀請其他與會人員。如果某位與會者位於同一 Calendar Server 上，則該事件會排程在該與會者的行事曆中。如果某位與會人員不在同一 Calendar Server 上，則系統會透過電子郵件傳送邀請。然後，與會人員可接受或拒絕邀請，GSE 將用回覆更新事件。

關於 GSE 佇列

GSE 佇列實際上是由 GSE 管理的獨立資料庫。Calendar Server 在佇列中掃描元件資料庫所需的更新。

您可以透過調整此掃描的頻率來調校 Calendar Server。此操作可透過變更 ics.conf 檔案中 gse.belowthresholdtimeout 的逾時值來完成。請參閱第 21 章, �屐� Calendar 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。此外，您可以設置許多記錄檔以協助監視系統的使用。

本小節包含以下主題：

關於 csmonitor

此 Calendar Server 公用程式是需要 bash 的 shell 程序檔。此公用程式在被呼叫時可執行下列功能︰

若要除錯，您可以將監視器配置為在間隔時間很短的持續迴圈中執行，但這需要更多的系統資源，所以您不希望在正常生產中將其保留為該模式。

若要在一般情況下使用 csmonitor，請將其設定為以您選擇的間隔執行。

如需有關 csmonitor 公用程式的更多資訊，請參閱附錄 DCalendar Server 指令行公用程式參照。

Procedure配置 csmonitor

步驟

  1. 以擁有變更配置權限的管理員身份登入。

  2. 變更至 /etc/opt/SUNWics5/cal/config 目錄。

  3. 透過複製及重新命名，儲存舊的 ics.conf 檔案。

  4. 編輯下表中所示的一個或多個 ics.conf 參數：

    參數 

    說明和預設值 

    service.monitor.continuous

    指定 csmonitor 是否應持續迴圈︰"0" – 不持續迴圈 (預設)。"1" – 持續迴圈。

    將此參數設定為 “1” 以使 csmonitor 可以自動執行。

    service.monitor.loopsdelay

    指定兩個監視迴圈之間的延遲 (以秒為單位)。預設為 “60” 秒。 

    若要進行除錯，則設定較短的間隔時間；若要進行生產，則設定較長的間隔時間。 

    service.monitor.emailaddress.from

    指定 csmonitor 傳送訊息的電子郵件位址。無給定預設。

    service.monitor.emailaddress.to

    指定 csmonitor 應將訊息傳送至的電子郵件位址。無給定預設。

    service.monitor.csdb.logthreshold 

    監視行事曆資料庫 (csdb)。指定最大磁碟佔用率的臨界值 (以總磁碟空間的百分比表示)。如果 csdb 目錄的磁碟佔用率超過此值，其將傳送警告電子郵件訊息。預設為 “90”。

    logfile.monitor.logname

    指定 csmonitor 記錄檔名稱。預設為 “csmonitor.log”。

    logfile.monitor.maxlogfilesize

    指定記錄檔的最大大小。如果記錄檔超出此大小，則 csmonitor 將記錄儲存為 csmonitor.log。timestamp 並重設目前記錄。預設為 “2097152”

    service.monitor.dbglevel

    指定除錯級別。在 0 至 5 的範圍內，此值越高，csmonitor 傳送的訊息就越精確、越詳細。預設為 “0”，指定為不記錄。值 “5” 表示除錯記錄。

  5. 將檔案儲存為 ics.conf。

  6. 重新啟動 Calendar Server。

    cal_svr_base /SUNWics5/cal/sbin/start-cal

列出計數器統計資料

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

如需有關 Calendar Server 計數器統計的資訊，請參閱附錄 ECalendar Server 配置參數。

使用 cstool 以用於監視

您可以對下列服務及安裝 Calendar Server 的機器執行 Ping 作業︰

如需有關使用 cstool 的資訊，請參閱附錄 DCalendar Server 指令行公用程式參照。

使用 Calendar Server 記錄檔

每種 Calendar Server 服務都將其狀態資訊寫入自己的 記錄檔。每個記錄檔都會以其相關的服務名稱來命名，如下表所示：

服務名稱 

記錄檔名稱 

管理服務 (csadmind) 

admin.log 

分散式資料庫服務 (csdwpd) 

dwp.log 

HTTP 服務 (cshttpd) 

http.log 

通知服務 (csnotifyd) 

notify.log 

單次登入記錄 

am_sso.log 

start 指令的記錄 

start.log 

stop 指令的記錄 

stop.log 

store 指令的記錄 

store.log 

Calendar Server 記錄檔儲存在以下預設目錄中：

/var/opt/SUNWics5/logs

每個記錄檔會自動重建為具有唯一編號的新記錄檔。例如：

admin.log.8.1083013284 http.log.8.1083013284

Calendar Server 提供報告至記錄檔的事件的六個嚴重性層級，如下表中所述。您可以透過修改 ics.conf 參數 logfile.loglevel，來指定 Calendar Server 報告至記錄檔的事件的嚴重性級別。

嚴重性級別 

涵義 

CRITICAL 

嚴重情況。 

ERROR 

錯誤情況。 

WARNING 

警告情況。 

NOTICE 

正常但是重要的情況。此為每個行事曆服務的預設報告級別。 

INFORMATION 

資訊。 

DEBUG 

除錯級別訊息。 

每個記錄事件以單行表示，每行顯示以下內容：相關的時間標記、伺服器主機名稱、嚴重性級別、程序名稱 (程序 ID)、事件類型、優先順序以及說明。

如需有關 ics.conf 記錄設定的資訊，請參閱附錄 ECalendar Server 配置參數。

清除 CLD 快取記憶體

如果已啟用 CLD 快取記憶體，則需要不時地清除記憶體。本小節包含以下主題：

為何清除 CLD 快取記憶體？

CLD 快取記憶體會由於各種原因無法與系統配置保持同步，例如︰

如果發生其中任何情況，為了更新 CLD 快取記憶體，您必須將其清除。

Procedure清除 CLD 快取記憶體

步驟

  1. 停止 Calendar Server。

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

  3. 重新啟動 Calendar Server。

變更伺服器名稱

如果在配置中增加、刪除或變更伺服器名稱，您應該執行以下數項「事務性工作」，以免出錯︰

配置匿名存取

匿名存取是一種不需要認證的特殊登入。啟用匿名登入後，依預設，對公開行事曆的讀取和寫入存取已啟用。可能會拒絕對公開行事曆的寫入存取。本小節包含以下主題：

備註 –

Communications Express 要求寫入和讀取均允許匿名登入。請參閱配置 Communications Express。

Procedure啟用匿名存取

步驟

  1. 以擁有變更配置權限的管理員身份登入。

  2. 變更至 /etc/opt/SUNWics5/cal/config 目錄。

  3. 透過複製及重新命名，儲存舊的 ics.conf 檔案。

  4. 編輯 ics.conf 中的以下參數，以啟用匿名存取︰

    參數 

    說明和預設值 

    service.http.allowanonymouslogin

    如有必要，將此參數設定為 “yes”，以啟用匿名存取 (登入)。預設值為 “yes”。

    service.calendarsearch.ldap

    透過將此參數設定為 “no” (此為預設值)，您可在執行行事曆搜尋時停用首先搜尋 LDAP，以便保護啟用匿名登入後的安全性。

    備註 –

    Communications Express 要求 service.calendarsearch.ldap 參數的值為 “no”。這會與調校系統在 DWP 環境中發揮最佳效能的說明相衝突。(您的資料庫分布在多台後端伺服器上。)請參閱�▇@ DWP �燠活９��腹四搗j�M�刁�。

  5. 將檔案儲存為 ics.conf。

  6. 重新啟動 Calendar Server。

    cal_svr_base /SUNWics5/cal/sbin/start-cal

Procedure禁止匿名使用者寫入至公開行事曆

步驟

  1. 以擁有變更配置權限的管理員身份登入。

  2. 變更至 /etc/opt/SUNWics5/cal/config 目錄。

  3. 透過複製及重新命名，儲存舊的 ics.conf 檔案。

  4. 如下表所示編輯以下 ics.conf 參數：

    參數 

    說明和預設值 

    service.wcap.anonymous.

    allowpubliccalendarwrite

    允許或禁止匿名存取使用者寫入至公開的行事曆。將其值設定為 “yes” (此為預設值) 以啟用存取。

  5. 將檔案儲存為 ics.conf。

  6. 重新啟動 Calendar Server。

    cal_svr_base /SUNWics5/cal/sbin/start-cal

啟用代理管理員登入

必須為 Communications Express 啟用代理伺服器管理員登入 (代理伺服器認證)。如需有關配置 Communications Express 的代理伺服器認證的說明，請參閱配置 Communications Express。

然而，即使您未使用 Communications Express，仍可以啟用代理伺服器認證。此小節包含在不使用 Communications Express 的情況下啟用代理伺服器認證的程序：

Procedure啟用代理伺服器認證 (不使用 Communications Express)

步驟

  1. 以擁有變更配置權限的管理員身份登入。

  2. 變更至 /etc/opt/SUNWics5/cal/config 目錄。

  3. 透過複製及重新命名，儲存舊的 ics.conf 檔案。

  4. 編輯 ics.conf 檔案，設定以下參數：

    service.http.allowadminproxy = "yes"

  5. 將檔案儲存為 ics.conf。

  6. 重新啟動 Calendar Server 以使新值生效。

Procedure驗證代理伺服器認證是否正常工作

步驟

    使用以下 WCAP 指令驗證管理員代理登入是否在工作：

    http://server[:port]
/login.wcap?user=admin-user&password=admin-password
&proxyauth=calendar-user

    其中：

    • server – 執行 Calendar Server 的伺服器名稱。

      • port – Calendar Server 的連接埠號碼。預設連接埠為 80。

      • admin-user – Calendar Server 管理員。例如，calmaster。

      • admin-password – admin-user 的密碼。

      • calendar-user – Calendar Server 使用者的 calid。

        如果指令成功，Calendar Server 將顯示 calendar-user 的行事曆。如果發生問題，Calendar Server 將顯示「未授權」。原因可能是：

      • admin-user 沒有 Calendar Server 管理員權限。

      • admin-password 不正確。

      • calendar-user 不是有效的 Calendar Server 使用者。

更新 Calendar Server 配置

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