test

适用于 UNIX 的 Sun Java Enterprise System 5 安装指南

第 9 章 错误诊断

本章针对如何解决 Sun JavaTM Enterprise System (Java ES) 安装和卸载问题提供一些建议。

本章包括以下各节：

如何对问题进行错误诊断

本节提供了一些指导原则，可用于分析和确定在安装和卸载 Java ES 时所出现的问题的原因。

本节包含以下各小节：

检查安装日志文件

如果在安装或卸载期间出现问题，首先可以在安装日志中查找有关所出现的情况的信息。信息、警告以及错误消息在完成用户选择、软件包处理以及各个安装或卸载步骤等操作后发布。有关安装、卸载和安装时配置的消息收集在源日志文件中。为每条消息所显示的信息包括日期和时间、日志级别、模块 ID 以及消息文本。但永远不会包括密码。

日志文件格式

有以下四种可捕获安装或卸载信息的日志文件：

日志消息采用 Sun 的标准格式统一日志记录格式 (Unified Logging Format, ULF) 进行存储。如果发现 ULF 难以读取，可使用 Java ES 日志查看器来查看日志消息。

源日志文件可使用文本编辑器进行编辑。下表列出了这些源日志文件的格式。

表 9–1 日志文件格式

记录的实体 

日志文件名称格式 

安装程序 

Java_Enterprise_System_5_install.Atimestamp

Java_Enterprise_System_5_install.Btimestamp

JavaES_Install_log.timestamp

Java_Enterprise_System_5_Summary_Report_install. timestamp

卸载程序 

Java_Enterprise_System_5_uninstall.Atimestamp

Java_Enterprise_System_5_uninstall.Btimestamp

JavaES_UnInstall_log.timestamp

Java_Enterprise_System_5_Summary_Report_uninstall. timestamp

卸载完成后，卸载程序将安装程序、日志查看器及其自身全部移除。但不会移除源日志文件，其存储于以下位置：

Procedure使用日志文件进行错误诊断

  1. 检查摘要文件。例如：

    Java_Enterprise_System_5_Summary_Report_install. timestamp

    如果出现了问题，请确定导致出现该问题的组件。确定是否出现了多个问题。您可能需要对详细日志中的一个日志进行查看或对这两个日志都进行查看。

  2. 检查详细日志。例如：

    JavaES_Install_log timestamp

    查找出现的第一个错误或警告并加以解决。有时，解决一个错误就会解决其后出现的多个似乎不相关的错误。

使用日志查看器

Java ES 日志查看器提供了一种图形显示，可用于查看来自 JavaES_Install_log.timestamp 文件或 JavaES_UnInstall_log.timestamp 文件的 ULF 日志消息。在日志查看器的主页面上，在“文件”菜单中选择“打开”，即可显示日志文件。如果指定文件已经存在或无法打开以进行写操作，将出现日志查看器错误，并将返回到日志查看器的主页面。此类文件不能存在于安装程序用来存储源日志的目录中。

单击“搜索”按钮后，符合过滤条件的消息将显示在一个单独的日志表格中。显示日志表格后，即可选择日志表格中的单独行进行详细显示（包括以多行格式显示）。

过滤的工作原理

要调整日志记录输出，可在选择 ULF 日志文件后，在日志查看器主页面上指明显示首选项和搜索条件。“显示首选项”指明希望所做选择以何种语言显示，以及在显示过滤的记录中使用的限制。

有以下三种过滤消息的方式，您可根据需要或严重级别程度来显示消息：按日志级别、按日志程序以及按内容。

一些典型的搜索条件包括：

Procedure运行日志查看器

