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

使用调试日志排除故障

要排除重写器故障，需要启用调试日志。

“调试消息”分为以下几类。

错误 – 重写器无法从中恢复的错误。
警告 – 对重写器的功能没有严重影响的警告。重写器能够恢复这类错误，但无法保证是否会造成异常行为。警告中显示的一些消息是为了提供信息。例如，“未重写图像内容”会作为警告消息被记录下来。这很合理，因为不允许重写器重写图像。
消息 – 重写器提供的最高级别的信息。

设置重写器调试级别

以根用户身份登录到网关机器并编辑以下文件：

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 时，调试会生成一组文件。调试文件名称列出了重写器文件及其中包含的信息。

表 4–2 重写器调试文件


文件名	信息
RuleSetInfo	包含重写时已使用的所有规则集。
Original Pages	包含页面 URI、resolveURI（若不同于页面 URI）、内容 MIME、已应用于该页的规则集、解析器 MIME，以及原始内容。与解析有关的特定错误/警告/消息也出现在本文件中。在消息模式下，会记录全部内容。在警告和错误模式下，只记录重写期间出现的异常。
Rewritten Pages	包含页面 URI、resolveURI（若不同于页 URI）、内容 MIME、已应用于该页的规则集、解析器 MIME，以及重写后的内容。当将调试模式设置为消息时，将会填写本文件。
Unaffected Pages	包含未经修改的页列表。
URIInfo Pages	包含已找到并经过转换的 URL。该文件会记录内容仍与原始数据相同的所有页的详细信息。所记录的详细信息有：页 URI、MIME 及编码数据、重写时所用的规则集 ID，以及解析器 MIME。

除了上述文件以外，重写器还会为调试消息生成一个文件，该文件未收入上述文件中。此文件名由两部分组成：第一部分是 pwRewriter 或 psSRARewriter；第二部分是使用 portal 或 gateway-profile-name 的扩展名。

调试文件在门户或网关中显示。这些文件在 AMConfig-instance-name.properties 文件指定的目录中。

重写器组件会生成下面的一组文件来帮助进行调试：

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。

例如，如果使用网关上的重写器来转换页并且使用了默认网关配置文件，则调试时会创建下列文件：

psSRAPRewriter_RuleSetInfo.default

psSRAPRewriter_OriginalPages.default

psSRAPRewriter_RewrittenPages.default

psSRAPRewriter_UnaffectedPages.default

psSRAPRewriter_URIInfo.default

psSRAPRewriter.default