Sun Java System Calendar Server 6.3 管理指南

22.1 開啟 Calendar Server 6.3 軟體的除錯資訊

本小節包含使用記錄及除錯對 Calendar Server 部署問題進行疑難排解的概念資訊及說明。

由於沒有一個可以將整個系統置於「除錯模式」的 ics.conf 參數，所以本小節說明一些獲得有用除錯資訊的方法：

備註 –

確定關閉不需要的多餘記錄和監視，否則將對效能起負面影響。

22.1.1 提昇記錄層級

使用下表中顯示的參數提昇記錄詳細度：

參數	說明和預設值
`logfile.loglevel`	設定為 `DEBUG` 以記錄所有層級，包括 `CRITICAL`、`ALERT`、`ERROR`、`WARNING`、`NOTICE` 和 `INFORMATION`。此設定可套用於所有記錄。

若要記錄對 LDAP 資料快取記憶體的所有存取情況並列印記錄 (報告)，請設定下表中所顯示的 ics.conf 參數。

參數	說明和預設值
`local.ldap.cache.stat.enable`	指定是否在記錄檔中記錄對 LDAP 資料快取記憶體的存取情況並列印統計資料。預設為 `“no”` (無記錄的統計)。設定為 `“yes”` 以啟用對統計的記錄。若要增強效能，請僅在除錯模式中使用此設定。
`local.ldap.cache.stat.interval`	指定各統計資料報告寫入記錄檔的間隔時間 (以秒為單位)。預設為 `“1800”` 秒 (30 分鐘)。此預設僅在記錄啟用時才處於作用中。縮短間隔可以協助您準確地確定問題所在。增加間隔將會減緩系統載入。

參數

說明和預設值

local.ldap.cache.stat.enable

指定是否在記錄檔中記錄對 LDAP 資料快取記憶體的存取情況並列印統計資料。預設為 “no” (無記錄的統計)。設定為 “yes” 以啟用對統計的記錄。

若要增強效能，請僅在除錯模式中使用此設定。

local.ldap.cache.stat.interval

指定各統計資料報告寫入記錄檔的間隔時間 (以秒為單位)。預設為 “1800” 秒 (30 分鐘)。

此預設僅在記錄啟用時才處於作用中。縮短間隔可以協助您準確地確定問題所在。增加間隔將會減緩系統載入。

目前 Calendar Server 中沒有使 LDAP 快取記憶體資料過期的邏輯。您必須手動移除 ldap_cache 目錄的內容並重新啟動 Calendar Server。

兩個讓除錯更容易的配置參數可以啟用對內送指令及 HTTP 存取的記錄。將其中一個參數或全部增加至 ics.conf 檔案，以啟動記錄：

service.http.commandlog = "yes" — cshttpd 程序會在記錄檔目錄中建立一個檔案 (http.commands)。此記錄包含伺服器收到的每一個 .shtml 或 .wcap 指令，包括每一個指令的所有參數。
service.http.commandlog.all = "yes" — cshttpd 程序會在記錄檔目錄中建立一個檔案 (http.access)。此記錄包含系統收到的每一個 HTTP 請求。

注意 –

記錄檔可以非常快速地增大，並填滿可用的磁碟空間。小心監視它們以避免發生問題。選擇在系統的低活動期間啟用這些指令來執行。如果在尖峰時刻執行，效能將大幅度下降。當完成疑難排解時，務必停用這兩個指令。

使用 csstats list 指令顯示在 counter.conf 檔案中定義的計數器物件的統計資訊。

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