由于日志查看器以只读模式进行工作，所以多个用户可同时运行日志查看器。

  1. 在命令行中，导航到日志查看器的位置：

    • Solaris SPARC：/var/sadm/prod/SUNWentsys5i/Solaris_sparc

    • Solaris x86：/var/sadm/prod/SUNWentsys5i/Solaris_x86

    • Linux：/var/sadm/prod/sun-entsys5i/Linux_x86

    • HP-UX：/var/sadm/prod/sun-entsys5i/HPUX_PA-RISC

  2. 启动日志查看器。


    ./viewlog

    将显示日志查看器的主页面。

  3. 在“文件”菜单中，选择要显示的日志文件。

    如果所选文件不是 ULF 文件，您将会收到一条消息，指出所选文件不是 ULF，不能进行选择。日志查看器只能用来显示 ULF 文件。

    如果没有可用的 ULF 日志文件，则说明可能尚未完成安装或卸载。请稍候并重试。

  4. 选择适合您的情况的“显示首选项”和“搜索条件”。

  5. 单击“搜索”。

    日志表格将显示符合过滤条件的记录。

检验产品依赖性

许多产品组件具有安装时相互依赖性。影响一个产品组件的问题会影响其他多个产品组件。首先，应熟知《Sun Java Enterprise System 5 安装规划指南》中的信息。

除了产品组件的相互依赖性外，某些产品组件还依赖于是否存在可能未在主机上安装的 Solaris 软件包。缺少这些软件包可能会导致安装失败。请阅读“发行说明”中的“软件需求”一节以获取详细信息。

如果在启动产品组件时出现问题，请检查该产品组件的日志文件。产品组件错误诊断提示中列出了许多产品组件日志文件的位置。

检查资源和设置

以下主机层问题可能会造成安装问题。

检查安装后配置

如果启动产品组件时出现问题，请检验是否正确遵守了第 6 章，完成安装后配置中介绍的过程。

检查分发介质

如果是从 DVD 或 CD 安装，请检查介质是否受污或损坏。脏磁盘可能导致安装问题。

检查 Directory Server 连通性

如果安装的产品组件依赖于 Directory Server，则问题可能是由以下问题之一所导致：

移除 Web Server 文件和目录

为了避免覆写自定义的文件（如已编辑的配置文件），不能将 Web Server 安装到包含文件的目录中。

如果要重新安装 Web Server，检查安装目录以确保目录是空的。如果目录不是空的，将文件归档到其他位置后再尝试安装。

检验密码

安装程序会提示您为产品组件提供相应密码。如果在不同的主机上安装不同的产品组件，则务必要确保在每台主机上提供的密码都相同。

要解决密码问题，可能需要卸载后再重新安装。如果卸载失败，参阅由于卸载期间遗留文件导致安装失败。

检查已安装或卸载的产品组件

如果已安装产品组件，但却存在问题且不能重新安装或卸载，请针对不同环境使用 pkginfo 命令 (Solaris)、rpm 命令 (Linux) 或 swlist 命令 (HP-UX) 来检查安装的组件软件包。将结果与《适用于 UNIX 的 Sun Java Enterprise System 5 安装参考》中的第 5  章 “可安装软件包列表”中所列出的 Java ES 软件包进行比较。其他错误诊断信息包含在由于卸载期间遗留文件导致安装失败中。

提示 –

在 Solaris 9 和 Solaris 10 中，还可以使用产品注册表（prodreg 工具），它提供了一个为组件及其软件包建立索引的图形界面，从而不必使用 pkg 实用程序。要调用产品注册表，可在命令提示符处键入 prodreg。有关更多信息，参阅 prodreg(1) 手册页。

检验进行卸载的管理员访问权限

在卸载过程中，可能需要授予管理员对卸载程序的访问权限，如授予管理员访问卸载程序的权限中所述。

解决安装问题

本节讨论了在安装过程中可能会遇到的下列问题。

由于卸载期间遗留文件导致安装失败

卸载可能会遗留一些产品组件文件或软件包。在这种情况下，可能需要手动删除这些文件或软件包才能重新安装 Java ES。安装程序会报告产品组件已存在于主机上，即便您认为已将其删除。

可能发生了下列情况：

