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

如何对问题进行错误诊断

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

本节包含以下各小节：

检查安装日志文件

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

日志文件格式

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

摘要提供了针对所安装和配置的内容的高级说明。
详细版本 A 文件包含完整信息。
详细版本 B 文件包含有关日志消息的更多详细信息。
调试文件包含安装失败时的相关信息。在其他某个日志文件指示出现错误时使用调试文件。

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

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

表 9–1 日志文件格式


记录的实体	日志文件名称格式
安装程序	`Java_Enterprise_System_5_install.A`timestamp
	`Java_Enterprise_System_5_install.B`timestamp
	`JavaES_Install_log.`timestamp
	`Java_Enterprise_System_5_Summary_Report_install.` timestamp
卸载程序	`Java_Enterprise_System_5_uninstall.A`timestamp
	`Java_Enterprise_System_5_uninstall.B`timestamp
	`JavaES_UnInstall_log.`timestamp
	`Java_Enterprise_System_5_Summary_Report_uninstall.` timestamp

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

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

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

检查摘要文件。例如：

Java_Enterprise_System_5_Summary_Report_install. timestamp

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

检查详细日志。例如：

JavaES_Install_log timestamp

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

使用日志查看器

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

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

过滤的工作原理

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

语言。选择用于查看消息的翻译语言。默认设置为英语。此列表根据安装程序所存储的翻译资源包进行填充。如果未指定资源包，则各种消息和日志查看器界面均以英语显示。
时间戳。设置要过滤或显示的记录。选项为“查看全部”、“最近”和“最早”。
- 查看全部。过滤并显示全部数据。
- 最近。过滤全部数据，先显示最近的数据。
- 最早。过滤全部数据，先显示最早的数据。

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

日志级别。选择一个日志级别来过滤消息。选项有 SEVERE、ERROR、WARNING、INFO、CONFIG、FINE、FINER 和 FINEST。选择 FINEST 相当于选择显示所有记录。选择一个日志级别后，只有那些具有该日志级别或严重级别更高的消息才会显示出来。如果只希望包括那些具有指定的精确日志级别的消息，请单击“请勿包括更严重的消息”复选框。
日志程序。不选择日志程序或选择适用于所打开的文件的日志程序中的一个。日志程序（ULF 文件中的 moduleID）指明了安装程序的哪个部分在编写日志消息。主要的日志程序有 JAVAESConfig、JAVAESInstall 或 JAVAESUninstall。只会显示与所选日志程序关联的那些消息。此外，还可以指定产品组件日志程序。例如，WebServerInstall、AccessManagerConfig、DirectoryServerUnInstall。
内容。当在“仅显示包含以下内容的条目”文本框中输入字符串（如 "configure"）时，将只选择包含该字符串的消息。

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

只显示此文件中的 SEVERE 日志消息。
只显示日志级别高于或等于 ERROR 的日志消息。
只显示安装过程中日志级别高于或等于 ERROR 的日志消息。
只显示卸载事件中的日志消息。

运行日志查看器

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

在命令行中，导航到日志查看器的位置：
- 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

启动日志查看器。
./viewlog
将显示日志查看器的主页面。

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

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

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

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

单击“搜索”。

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

检验产品依赖性

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

查看摘要文件和日志文件以了解相关联的产品是否出现了错误。这有助于确定首先要修复的组件产品。
检查已指定正确的连接信息。例如：
- 您在配置 Directory Server 时提供的信息是否与为使用该 Directory Server 的产品组件所提供的目录信息相匹配？
- 为 Portal Server 或 Portal Server Secure Remote Access 提供的 Access Manager 信息是否与为 Access Manager 提供的信息相匹配？

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

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

检查资源和设置

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

更新。是否已应用了建议的更新（修补程序）？
磁盘空间。磁盘是如何分区的，安装目录指向哪些分区？安装目录 /var/sadm 和 /etc/opt，或您指定的非默认目录都需要足够的磁盘空间。
网络端口。在配置期间为 Java ES 产品组件提供端口号。请进行如下检查：
- 检查 /etc/services 文件中的标准端口号。
- 查看摘要日志文件以比较您的设置和标准设置。是否键入了错误的端口号或将一个服务器设置到一般用于另一个服务器的端口？
- 使用命令 netstat -a 查看系统当前使用的端口。是否指定了已被占用的端口号？
IP 地址。在配置期间指定 IP 地址。请确保输入了正确的 IP 地址。要解决以下问题：
- 本系统是否具有多个网络接口，而且每个接口具有自己的 IP 地址？
- 在高可用性配置中，是否指定了逻辑主机的 IP 地址或群集节点的 IP 地址？

检查安装后配置

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

检查分发介质

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

检查 Directory Server 连通性

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

为 Directory Server 指定了不正确的用户 ID 和密码。
指定了不正确的 LDAP 端口。
无法访问 Directory Server。

安装时，安装程序的交互模式会检查 Directory Server 连通性，但无提示模式则不会检查。如果在 Directory Server 不可用的情况下执行无提示安装，则可能无法安装 Access Manager 或 Portal 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) 手册页。

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

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