除錯檔案

除錯檔案並非記錄服務的功能。它們是使用獨立於記錄 API 的其他 API 寫入。除錯檔案儲存在 /var/opt/SUNWam/debug。此位置 (以及除錯資訊的等級) 可在 AMConfig.properties 檔案中配置，此檔案位於 AccessManager-base/SUNWam/lib/ 目錄中。如需關於除錯特性的更多資訊，請參閱「Access Manager Administration Reference」中的 AMConfig.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 除錯檔案中的任何特定憑證錯誤。