Procedure清除部分安装

  1. 使用以下命令确定是否有软件包未安装完毕。

    Solaris OS：pkginfo -p

    Linux：rpm -qa |grep —I ^sun | xargs rpm -V

    HP-UX：swlist -l product sun-*

    该命令输出列出所有部分安装的软件包。使用返回的软件包名称，参阅《适用于 UNIX 的 Sun Java Enterprise System 5 安装参考》中的第 5  章 “可安装软件包列表”以找出这些软件包所属的产品组件。

  2. 移除组件或软件包。

    • 在 Solaris 9 或 10 上，使用 prodreg 工具。

      prodreg 工具管理您主机上的基于软件包的组件。您可以查看产品组件及其软件包，获得完整信息（包括相互依赖性）。可以使用 prodreg 工具安全地卸载产品组件并移除软件包。使用 prodreg 工具移除了某个产品组件后，就可以重新安装。

    • 在 Linux 上，使用 rpm -e 命令。

      要编辑产品注册表文件，请打开文件 /var/opt/sun/install/productregistry。该 XML 文件对每个产品组件都进行了描述。每个产品组件描述均以 <compid\> 标记开始，以 </compid\> 标记结束。删除该产品组件的整个条目。

    • 在 HP-UX 中，使用 swremove 命令。

      要编辑产品注册表文件，请打开文件 /var/adm/swproductregistry。该 XML 文件对每个产品组件都进行了描述。每个产品组件描述均以 <compid\> 标记开始，以 </compid\> 标记结束。删除该产品组件的整个条目。

  3. 核实以下目录中不包含 Java ES 产品组件或软件包：

    /opt

    /etc/opt

    /var/opt

  4. 再次运行安装程序。

由于卸载后产品注册表中移除了共享组件而导致安装失败

从 Java ES 5 版本开始，共享组件在安装后会列在产品注册表文件中。

Java ES 卸载程序会从系统中移除产品组件，但不会移除共享组件。卸载后，产品注册表仍会含有共享组件条目。如果在卸载后手动移除了任何 Java ES 共享组件，将不会从产品注册表中移除这些组件。因此，下一次安装 Java ES 5 时就会失败，因为安装程序会认为那些手动删除的共享组件依然存在（因为产品注册表文件中仍然包含这些组件的条目）。

提示 –

请勿手动从系统中移除 Java ES 共享组件。

建议修复。从产品注册表文件中移除相应的条目，或者移除产品注册表文件本身。从产品注册表文件移除条目可能导致文件被破坏，因此最好移除整个产品注册表。移除产品注册表文件之前，核实除了 Java ES 组件外，别的产品没有在使用该文件。

在 Linux 和 HP-UX 中没有与 Solaris OS 中存在的图形产品注册表等效的注册表。如果已手动移除 Linux 或 HP-UX 中的文件，则必须手动编辑产品注册表文件以移除这些条目。

无法将 IBM WebSphere 配置为 Portal Server Web 容器

WebSphere 可能没有运行，或者可能是指定了一个与 WebSphere 本机配置不匹配的 WebSphere 值。可通过两种方法来对此问题进行错误诊断。在 Solaris OS 上仅支持将 IBM WebSphere 作为 Web 容器。

检查配置

一种方法就是检查 WebSphere 实例的配置。

Procedure检查 WebSphere 配置

  1. 请确保 WebSphere 处于运行状态。

  2. 检查下列安装程序字段的值：

    • WebSphere 虚拟主机（状态文件中的 PS_IBM_VIRTUAL_HOST）

    • Application Server 名称（状态文件中的 PS_IBM_APPSERV_NAME）

  3. 使用 WebSphere 工具检查该配置，确保它与所输入的值相匹配

  4. 重试。

创建新实例

另外一种方法就是创建 WebSphere 实体的新实例。

