Sun Java System Portal Server Secure Remote Access 7.2 管理指南

使用除錯記錄檔排除故障

要排除 Rewriter 的故障，您需啟用除錯記錄檔。

除錯訊息分類如下：

錯誤 – 使得 Rewriter 無法復原的錯誤。
警告 – 不會對 Rewriter 的運作造成重大影響的警告。Rewriter 可從此類型的錯誤中復原，但可能會或不會造成不當行為。有些出現在警告中的訊息僅是告知性的。例如「Not rewriting image content」(未重新寫入影像內容) 被記錄為警告訊息。這個情況並不會造成重大影響，因為 Rewriter 並不會用於重新寫入影像。
訊息 – 這是 Rewriter 所提供最高層級的資訊。

設定 Rewriter 除錯層級

以超級使用者身份登入閘道機器，然後編輯下列檔案：
gateway-install-root/SUNWam/config/AMConfig-instance-name.properties

在 AMConfig-instance-name .properties 檔案的下列特性中，指定除錯檔案目錄：
com.iplanet.services.debug.directory=/var/opt/SUNWam/debug
其中 /var/opt/SUNWam/debug 是預設的除錯目錄。

從終端機視窗重新啟動閘道：

./psadmin start-sra-instance –u amadmin – f  <password file> –N <profile name>– t  <gateway>

當將除錯層級設定為 message 時，除錯會產生一組檔案。除錯檔案名稱會列出 Rewriter 檔案與其中包含的資訊。

表 4–2 Rewriter 除錯檔案


檔案名稱	資訊
RuleSetInfo	包含已用於重新寫入的所有規則集，皆記錄在此檔案中。
Original Pages	包含網頁 URI、resolveURI (若與網頁 URI 不同)、內容 MIME、套用至網頁的規則集、剖析器 MIME 與原始內容。與剖析有關的特定錯誤/警告/訊息亦會出現在此檔案中。在 message 模式中會記錄完整內容。在 warning 與 error 模式中只會記錄重新寫入期間發生的異常情況。
Rewritten Pages	包含網頁 URI、resolveURI (若與網頁 URI 不同)、內容 MIME、套用至網頁的規則集、剖析器 MIME 與已重新寫入的內容。當除錯模式設為 message 時，即會儲存這些資訊。
Unaffected Pages	包含未經修改的網頁清單。
URIInfo Pages	包含已找到及轉譯的 URL。所有其內容與原始資料相同的網頁詳細資訊將記錄至此檔案中。記錄的詳細資訊包括：網頁 URI、MIME 與編碼資料、用於重新寫入的 rulesetID 以及剖析器 MIME。

除了上述檔案之外，Rewriter 會產生一個用於未留存於上述檔案中的其他除錯訊息的檔案。檔案名稱包括兩個部分：第一部分為 pwRewriter 或 psSRARewriter，第二部分則為使用 portal 或 gateway-profile-name 的副檔名。

除錯檔案會顯示在入口網站或閘道中。這些檔案是位於 AMConfig-instance-name.properties 檔案中指出的目錄。

Rewriter 元件會產生下列檔案組以協助除錯作業：

prefix_RuleSetInfo.extension

prefix_OrginalPages.extension

prefix_RewrittenPages.extension

prefix_UnaffectedPages.extension

prefix_URIInfo.extension

其中

prefix 為用於 URLScraper 用途記錄檔的 psRewriter 或用於閘道用途記錄檔的 psSRAPRewriter。

extension 則為用於 URLScraper 用途的 portal 或用於閘道用途的 gateway-profile-name。

例如，若利用閘道上的 Rewriter 來轉換網頁並使用預設的閘道設定檔，則除錯作業會產生下列檔案：

psSRAPRewriter_RuleSetInfo.default

psSRAPRewriter_OriginalPages.default

psSRAPRewriter_RewrittenPages.default

psSRAPRewriter_UnaffectedPages.default

psSRAPRewriter_URIInfo.default

psSRAPRewriter.default