test

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

第 8 章 错误诊断

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

本章包括以下各节：

一般错误诊断方法

本节提供了查找问题根源的一般性指导原则。其中包括以下主题：

网络连接

在独立的计算机上不支持 Java ES 安装。您只有将计算机连接到网络上，才能安装 Java ES。

检查 Directory Server 连接

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

在“安装后手动配置”模式下，在配置依赖于 Directory Server 的产品之前，需要确保 Directory Server 处于运行状态。

检查安装后配置

如果在启动组件时出现问题，请检验是否正确执行了第 5 章，完成安装后配置所介绍的过程。

检查资源和设置

以下主机层级问题可能会导致安装问题：

在继续安装之前，参阅系统要求来检查是否满足了所有要求。

检查分发介质

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

检查组件日志文件

如果在启动某个组件时出现问题，检查该组件的日志文件。在组件错误诊断信息下列出了许多组件的日志文件。

检查安装日志文件

如果在安装或卸载过程中出现问题，检查 %TEMP%/SunJavaES.log 目录中的相应日志文件。

%TEMP% 是该系统上用户自定义的 TEMP 文件夹。

检查卸载程序和安装程序日志文件（以及 Java ES 配置日志）可有助于找出问题的根源所在。

Procedure检查安装日志文件

  1. 查看安装摘要文件，其中提供了对所安装和配置内容的高级说明。此文件位于 JavaEs-install-dir\Summary.txt。如果出现问题，请检查是哪个组件引发了该问题。如果出现多个问题，请查出第一个问题。

  2. 查看详细的日志文件。

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

    2. 找到引发该问题的组件的名称。

    3. 查看配置日志。配置日志位于组件安装目录中。有关组件日志文件的确切位置，参阅 Summary.txt。

    4. 在安装程序日志文件中查找安装或卸载问题。在配置日志中查找与配置相关的问题。

删除文件和目录

为防止覆写自定义文件（如，经过编辑的配置文件），不能将 Java ES 5 组件安装到其各自的、含有文件的安装目录中。

如果要重新安装 Java ES 5，检查安装目录，以确保它们为空。如果这些目录不为空，将其中的文件归档到其他位置，然后重新尝试安装。

检验密码

安装程序会要求您为组件输入一些密码。如果要在不同的主机上安装不同的组件，请确保您在每台主机上都提供相符的密码。

要解决密码问题，可能需要卸载后再重新安装。如果卸载失败，参阅由于卸载过程中的残留文件而导致安装失败。

检验组件依赖性

许多组件在安装时都具有相互依赖性。影响一个组件的问题也会影响其他组件。要检查是否有未满足的相互依赖性，需要熟悉依赖性检查中的信息。然后执行以下操作：

安装问题

本节讨论您可能会在安装过程中遇到的以下问题：

由于卸载过程中的残留文件而导致安装失败

如果卸载失败，则您的主机系统上可能会残留有应该被删除的组件。在这种情况下，您必须在重新安装 Java ES 之前手动删除这些组件。

Procedure删除残留文件