Procedure创建 WebSphere 实体的新实例

  1. 使用 adminclient.sh 启动 WebSphere 控制台。

  2. 创建一个新的虚拟主机实例和一个新的 Application Server 实例名称。

  3. 单击“节点”（一般为主机名称）下的条目，并选择 "Regen WebServer Plugin"。

    该进程将新条目保存到安装程序用来查找合法名称的 plugin 配置文件中。

  4. 返回到安装程序并输入刚创建的值。

发生意外的外部错误

可能出现了电源故障或系统故障，或者为停止安装程序进程按了 CTRL/C 键。

建议修复。如果安装或配置过程中出现故障，可能是由于部分安装遗留的问题。运行卸载程序。如果卸载程序失败，按照卸载失败而遗留文件中的说明进行操作。

图形安装程序似乎没有响应

安装程序有时在屏幕上创建一个尚未作好接受用户输入准备的图像。在安装向导中，如果不等待一段时间，无法连续单击“下一步”。

建议修复。表示默认选择的按钮包含一个蓝色的矩形。有时会先出现按钮，之后再出现此矩形。单击按钮之前，请等待直到您看到蓝色矩形。

无提示安装失败：“状态文件不兼容或已破坏”

如果您正在创建状态文件时所在的同一平台上使用该状态文件，则该问题可能是由于未知的文件破坏错误导致的。可通过两种方法来对此问题进行错误诊断。

生成新状态文件

创建适用于平台的新 ID

如果创建状态文件的平台与当前正在运行无提示安装的平台不是同一个平台，则请为文件创建一个适用于平台的新 ID。有关如何执行此操作的说明，参阅创建合乎平台的状态文件 ID。

编辑状态文件后无提示安装失败

如果您编辑过状态文件，则可能已引入了错误。检查下列内容，然后按照创建状态文件中的说明重新生成状态文件。

建议修复。解决该问题并重新生成状态文件。

未显示手册页

出现这种情况的最可能的原因是未为所安装的组件正确设置 MANPATH 环境变量。

建议修复。更新 /etc/MANPATH 以指向新的手册页目录。参阅检验手册页。

解决卸载问题

本节讨论了在卸载过程中可能会遇到的下列问题。

找不到卸载程序

Java ES 安装程序会将卸载程序置于系统上的以下位置：

如果卸载程序不在此目录中，则可能发生了下列情况之一：

建议修复。按照卸载失败而遗留文件中所述手动清理系统。

卸载失败而遗留文件

如果由于卸载程序遗留文件或进程而需要手动清理，请执行下列过程，以从系统中移除软件包。

Procedure手动清理软件包的步骤

  1. 确定要移除的软件包。

    将系统上的软件包与《适用于 UNIX 的 Sun Java Enterprise System 5 安装参考》中的第 5  章 “可安装软件包列表”中所列出的 Java ES 软件包进行比较。（另参见由于卸载期间遗留文件导致安装失败）。可使用以下命令确定安装了哪些软件包：

    • Solaris OS pkginfo 或 prodreg 实用程序

    • Linux rpm 命令

    • HP-UX swlist 命令

  2. 停止 Java ES 产品组件的所有运行中的进程。

    有关停止进程的简要说明，参见第 6 章，完成安装后配置产品组件文档。

  3. 备份所有规划在以后安装时要使用的自定义配置和用户数据。

    查看 Java ES 产品组件的卸载行为提供了有关应备份的配置和用户数据的一些信息。有关更多信息，参阅各个产品组件的产品组件文档。

  4. 使用 pkgrm、rpm -e 或 swremove 命令移除 Java ES 组件软件包。

  5. 移除所有不打算在后续安装过程中使用的其余产品组件目录及其内容。如果确实规划以后使用这些目录，请将它们移动到其他位置。

  6. 更新位于以下位置的产品注册表文件：

    • Solaris OS：/var/sadm/install/productregistry

    • Linux：/var/opt/sun/install/productregistry

    • HP-UX：/var/adm/sw/productregistry

    卸载程序使用此注册表来确定主机上安装了哪些产品组件。安装程序和卸载程序都将在安装或卸载完成时更新产品注册表。

    注 –

    如果是手动移除软件包，而不是使用卸载程序，则必须编辑产品注册表，使其正确反映系统上安装的软件。

  7. 清除位于以下位置的系统日志文件：

    • Solaris OS：/var/sadm/install/logs

    • Linux 和 HP-UX：/var/opt/sun/install/logs

    在手动移除软件包后，这些日志文件可能没有正确反映系统的状态。

