除錯檔

除錯檔並非 [記錄服務] 的功能。它們是使用獨立於記錄 API 的其他 API 寫入。除錯檔儲存在 /var/opt/SUNWam/debug。此位置 (以及除錯資訊的等級) 可在 AMConfig.properties 檔中配置，此檔位於 AccessManager-base/SUNWam/lib/ 目錄中。如需更多有關除錯特性的資訊，請參閱附錄 AAMConfig.properties 檔案。

除錯等級

除錯檔可記錄的資訊分為幾個等級。除錯等級是以 AMConfig.properties 的 com.iplanet.services.debug.level 特性設定。

1. Off— 不記錄除錯資訊。

2. Error— 此等級用於生產。生產時，除錯檔中應無錯誤。

3. Warning— 目前並不建議使用此等級。

4. 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 實例和除錯檔

Access Manager 包含 ammultiserverinstall 程序檔，可用於配置數個伺服器實例。若多重伺服器實例配置為使用不同除錯目錄，則各個實例都必須有讀取和寫入除錯目錄的權限。