安装失败或取消配置失败之后，在重新安装 Java ES 之前，需要执行以下清除步骤。

  1. 确保所有 Java ES 服务已停止，并已通过“控制面板”>“管理工具”>“服务”菜单将其删除。

  2. 删除所有先前安装的 Sun 文件夹。如果无法删除该文件夹，请重新启动系统，然后再删除该文件夹。

  3. 检查是否有任何残留的服务条目。如果“服务”中残留有任何服务条目，则需要通过删除这些条目清理注册表。下表列出了可能的条目。

    组件名 

    服务条目 

    Common Agent Container 

    Common Agent Container 2 (#CRC:default) 

    HADB 

    HADB4.4MgmtAgent

    Message Queue 

    MQ3.7UR1_Broker

    Portal Server 

    sra.gateway. srainstance

    sra.netletproxy. srainstance

    sra.rewriterproxy. srainstance

    WebAdminServer 

    https-admserv70

    Web Console 

    Web Console 3.0.2 console 

    Web Proxy Server 

    Sun Java System Socks Server 4.0.4 (server1)

    Sun Java System Web Proxy Server 4.0.4 (proxy-server1)

    Sun Java System Web Proxy Server 4.0.4 Administration Server 

    Web Server 

    Sun Java System Web Server 7.0 (https-hostname.domainname)

    Sun Java System Web Server 7.0 Administration Server 

  4. 清理注册表。

    删除 HKEY_LOCAL_MACHINE\Software\Sun Microsystems\Entsys5\Installer。

  5. 如果执行了上述任何步骤，请在开始安装之前重新启动系统。

Windows 安装程序错误

安装可能会由于出现以下 Windows 安装程序错误而失败。

无提示安装失败

如果您曾经编辑过响应文件，则可能引入了错误。例如，检查以下几项：

解决问题，然后按创建响应文件中所述重新生成响应文件。

无提示安装失败：“响应文件不兼容或已损坏”

如果您正在创建响应文件时所在的同一平台上使用该响应文件，则该问题可能是由于未知的文件损坏错误所导致的。尝试生成新的响应文件，然后重新安装。

有关更多信息，参阅创建响应文件。

意外的外部错误

发生外部错误的可能原因如下：

如果在安装或配置过程中出现故障，则可能是由于部分安装所造成。运行卸载程序。如果卸载程序失败，请按照由于卸载过程中的残留文件而导致安装失败中的说明进行操作。

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

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

解决方法：采用以下解决方法之一：

组件错误诊断信息

本节提供有关组件错误诊断的各种快速提示，同时提供对有用文档的引用：

Access Manager 错误诊断提示

表 8–1 Access Manager 错误诊断提示

主题 

详细信息 

配置文件 

AccessManager-base\Config\AMConfig.properties

日志和调试文件 

日志文件目录： 

AccessManager-base\Logs

调试文件目录： 

AccessManager-base\Debug

调试模式 

参阅 Sun Java System Access Manager Developer’s Guide。

Application Server 错误诊断提示

表 8–2 Application Server 错误诊断提示

主题 

详细信息 

日志文件 

日志文件目录： 

ApplicationServer-base\Setup\

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

JaveES-install-dir\appserver\

消息日志文件名称：server.log，适用于每个服务器实例。

配置文件 

配置文件目录：ApplicationServer-base \Config.

错误诊断 

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

Directory Server 错误诊断提示

表 8–3 Directory Server 错误诊断提示

主题 

详细信息 

日志文件 

可在 tmp 文件夹中找到安装日志文件。

配置日志文件： 

  • DirectoryServer-base.Atimestamp

  • DirectoryServer-base.B timestamp

有关如何管理日志文件的信息，参阅 Sun Java System Directory Server 管理指南。

错误诊断 

参阅 Sun Java System Directory Server 管理指南。

HADB 错误诊断提示

表 8–4 HADB 错误诊断提示

主题 

详细信息 

日志文件 

  • HADB.properties

  • mgt.cfg

可执行文件位置 

JavaES-install-dir\Hadb\4.4.1-7\lib

错误诊断 

参阅 High Availability Session Store Administrator’s Guide。

Message Queue 错误诊断提示

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

主题 

详细信息 

日志文件 

安装日志文件： 

MessageQueue-base\var\instances\ instance-name\log

参阅《Sun Java System Message Queue 3.7 UR1 管理指南》。

错误诊断 

有关性能问题，参阅《Sun Java System Message Queue 3.7 UR1 Administration Guide》中的第 11  章 “Analyzing and Tuning a Message Service”。

有关 Message Queue 错误诊断的论述，参见《Sun Java System Message Queue 3.7 UR1 Administration Guide》中的第 12  章 “Troubleshooting Problems”以及 Message Queue 论坛，网址为：http://swforum.sun.com/jive/forum.jspa?forumID=24。

还可在知识库中找到其他文章，网址为 http://developers.sun.com/prodtech/msgqueue/reference/techart/index.html。

Monitoring Console 错误诊断提示

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

主题 

详细信息 

配置文件 

对于 Monitoring Console： 

  • MonitoringConsole-base\WEB-INF\web.xml

对于 Monitoring Framework： 

  • JavaES-install-dir\share\mfwk\config\mfwk.properties

日志文件 

对于 Monitoring Console： 

  • JavaES-install-dir\share\webconsole\console\console_config_log

对于 Monitoring Framework： 

  • JavaES-install-dir\share\mfwk\logs

错误诊断 

如果无法访问 Monitoring Console，参阅《Sun Java Enterprise System 5 监视指南》中的“Monitoring Console 故障排除”。关于如何诊断 Monitoring Console 的错误，参阅《Sun Java Enterprise System 5 监视指南》中的“Monitoring Framework 故障排除”。

Portal Server Secure Remote Access 错误诊断提示

表 8–7 Portal Server Secure Remote Access 错误诊断提示

主题 

详细信息 

调试日志 

Portal 网关调试日志位于 PortalServer-base\debug 目录中。

注 –

如果从 Access Manager Administration Console 开启了日志记录，Portal Server 服务的日志（如 NetFile）位于 AccessManager-base\debug 目录中。

Portal Server 错误诊断提示

表 8–8 Portal Server 错误诊断提示

主题 

详细信息 

日志文件和调试文件 

Portal Server 日志文件包括： 

  • psadmin 日志：PortalServer-base\data\admin

  • 配置日志：PortalServer-base\data\config

  • Portal Server 实例日志：PortalServer-base \data\portals\portal-id \logs\instance-id

Service Registry 错误诊断提示

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

主题 

详细信息 

日志文件 

默认日志文件：ServiceRegistry-base\domains\registry\logs\server.log

有关更多信息，参阅《Service Registry 3.1 管理指南》。

错误诊断 

参阅《Service Registry 3.1 管理指南》。

Web Proxy Server 错误诊断提示

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

主题 

详细信息 

日志文件 

默认日志文件： 

  • JavaES-install-dir\ instance-name\config\logs\errors

  • JavaES-install-dir\ instance-name\config\logs\access

  • JavaES-install-dir\ admin-name\config\logs\errors

  • JavaES-install-dir\ admin-name\config\logs\access

有关更多信息，参阅 Sun Java System Web Proxy Server 管理指南。

错误诊断 

参阅 Sun Java System Web Proxy Server 管理指南。

Web Server 错误诊断提示

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

主题 

详细信息 

日志文件 

errors 日志文件和 access 日志文件位于 WebServer-base\WebServer_Install.log 目录中。

errors 日志文件列出了服务器曾经遇到的所有错误。access 日志记录发送给服务器的请求和来自服务器的响应。有关更多信息，参阅《Sun Java System Web Server 7.0 管理员指南》。

错误诊断 

参阅《Sun Java System Web Server 7.0 Troubleshooting Guide》。

配置文件目录 

WebServer-base\https-instance-name\config

其他错误诊断信息

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