产品注册表已遭破坏

在卸载过程中，卸载程序将使用产品注册表文件来确定要卸载的内容：

解决 Common Agent Container 问题

本节将讨论下列问题，这些问题的出现与 Common Agent Container 共享组件有关：

端口号冲突

默认情况下，Java ES 随附的 Common Agent Container (V2.0) 保留了以下端口号：

如果对 Sun Cluster 软件的安装进行错误诊断，端口分配会不同，因为 Sun Cluster 软件使用了不同版本的 Common Agent Container。这种情况下，默认端口如下：

如果安装时已保留了这些端口号中的任一端口号，则请按下述步骤更改 Common Agent Container 所使用的端口号。

检查端口编号

有关通用代理容器 cacaoadm 命令的进一步信息，参见 cacaoadm 手册页。如果您无法通过命令行来查看此手册页，请检验是否正确设置了 MANPATH。参阅检验手册页。

Procedure检验 Solaris OS 的端口

  1. 以超级用户身份停止通用代理容器管理守护进程：


    /usr/sbin/cacaoadm stop

  2. 使用以下语法更改端口号：

    /usr/sbin/cacaoadm set-param param=value

    例如，将 SNMP 适配器所使用的端口由默认值 11161 更改为 11165：

    注 –

    对于 Sun Cluster 软件，请使用之前指定的端口。


    /usr/sbin/cacaoadm set-param snmp-adaptor-port=11165

  3. 重新启动通用代理容器管理守护进程：


    /usr/sbin/cacaoadm start

Procedure检验 Linux 或 HP-UX 的端口

  1. 以超级用户身份停止通用代理容器管理守护进程：


    /opt/sun/cacao/bin/cacaoadm stop

  2. 使用以下语法更改端口号：

    /opt/sun/cacao/bin/cacaoadm set-param param=value

    例如，将 SNMP 适配器所使用的端口由 11161 更改为 11165：


    /opt/sun/cacao/bin/cacaoadm set-param snmp-adaptor-port=11165

  3. 重新启动通用代理容器管理守护进程：


    /opt/sun/cacao/bin/cacaoadm start

超级用户密码安全性遭到破坏

可能有必要在运行 Java ES 的主机上重新生成安全密钥。例如，如果出现了超级用户密码已泄漏或者已遭到破坏的危险，则您应当重新生成安全密钥。Common Agent Container 服务所使用的密钥存储在以下位置：

Solaris OS：/etc/opt/SUNWcacao/securityLinux 和 HP-UX： /etc/opt/sun/cacao/security

在正常操作情况下，这些密钥可能保留在其默认配置中。如果由于密钥可能已遭到破坏而需要重新生成密钥，则可使用下列过程来重新生成安全密钥。

Procedure为 Solaris OS 生成密钥

  1. 以超级用户身份停止 Common Agent Container 管理守护进程。


    /usr/sbin/cacaoadm stop

  2. 重新生成安全密钥。


    /usr/sbin/cacaoadm create-keys --force

  3. 重新启动 Common Agent Container 管理守护进程。


    /usr/sbin/cacaoadm start
    注 –

    对于 Sun Cluster 软件，您必须将此更改传播到群集中的所有节点。有关更多信息，参见《Sun Cluster Software Installation Guide for Solaris OS》中的“How to Finish a Rolling Upgrade to Sun Cluster 3.1 8/05 Software”。

