除錯檔並非 [記錄服務] 的功能。它們是使用獨立於記錄 API 的其他 API 寫入。除錯檔儲存在 /var/opt/SUNWam/debug。此位置 (以及除錯資訊的等級) 可在 AMConfig.properties 檔中配置,此檔位於 AccessManager-base/SUNWam/lib/ 目錄中。如需更多有關除錯特性的資訊,請參閱附錄 AAMConfig.properties 檔案。
除錯檔可記錄的資訊分為幾個等級。除錯等級是以 AMConfig.properties 的 com.iplanet.services.debug.level 特性設定。
Off— 不記錄除錯資訊。
Error— 此等級用於生產。生產時,除錯檔中應無錯誤。
Warning— 目前並不建議使用此等級。
Message— 此等級利用代碼追蹤對可能的問題發出警示。大多數 Access Manager 模組使用此等級傳送除錯訊息。
[Warning] 與 [Message] 等級不可用於生產中。這樣會嚴重降低效能並產生大量的除錯訊息。
除非模組寫入除錯檔,否則不會建立除錯檔。因此,在預設錯誤模式下不會產生除錯檔。登入時若除錯等級設為訊息,則建立的除錯檔包括:
amAuth
amAuthConfig
amAuthContextLocal
amAuthLDAP
amCallback
amClientDetection
amConsole
amFileLookup
amJSS
amLog
amLoginModule
amLoginViewBean
amNaming
amProfile
amSDK
amSSOProvider
amSessionEncodeURL
amThreadManager
最常使用的檔案是 amSDK、amProfile 和所有適用於認證的檔案。所擷取的資訊包括日期、時間和訊息類型 ([錯誤]、[警告]、[訊息])。
依預設,除錯等級設為錯誤。當管理員要進行下列作業時,除錯檔十分有用:
寫入自訂認證模組。
使用 Access Manager SDK 寫入自訂應用程式。amProfile 和 amSDK 除錯檔會擷取此資訊。
使用主控台或 SDK 對存取權限進行疑難排解。amProfile 與 amSDK 除錯檔也會擷取此資訊。
疑難排解 SSL。
疑難排解 LDAP 認證模組。amAuthLDAP 除錯檔會擷取此資訊。
應將我們以後可能會收到的疑難排解指南與除錯檔配合使用。例如,當 SSL 失敗時,某些人可能會開啟除錯訊息並尋找 amJSS 除錯檔中的任何特定憑證錯誤。
Access Manager 包含 ammultiserverinstall 程序檔,可用於配置數個伺服器實例。若多重伺服器實例配置為使用不同除錯目錄,則各個實例都必須有讀取和寫入除錯目錄的權限。