Procedure生成 Linux 和 HP-UX 密钥

  1. 以超级用户身份停止 Common Agent Container 管理守护进程。


    /opt/sun/cacao/bin/cacaoadm stop

  2. 重新生成安全密钥。


    /opt/sun/cacao/bin/cacaoadm create-keys --force

  3. 重新启动 Common Agent Container 管理守护进程。


    /opt/sun/cacao/bin/cacaoadm start

    有关 cacaoadm(1M) 命令的更多信息，参阅 cacaoadm 手册页。

解决安装后启动/重新启动问题

本节讨论了在安装后可能会出现的各种问题。

Monitoring 规则停止工作（“未知”状态）

如果已经重新启动了 Application Server，则 Application Server 与 Monitoring Console 之间的通信被中断，需要重新激活。先前使用的 Monitoring 规则不再起作用，并处于“未知”状态。如果已在 Application Server 主机上重新启动 Common Agent Container，则此问题仍将存在，因为还必须在 Monitoring Console 主机上重新启动 Common Agent Container。

Procedure重新建立 Application Server 与 Monitoring Console 的通信

  1. 以超级用户身份在 Application Server 所在的主机上重新启动 Common Agent Container。例如：


    /usr/sbin/cacaoadm start

  2. 然后转至 Monitoring Console 所在的主机，并重新启动 Common Agent Container。例如：

    如果 Common Agent Container 已在运行，请将其停止，然后使用以下命令启动它。

    在 Solaris OS 上：


    /usr/sbin/cacaoadm stop
/usr/sbin/cacaoadm start

    在 Linux 和 HP-UX 上：


    /opt/sun/cacao/bin/cacaoadm stop
/opt/suncacao/bin/cacaoadm start

Java DB 重新启动后未找到 Portal 数据库

在运行默认 Application Server 命令重新启动 Java DB （asadmin stop-databsse，然后 asadmin start-database）后，当您部署使用 Java DB 的 Application Server 样例时，可能会发生这一问题。再也无法访问 Portal Server 样例。

建议修复。解决这一问题的方法有多种：

  1. 不停止 Java DB。

  2. 如果 Java DB 已经停止，请使用以下命令重新启动 Java DB，以允许在其他位置创建 Application Server 数据库。

    Solaris OS：/asadmin start-database --dbhome /var/opt/SUNWportal/derby

    Linux 和 HP-UX：/asadmin start-database --dbhome /var/opt/sun/portal/derby

    如果希望数据库位于默认位置，请使用非默认端口启动 Java DB 的第二个实例，然后在 Application Server 样例 common.properties 文件中指定正确的 Derby 端口。例如：asadmin start-database --dbport 1528

产品组件错误诊断提示

本节中的各表格提供有关对产品组件问题进行错误诊断的各种快速提示，包括对有用文档的引用。本节包含以下各小节：

Access Manager 错误诊断提示

表 9–2 Access Manager 错误诊断提示

主题 

详细信息 

配置文件

AMConfig.properties

  • Solaris OS：/etc/opt/SUNWam/config

  • Linux 和 HP-UX：/etc/opt/sun/identity/config

日志和调试文件

日志文件目录： 

  • Solaris OS：/var/opt/SUNWam/logs

  • Linux 和 HP-UX：/var/opt/sun/identity/logs

调试文件目录： 

  • Solaris OS：/var/opt/SUNWam/debug

  • Linux 和 HP-UX：/var/opt/sun/identity/debug

调试模式

参阅《Sun Java System Access Manager 7.1 Developer’s Guide》中的 "Auditing Features" 一章。

Application Server 错误诊断提示

表 9–3 Application Server 错误诊断提示

主题 

详细信息 

日志文件

日志文件目录： 

  • Solaris OS：/var/sadm/install/logs/

  • Linux 和 HP-UX：/var/opt/sun/install/logs/

Application Server 实例日志目录（初始创建的实例的默认位置）： 

  • Solaris OS：/var/opt/SUNWappserver/domains/domain1/logs

  • Linux 和 HP-UX：/var/opt/sun/appserver/domains/domain1/logs

消息日志文件名称： 

server.log，适用于每个服务器实例

配置文件

  • Solaris OS：/opt/SUNWappserver/appserver/config/asenv.conf

  • Linux 和 HP-UX：/opt/sun/appserver/config/asenv.conf

错误诊断

参阅《Sun Java System Application Server Enterprise Edition 8.2 Troubleshooting Guide》。

Directory Server 错误诊断提示

表 9–4 Directory Server 错误诊断提示

主题 

详细信息 

日志文件

安装日志文件： 

  • Solaris OS：/var/sadm/install/logs

  • Linux 和 HP-UX：/var/opt/sun/install/logs

错误诊断

参阅《Sun Java System Directory Server Enterprise Edition 6.0 Administration Guide》中的第 I 部分, “Directory Server Administration”。

参阅《Sun Java System Directory Server Enterprise Edition 6.0 Administration Guide》中的第 II 部分, “Directory Proxy Server Administration”。

Message Queue 错误诊断提示

表 9–5 Message Queue 错误诊断提示

主题 

详细信息 

日志文件

安装日志文件： 

  • 对于 Solaris OS：/var/sadm/install/logs

  • 对于 Linux 和 HP-UX：/var/opt/sun/install/logs

代理日志文件： 

  • 对于 Solaris OS：/var/mq/instances/ instance-name/log

  • 对于 Linux 和 HP-UX：/var/opt/sun/mq/instances/ instance-name/log

错误诊断

参阅《Sun Java System Message Queue 3 2005Q4 Administration Guide》的“问题疑难解答”一章。

有关性能问题，参阅《Sun Java System Message Queue 3 2005Q4 Administration Guide》中的“分析和调整消息服务”。

Monitoring Console 错误诊断提示

表 9–6 Monitoring Console 错误诊断提示

主题 

详细信息 

配置文件

对于 Monitoring Console： 

  • 对于 Solaris OS：/opt/SUNWjesmc/WEB-INF/web.xml

  • 对于 Linux 和 HP-UX：/opt/sun/jesmc/WEB-INF/web.xml

  • 对于 Solaris OS：/etc/opt/SUNWmfwk/config/mfwk.properties

  • 对于 Linux 和 HP-UX：/etc/opt/sun/mfwk/config/mfwk.properties

  • 对于 Solaris OS：/etc/opt/SUNWmfwk/config/masteragent.properties

  • 对于 Linux 和 HP-UX：/etc/opt/sun/mfwk/config/masteragent.properties

日志文件

对于 Monitoring Console： 

  • /var/log/webconsole/console/console_config_log（所有平台）

  • /var/log/webconsole/console/console_debug_log（所有平台）

对于 Monitoring Framework： 

  • 对于 Solaris OS：/var/opt/SUNWmfwk/logs

  • 对于 Linux 和 HP-UX：/var/opt/sun/mfwk/logs

错误诊断

如果无法访问 Monitoring Console，参阅《Sun Java Enterprise System 5 监视指南》中的“Monitoring Console 故障排除”。如果在 Monitoring Console 中无法看到所监视的组件，参阅《Sun Java Enterprise System 5 监视指南》中的“Monitoring Framework 故障排除”。

Portal Server 错误诊断提示

Portal Server 与 Access Manager 使用相同的日志文件和调试文件。

表 9–7 Portal Server 错误诊断提示

主题 

详细信息 

调试文件

Solaris OS：/var/opt/SUNWam/debug

Linux 和 HP-UX：/var/opt/sun/identity/debug

Portal Server Desktop 调试文件： 

Solaris OS：/var/opt/SUNWam/debug/desktop 和 /var/opt/SUNWam/debug/desktop.dpadmin.debug

Linux 和 HP-UX：/var/opt/sun/identity/debug/desktop 和 /var/opt/sun/identity/debug/desktop.dpadmin.debug

dpadmin、par、rdmgr 和 sendrdm Portal Server 命令行实用程序具有可用来生成调试消息的选项。Portal Server Administration Guide 中介绍了这些选项。

日志文件

Solaris OS：/var/opt/SUNWam/logs

Linux 和 HP-UX：/var/opt/sun/identity/logs

错误诊断

参阅《Sun Java System Portal Server 7.1 Administration Guide》。

Portal Server Secure Remote Access 错误诊断提示

Portal Gateway 调试日志位于以下目录中：

注 –

对于 Solaris OS，当从 Access Manager Administration Console 打开日志记录时，Portal Server 服务的日志（如 NetFile）位于 /var/opt/SUNWam/debug 中。

Service Registry 错误诊断提示

表 9–8 Service Registry 错误诊断提示

主题 

详细信息 

日志文件

实例日志目录： 

  • Solaris OS：/var/opt/SUNWsrvc-registry/domains/registry/logs

  • Linux 和 HP-UX：/var/opt/sun/srvc-registry/domains/registry/logs

消息日志文件名为 server.log。

配置文件的位置

Solaris OS：/opt/SUNWsrvc-registry/install/install.properties

Linux 和 HP-UX：/opt/sun/srvc-registry/install/install.properties

错误诊断

参阅《Service Registry 3.1 Administration Guide》。

Sun Cluster 软件错误诊断提示

注 –

HP-UX 和 Linux 不支持 Sun Cluster 组件。

表 9–9 Sun Cluster 软件错误诊断提示

主题 

详细信息 

日志文件

默认日志目录：/var/cluster/logs/install

错误消息：/var/adm/messages

错误诊断

参阅《Sun Cluster Software Installation Guide for Solaris OS》。

Web Proxy Server 错误诊断提示

表 9–10 Web Proxy Server 错误诊断提示

主题 

详细信息 

日志文件

默认日志位置：

  • Solaris OS：/opt/SUNWproxy/proxy-instance-name /logs

  • Linux 和 HP-UX：/opt/sun/webproxyserver// proxy-instance-name/logs

错误日志文件列出了服务器遇到的所有错误。访问日志文件记录发送给服务器的请求和来自服务器的响应。有关更多信息，参阅《Sun Java System Web Proxy Server 4.0.4 Administration Guide》。

配置文件目录

对于 Solaris OS：/opt/SUNWproxy/proxy-instance-name /config

对于 Linux 和 HP-UX：/opt/sun/webserver/proxy-instance-name /config

调试模式

可以将 /server-root/proxy-instance-name /config/server.xml 文件中 LOG 元素的 loglevel 属性设置为以下值：info、fine、finer、finest。

Web Server 错误诊断提示

表 9–11 Web Server 错误诊断提示

主题 

详细信息 

日志文件

Web Server 日志文件有两种类型：errors 日志文件和 access 日志文件。errors 日志文件列出了服务器遇到的所有错误。access 日志记录发送给服务器的请求和来自服务器的响应。有关更多信息，参阅《Sun Java System Web Server 7.0 Administrator’s Guide》。

这些日志位于以下目录中： 

  • Solaris OS：/var/opt/SUNWwbsvr7/https- instancename/logs

  • Linux 和 HP-UX：/var/opt/sun/webserver7/https- instancename/logs

如果在“现在配置”安装期间 Web Server 配置失败，则参阅以下日志来获取附加信息： 

  • Solaris OS：/var/opt/SUNWwbsvr7/setup/WebServer_Install.log

  • Linux 和 HP-UX：/var/opt/sun/webserver7/setup/WebServer_Install.log

管理服务器错误日志位于以下位置： 

  • Solaris OS：/var/opt/SUNWwbsvr7/admin-server/logs/errors

  • Linux 和 HP-UX：/var/opt/sun/webserver7/admin-server/logs/errors

配置文件目录

  • Solaris OS：/var/opt/SUNWwbsvr7/https- instance-name/config

  • Linux 和 HP-UX：/var/opt/sun/webserver7/https- instance-name/config

其他错误诊断信息

本指南中的以下信息对错误诊断也是非常有用的：