Sun Java Enterprise System 5 Update 1 发行说明

本发行说明文档包含有关 Sun Java^TM Enterprise System (Java ES) 5 Update 1 的重要信息。在开始使用 Java ES 之前，请先阅读本文档，以改善总体的安装、升级和操作体验。本文档会根据需要适时进行更新，以描述所出现的新问题。参见修订历史记录以了解这些更新。可在 http://docs.sun.com/coll/1286.3 及 http://docs.sun.com/coll/1382.3 上的 Java ES 5 Update 1 文档集中找到本文档的最新版本。

这是 Java ES 的第一个更新发行版。针对 Java ES 5，Sun 为 Java ES 创立了一种新的发行模式，由此而推出了主要发行版、次要发行版以及更新发行版。更新发行版（如 Java ES 5 Update 1）重在提供错误修复和有限的一组增强功能，以使大多数现有用户都能够快速采用该版本。除了极少数例外情况，更新发行版 100% 与上个发行版本向后兼容。

由于更新发行版旨在快速采用，因此它们使用了与主要及次要发行版不同的交付机制。有关 Java ES 5 Update 1 交付机制的信息，参见获取 Java Enterprise System 5 Update 1 软件。

涉及的平台：本文档介绍了适用于以下平台的 Java ES：

• 适用于 SPARC^TM、x86 和 x64 平台的 Solaris 10

• 适用于 SPARC 和 x86 平台的 Solaris 9

• 适用于 x86 和 x64 平台的 Red Hat Enterprise Linux 4（AS 和 ES）

• 适用于 x86 和 x64 平台的 Red Hat Enterprise Linux 3（AS 和 ES）

• 适用于 PA-RISC 2.0 平台的 HP-UX 11i v1

• Microsoft Windows 2000 Advanced Server SP4

• Microsoft Windows XP SP2

• Microsoft Windows 2003 Enterprise Server SP1（32 位和 64 位）

有关平台的更多信息，参见平台要求和问题。

涉及的组件：本文档述及了随 Java ES 安装程序一起分发并由它进行安装的 Java ES 组件，其中包括过去由较早版本的 Java ES 安装程序所安装而现在通过应用 Java ES 累积修补程序簇或带有 java_es-5 关键字的各个修补程序来维护的组件。其中并未提及以其他方式分发和安装的 Java ES 组件。

涉及的主题：本文档介绍以下主题：

• Java ES 的一般平台要求和问题

• Java ES 的一般兼容性问题

• Java ES 的安装、升级和卸载的一般问题，安装程序和卸载程序，以及随安装程序和卸载程序分发的 Java ES 组件

由于本发行说明文档不介绍与组件使用的所有方面都相关的问题，因此您还应该阅读将要使用的 Java ES 组件的组件级发行说明。有关所提供组件级发行说明的列表，参见组件发行说明。

有关 Java ES 5 Update 1 新增功能的信息，参见《Sun Java Enterprise System 5 Update 1 What’s New》。

修订历史记录

组件发行说明

所有特定于组件的信息均会在相应组件的发行说明中进行介绍。可在 http://docs.sun.com/coll/1315.3 及 http://docs.sun.com/coll/1396.3 上找到以下组件发行说明。

获取 Java Enterprise System 5 Update 1 软件

Java Enterprise System 5 Update 1 软件通过以下几种方式提供：

• 以下载形式提供，其中包含所有软件组件的完整安装程序版本。

• 在 SunSolve 上以修补程序簇形式提供，其中包含将所有 Java ES 5 组件提升至 Java ES 5 Update 1 级别所需的累积修补程序。

• 在 SunSolve 上分别以单个修补程序形式提供，以关键字 java_es-5 进行标识。

上述这些获取软件的方式并非在所有支持的平台上都可行。可按照以下信息，根据您的操作系统和已安装的 Java ES 版本（如果有）来决定获取 Java ES 5 Update 1 软件的最佳方式。

• Solaris 9 和 10

  Java ES 版本	如何达到 Java ES 5 Update 1
  无	执行全新安装，为此先要下载适用于您的 Solaris 版本和硬件平台的完整 Java ES 5 Update 1 安装程序版本。下载后将其解压缩并运行安装程序。
  Java ES 5	从 Java ES 5 升级，为此要获取并应用适用于您的 Solaris 版本和硬件平台的累积修补程序簇，或是分别获取并应用适用于您的 Solaris 版本和硬件平台的各个组件修补程序（带有 java_es-5 关键字）。无论是哪种情形，都要首先查阅《Sun Java Enterprise System 5 Update 1 Upgrade Guide for UNIX》，以了解是否有任何特殊情况需要注意。
  早于 Java ES 5	从较早版本的 Java ES 5 升级，为此首先要查阅《Sun Java Enterprise System 5 Update 1 Upgrade Guide for UNIX》，以了解从所用版本升级所用组件的最佳方式。

• Red Hat Enterprise Linux 3 和 4

  Java ES 版本	如何达到 Java ES 5 Update 1
  无	执行全新安装，为此先要下载适用于 Linux 的完整 Java ES 5 Update 1 安装程序版本。下载后将其解压缩并运行安装程序。
  Java ES 5	从 Java ES 5 升级，为此要获取并应用适用于 Linux 的累积修补程序簇，或是分别获取并应用适用于 Linux 的各个组件修补程序（带有 java_es-5 关键字）。无论是哪种情形，都要首先查阅《Sun Java Enterprise System 5 Update 1 Upgrade Guide for UNIX》，以了解是否有任何特殊情况需要注意。
  早于 Java ES 5	从较早版本的 Java ES 5 升级，为此首先要查阅《Sun Java Enterprise System 5 Update 1 Upgrade Guide for UNIX》，以了解从所用版本升级所用组件的最佳方式。

• HP-UX 11i v1

  Java ES 版本	如何达到 Java ES 5 Update 1
  无	执行全新安装，为此先要下载适用于 HP-UX 的完整 Java ES 5 安装程序版本。下载后将其解压缩并运行安装程序。最后，仿照从 Java ES 5 升级继续操作。
  Java ES 5	从 Java ES 5 升级，为此要分别获取并应用适用于 HP-UX 的各个组件修补程序（带有 java_es-5 关键字）。首先要查阅《Sun Java Enterprise System 5 Update 1 Upgrade Guide for UNIX》，以了解是否有任何特殊情况需要注意。
  早于 Java ES 5	从较早版本的 Java ES 5 升级，为此首先要查阅《Sun Java Enterprise System 5 Update 1 Upgrade Guide for UNIX》，以了解从所用版本升级所用组件的最佳方式。

• Microsoft Windows（所有版本）

  Java ES 版本	如何达到 Java ES 5 Update 1
  无	执行全新安装，为此先要下载适用于 Windows 的完整 Java ES 5 安装程序版本。下载后将其解压缩并运行安装程序。最后，仿照从 Java ES 5 升级继续操作。
  Java ES 5	从 Java ES 5 升级，为此要获取并应用适用于 Windows 的累积修补程序簇，或是分别获取并应用适用于 Windows 的各个组件修补程序（带有 java_es-5 关键字）。无论是哪种情形，都要首先查阅《Sun Java Enterprise System 5 Update 1 Upgrade Guide for Microsoft Windows》，以了解是否有任何特殊情况需要注意。
  早于 Java ES 5	从较早版本的 Java ES 5 升级，为此首先要查阅《Sun Java Enterprise System 5 Update 1 Upgrade Guide for Microsoft Windows》，以了解从所用版本升级所用组件的最佳方式。

已过时和删除的功能

以下通告适用于 Java ES 的未来发行版。

• 在 Java ES 的下一个主要发行版中，可能会删除对 J2SE 1.4 的支持。

• 在 Java ES 的下一个主要发行版中，可能会删除对 Red Hat Linux 3 的支持。

• 在 Java ES 的下一个主要发行版中，可能会删除对 Microsoft Windows 2000 的支持。

• 在 Java ES 的未来发行版中，可能会删除 Service Registry。

• 在 Java ES 的未来发行版中，可能会删除 Service Registry 的 Portal Server 支持。

• 在 Java ES 的未来发行版中，可能会以 NetBeans 替换 Sun Java Studio Enterprise 和 Sun Java Studio Creator。

此发行版解决的问题

下表列出了曾在 Java ES 5 发行说明中报告而在 Java Enterprise System 5 Update 1 中已解决的分发、安装及卸载问题。有关在过去的组件级发行说明中所报告问题的状态信息，参见该组件当前版本的发行说明。

平台要求和问题

操作系统的硬件要求

安装和使用 Java ES 5 Update 1 需要的磁盘空间和 RAM 可能有很大差别，这取决于在系统上安装哪些组件。以下是在单个系统上安装所有组件时建议使用的最小值。为了获得更准确的值，可将发行说明中要在系统上安装的组件的值加到一起。

Solaris 要求和问题

建议的 Solaris 更新级别

尽管在 SPARC 和 x86 平台上，所有版本的 Solaris 9 和 Solaris 10 都支持 Java ES 5 Update 1，但 Sun 建议使用以下更新：

• Solaris 9：Update 7 (9/04) 或更新

• Solaris 10 SPARC：Update 1 (1/06) 或更新

• Solaris 10 x86：Update 2 (6/06) 或更新

支持的 Solaris 软件组

Java ES 在使用以下 Solaris 软件组安装的 Solaris 系统上运行：

• SUNWCXall – 整个 Solaris 软件组外加 OEM 支持

• SUNWCall – 整个 Solaris 软件组

• SUNWCprog – 开发者 Solaris 软件组

Solaris 10 上的最小安装 (6331921)

如果不安装 Sun Cluster 或 Sun Cluster Geographic Edition，Java ES 也可以在使用 SUNWCreq（核心系统 Solaris 软件组）或 SUNWCuser（最终用户 Solaris 软件组）进行最小安装的 Solaris 10 系统上运行。

要在安装了 SUNWCreq 的 Solaris 10 系统上安装 Java ES 5 Update 1，可添加下列软件包：

如果您要使用图形 (GUI) 安装程序，还要添加下列软件包：

请注意，为满足依赖性要求，必须在 SUNWxwplr 之前添加 SUNWxwplt。

Java ES 已使用上面列出的两种 Solaris 10 最小安装进行过测试。但是，使用 Java ES 组件的某些功能可能需要其他软件包。

必需的 Solaris 修补程序簇

许多 Java ES 组件都需有特定的 Solaris 修补程序才能正常运行。安装程序会根据选择安装的组件检查是否有这些修补程序，并报告任何需要添加的修补程序列表。如果要进行升级或是想在运行安装程序之前对系统进行准备，可以下载并应用修补程序簇，其中包含运行所有 Java ES 组件所需的所有操作系统修补程序。要获取其中的一个修补程序簇：

1. 请转至 http://sunsolve.sun.com。

2. 单击 "Patches and Updates"。

3. 单击 "Recommended Patch Clusters"。

4. 找到以 "Java ES Required OS" 开头并适用于您的操作系统版本的修补程序簇，将其下载。

注意，这些修补程序簇可能包含 Solaris 内核修补程序。因此，您要确保：

• 认真阅读修补程序簇的自述文件。同时要阅读簇中每个修补程序（特别是内核修补程序）的自述文件。

• 在单用户模式下安装修补程序簇，并在安装后执行重新配置重新引导 (boot -r)。如果某些修补程序安装失败并报告“调用其他修补程序命令之前需要重新配置重新引导”，则需要在重新引导后再次安装该修补程序簇。

还要注意，Java ES 所需的大多数操作系统修补程序已包括在最近的 Solaris 更新中。因此，如果您要运行最近的 Solaris 更新，可以运行 Java ES 安装程序以搜索需要应用的几个修补程序并进行下载，而不是下载整个修补程序簇。

Linux 要求和问题

支持的 Linux 版本

Java ES 5 Update 1 支持适用于 x86 及 x64 平台的 Red Hat Enterprise Linux 3（Advanced Server 和 Enterprise Server）、适用于 x86 及 x64 平台的 Red Hat Enterprise Linux 4（Advanced Server 和 Enterprise Server）以及对这些版本的所有更新。

Sun 建议您使用 Red Hat Enterprise Linux 4 的最新更新。

root 不是适用于 x86 的 Red Hat Linux 3 update 8（AS 和 ES）上的有效用户 (6460658)

在运行 Red Hat Enterprise Linux 3 update 8 的 x86 系统上安装 Java ES 5 Update 1 时，不识别 "root" 系统用户。

解决方案：安装 Java ES 之前，首先从 Red Hat 站点安装最新的 coreutils-4.5.3-28.4.i386.rpm 和 coreutils-4.5.3-28.4.x86_64.rpm。

HP-UX 要求和问题

支持的 HP-UX 版本

Java ES 5 Update 1 在 PA-RISC 2.0 平台上支持 HP-UX 11i v1（通过 uname 命令显示为 11.11）。

HP-UX 所需的升级和修补程序

在 HP-UX 上安装、配置和运行 Java ES 组件之前，必须安装某些软件更新和修补程序。这些更新包括：

• Transport Optional Upgrade Release (TOUR) 3.1

• GOLDQPK11i(B.11.11.0509.429) Sept 2005 Quality Pack

  • GOLDAPPS11i(B.11.11.0509.429)

  • GOLDBASE11i(B.11.11.0509.429)

修补程序包括：

• PHSS_30966

• PHCO_29328

• PHKL_25842

• PHNE_29445

这些更新和修补程序可从 HP IT 资源中心获得，网址为 http://itrc.hp.com。

Windows 要求和问题

支持的 Windows 版本

Java ES5 Update 1 支持以下 Microsoft Windows 版本：

• Windows 2000 Advanced Server SP4 和 Data Center Server SP4

• 适用于 x86 及 x64 平台的 Windows 2003 Standard SP1 或更高版本、适用于 x86 及 x64 平台的 Windows 2003 Enterprise SP1 或更高版本以及适用于 x86 平台的 Windows 2003 Data Center Server SP1 或更高版本

• Windows XP Professional SP2

对于所支持版的 Windows 2003，Sun 建议您使用 SP2 或更高版本。

Java ES 5 Update 1 所支持的平台虚拟技术

平台虚拟是指在共享硬件之上的包容环境中运行多个不相关客操作系统的能力。由于平台虚拟具有许多优点，目前已推出了各种各样的虚拟技术和产品。

经过测试，Sun 支持部署在使用 Logical Domains (LDoms) 软件虚拟化的 Solaris 10 环境上运行的 Java ES 5 及 Java ES 5 Update 1 组件，该软件是在 Solaris 10 11/06 中引入的。

LDoms 在基于 UltraSPARC T1 和 T2 的服务器上运行。有关 LDoms 及其功能和要求的信息，参见 Logical Domains 文档集 (http://docs.sun.com/coll/ldom1.0)。

如果在 LDoms 以外的虚拟化环境内所支持的操作系统中部署 Java ES 组件时遇到问题，可能会首先要求您在非虚拟化环境中演示该问题，然后 Sun 才能提供相应的服务。

如同在非虚拟化环境中部署一样，应为每台虚拟机分配所建议的资源（处理器、内存、存储器等等），以确保达到足够的应用程序性能级别。有关所建议和支持的系统要求，参见组件文档。

Java ES 5 Update 1 支持的 Web 浏览器

Java ES 5 Update 1 组件提供的基于 Web 的管理界面至少支持以下 Web 浏览器：

• Solaris 9 和 10、Windows 2000 和 XP、Red Hat Linux 3 和 4 以及 Mac OS X 上的 Firefox® 1.0.7

• Solaris 9 和 10、Windows 2000 和 XP、Red Hat Linux 3 和 4、HP-UX 以及 Mac OS X 上的 Mozilla^TM 1.7.12

• Solaris 9 和 10 以及 HP-UX 上的 Netscape^TM Communicator 7.1

• Windows 2000 和 XP 上的 Netscape Communicator 8.0.4

• Windows 2000 上的 Microsoft Internet Explorer 6.0 SP1

• Windows XP 上的 Microsoft Internet Explorer 6.0 SP2

• Windows XP 上的 Microsoft Internet Explorer 7.0

有关 Java ES 5 Update 1 组件提供的最终用户 Web 界面支持的 Web 浏览器的信息，参阅提供该界面的组件的发行说明。Java ES 5 Update 1 组件的发行说明可从 http://docs.sun.com/coll/1315.2 及 http://docs.sun.com/coll/1396.2 获得。另参见 组件发行说明。

Java 平台、标准版 (Java SE) 要求

已证实在 Solaris 和 Linux 上，Java Enterprise System 可以与Java SE 5.0 Update 12 (1.5.0_12) 一起使用并将其收纳进来，而且已证实除 High Availability Session Store (HADB) 以外的所有组件均可与 Java SE 6 一起使用。已证实在 HP-UX 上，Java Enterprise System 可以与 Java SE 5.0 Update 3 (1.5.0_03) 一起使用并将其收纳进来。已证实在 Windows 上，Java Enterprise System 可以与 Java SE 5.0 Update 12 (1.5.0_12) 一起使用并将其收纳进来。

此外，以下各项与 Java SE 1.4.2 兼容：

• 共享组件

• 最终用户客户机应用程序

• 公共 Java API

特定组件可能支持其他版本的 Java SE，或可能存在与某些版本的 Java SE 的兼容性问题。有关信息，参见该组件的发行说明。

兼容性问题

以下各小节介绍了 Java ES 5 Update 1 与 Java ES 5 之前的 Java ES 发行版的向后兼容性方面的问题。另外，此处只提到那些涉及多个 Java ES 组件或是与 Java ES 安装程序或卸载程序有关的问题。有关特定组件向后兼容性的信息，参阅该特定组件发行说明中的兼容性信息。有关组件发行说明的列表，参见组件发行说明。

Java SE 5.0 Update 12 与 Application Server 7 不兼容 (2137473, 6203688, 6409072)

已证实 Java ES 5 Update 1 可以与 Java SE 5.0 Update 12 (1.5.0_12) 一起使用。如果 Java ES 安装程序在系统上找不到此版本的 Java SE，则安装程序会通过符号链接 /usr/jdk/entsys-j2se 安装此版本并使其可用于 Java ES 组件。

Java ES 2004Q2 随带的 Application Server 7 版本利用了此符号链接，但是与 Java SE 5.0 Update 12 不兼容。因此，安装 Java ES 5 Update 1 组件后，Application Server 7 会停止正常工作。

解决方案：Java ES 不支持在单个系统上混用版本 2004Q2 和版本 5 Update 1 组件。从 Java ES 2004Q2 升级系统时，必须升级所有组件。如果升级过程中需要访问 Application Server 7，可以更改其配置，使其指向随 Java ES 2004Q2 一起安装的 Java SE 1.4.2：

1. 登录到 Sun Java System Application Server 7 管理控制台。

2. 更新管理服务器和每个应用服务器实例的 Java 设置，更改 Java 主目录，使其指向 Java SE 1.4.2 位置。记住对每个实例“应用更改”。

3. 停止所有应用服务器实例，包括管理服务器。

4. 在 Application Server 7 的 config 子目录中修改 asenv.conf 文件，将 AS_JAVA 设置为指向 Java SE 1.4.2 位置。

5. 重新启动 Application Server 7。

Java ES 5 Update 1 共享组件与以前版本的 Instant Messaging 不兼容 (6440340)

使用 Java ES 安装程序升级或安装共享组件后，已经安装在系统上的以前版本的 Instant Messaging 可能不会再正常工作。症状包括启动 Instant Messaging 多路复用器或服务器失败。

出现此问题的原因是 Java ES 5 Update 1 的 Sun Java System Instant Messaging 和 Presence API (IMAPI) 共享组件与以前版本的 Instant Messaging 不兼容。在以下情况下，Java ES 安装程序安装或升级 IMAPI：

• 安装 Portal Server

• 安装 Service Registry

• 安装或升级所有共享组件

因此，此问题仅限于这些情况。

解决方案：将 Instant Messaging 升级到版本 7.2。

安装问题

以下信息与使用 Java Enterprise System 安装程序的安装过程相关。

一般安装问题

使用 Java ES 安装程序安装组件后，必须使用卸载程序进行卸载（无错误号）

如果直接删除组件软件包或 RPM，则安装程序下次运行时，会看到组件仍安装在系统中，但不能正常运行。

解决方案：如果已手动删除了组件软件包或 RPM，仍必须使用 Java ES 卸载程序卸载组件。

在 CLI 模式下，即使交换空间不足，Java ES 安装程序仍继续运行 (6436570)

如果运行 Java ES 安装程序的系统没有足够的交换空间运行安装程序，CLI 模式安装程序 (./installer -nodisplay) 在显示包括以下内容的一条错误消息后，仍继续运行：

com.sun.entsys.dre.DREException: Not enough space

解决方案：如果看到此消息，退出安装程序。然后，在再次运行安装程序之前，分配更多交换空间或释放现有交换空间。

在无提示模式下，如果状态文件具有无效的 id，则安装将会失败且不显示任何错误 (6585745)

如果在无提示模式下运行 Java ES 5 Update 1 安装程序并且所指定的状态文件具有无效的 id（例如，来自上一版本的 Java ES），则安装程序不会安装任何软件，而且不报告错误便退出。安装程序日志文件包含以下消息：

Exit Installation due to Error or User has selected exit on Warning.

解决方案：用 Java ES 5 Update 1 安装程序所生成的有效 id 替换状态文件中的 id。使用以下命令生成 id：

./installer -id

使用 —no 选项时，如果停止安装，安装程序就会抛出 InvocationTargetException (6592472)

如果以 —no 选项运行安装程序并在“正在安装”页面上停止安装，则安装程序会退出，同时抛出 InvocationTargetException：

InvocationTargetException thrown in method cancelConfirmed in class
com.sun.wizards.core.WizardTreeManager
java.lang.NullPointerException
        at ...

解决方案：无。

在 Solaris 10 上，完全根区域中的安装失败 (6451030)

在较早版本的 Solaris 10 上，当在完全根区域中安装 Java ES 时，安装程序可能会显示以下消息之一：

区域中不支持的组件
本地区域中不支持选定组件所需的以下组件，
而且不能将其直接安装到本地区域。请先从
全局区域安装这些组件，然后再继续进行安装

     SharedComponent

或者

您系统上安装的 Sun Web Console 软件包有缺陷，
这会阻止将 Java ES 安装在完全根非全局区域中。
为了更正这种情形，您必须先升级全局区域中的 
Sun Web Console 软件包，然后再将 Java ES 安装到
完全根区域 (whole root zone) 中。有关详细信息，
请参见 Java ES Release Notes（错误 6451030）和 Installation Guide。

之所以出现这两条消息是因为已安装的 Sun Java Web Console 软件包包含不正确的属性设置，致使安装程序无法对其进行升级。Solaris 10、Solaris 10 1/06、Solaris 10 6/06 和 Java ES 2005Q4 随带的 Sun Java Web Console 软件包均包含不正确的属性设置。

解决方案：要解决此问题，必须先在全局区域中升级 Sun Java Web Console 软件包，然后再在完全根区域中安装 Java ES。您有两种选择：

• 在全局区域中，运行安装程序并且只安装所有共享组件。这样不但会升级 Sun Java Web Console 软件包并修复区域属性，还会将其他所有 Java ES 5 共享组件都安装到全局区域中，并将它们传播到所有的非全局区域中。对于您所处的情况而言，这种做法可能无法接受，而且，如果已在完全根区域中安装了先前版本的 Java ES，则不建议这样做。

• 在全局区域中，只升级 Sun Java Web Console 软件包。为此，请登录到全局区域并导航到 Solaris 的 Java ES 5 安装目录。以超级用户身份执行以下操作：

  cd Product/sunwebconsole ./setup

  setup 脚本会在全局区域中升级 Sun Java Web Console 并将升级传播到所有的非全局区域。

在 Solaris 10 上，在稀疏根区域中进行安装时不报告全局区域中存在捆绑的 Application Server (6512640)

在稀疏根区域中安装 Java ES 时，安装程序会检查全局区域是否有必须先在全局区域中升级而后才能在稀疏根区域中安装的组件。但是，安装程序并不会将与 Solaris 10 捆绑在一起的 Application Server 版本报告为要升级的组件。

解决方案：在稀疏根区域中安装 Java ES 之前，先在全局区域中运行安装程序，如果安装程序将 Application Server 显示为“可升级”，就对其进行升级。

在 Solaris 10 上，引导完全根区域时会出现 Web Console 错误 (6584536)

安装 Java ES 时，安装程序会创建符号链接 /usr/jdk/entsys-j2se，以使组件能够访问同一版本的 Java SE。在全局区域中安装 Java ES 组件后，当您尝试引导完全根区域时可能会收到与 Web Console 有关的错误，原因是 Web Console 软件包已传播到完全根区域，但其所依赖的符号链接却未传播。

解决方案：通过在全局区域中输入以下命令（假定全局区域中所安装的版本为 Java SE 5），在完全根区域中手动创建符号链接：

ln -s /usr/jdk/instances/jdk1.5.0 zone-path/root/usr/jdk/entsys-j2se

其中，zone-path 是在创建完全根区域时指定的路径。

在 HP-UX 上，Java ES 安装程序存在性能问题 (6472918)

Java ES 安装程序会通过与 HP-UX 库存机制进行交互来查找已安装的组件、检查是否存在依赖性以及安装位码。库存机制的客户机-服务器体系结构会导致系统响应时间增长，并且与在其他平台上安装相比，重复的交互操作会使整个安装过程显著变慢。

解决方案：无。

在 Linux 和 Windows 上，Web Console 在将其容器从 tomcat 换为 Application Server 后 无法启动 (6534739, 6566515)

如果使用 wcswap 命令将 Web Console 所部署的容器从 tomcat 换为 Application Server，则 Web Console 会由于未在 Application Server 中为其创建域而无法启动。

解决方案：在 Linux 或 Windows 上，不要使用 Application Server 作为 Web Console 的容器。如果已经尝试将容器换为 Application Server，可以再次使用 wcswap 命令将 Web Console 的容器换回到 tomcat。

在 Windows 上，安装程序不检测 Sun Java Web Console 的现有安装 (6487548)

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

• 在实际进行 Java ES 5 安装之前，删除 Windows 机器上已安装的 Sun Java Web Console 版本。

• 再次向较新版本重新注册在上一个 Sun Java Web Console 版本中注册的应用程序，以便继续访问这些应用程序。

在 Windows 上，在具有 1 GB RAM 内存的机器上进行安装时会无法预料地失败 (6496578)

在 Windows 平台上，如果在低内存的机器上以在“安装过程中自动配置”模式下全部安装的方式进行安装，则在后配置阶段会无法预料地失败。

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

• 优化 Windows OS 虚拟内存设置。

• 在启动 Java ES 安装程序之前尽量释放 RAM，停止所有不必要的程序和服务。

• 执行选择性安装，使用“自定义”选项有选择地安装产品。

在 Windows 上，Windows System32 中的 DLL 与 Java ES DLL 冲突 (6496600)

当 Windows system32 文件夹中存在某些 DLL （如 libnspr4.dll、nss3 和 smime）时，就会发生此问题。

这些 DLL 与安装在 install-dir/share/lib 中的 Java ES 版本的 DLL 冲突，从而使 Java ES 服务器无法正常工作。

解决方案：在 system32 文件夹中将这些 DLL 重命名，以使 Java ES 服务器使用这些 DLL 的正确版本。

重命名这些 DLL 可能会导致在 system32 文件夹中安装了这些 DLL 的某些传统应用程序不起作用。

在 Windows XP SP2 上，安装之后用户无法登录到 Web Console (6498436)

解决方案：在 Windows XP Professional 上，必须禁用来宾帐户。

必须将注册表主键 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\ForceGuest 设置为 0，方可成功进行验证。

由于文件描述符限制低，安装程序不报告组件配置故障 (5018734, 6523904)

如果系统的文件描述符限制设置过低，则一些组件无法得到正确配置。安装程序不报告这类配置故障，但配置日志文件会显示这些故障。

解决方案：在安装之前，将文件描述符限制设置为一个高值，例如 1024 或 2048。安装后，可以将文件描述符限制重置回其以前的值。

Java ES 安装程序需要某种机制来查询产品许可证是否为测试版许可证 (6265136)

安装程序应检查共享组件是否为测试版组件，如果它确实是测试版组件，则将其替换。

解决方案：确保开始安装之前，工作站上没有安装测试版组件。

安装日志消息并非始终有效（无错误号）

请注意日志消息并非始终有效。例如，即使某些（但并非全部）组件产品在出现某类错误后完成了安装，仍会显示“未安装任何软件”消息。

组件选择页面中的组件自动选择出现混乱 (4957873)

当选择了某个组件产品时，安装程序会自动选择安装其依赖的任何组件产品。组件产品选择页面并不指示已随原组件产品一起选择了依赖的组件产品。

解决方案：无。

对于某些语言环境，界面中的窗口宽度不足 (4949379)

某些语言（如德语）的窗口宽度不够，无法显示整个界面。因此，一些元素（如提示）的文本在右侧或在底部会被截断。

解决方案：手动调整窗口大小。

Access Manager 安装问题

在 HP-UX 上，Access Manager 安装无法找到 gettext 二进制文件 (6497926)

在 HP-UX 上安装 Access Manager 时，安装失败，指示 Access Manager 无法找到 gettext 二进制文件。

解决方案：下载 getext 0.14.6 或更新版本并进行安装。

Access Manager SDK 配置导致 Web 服务器启动失败错误 (6293225)

Web 服务器启动失败问题可归咎于 Access Manager 的 SDK 配置。在当前方案中，AMConfig.properties 文件包含错误信息，从而导致出现一系列的 Web 服务器启动失败问题。下列变量包含的信息不正确：

• com.iplanet.am.directory.host

• com.iplanet.am.server.host

• com.iplanet.am.console.host

• com.iplanet.am.profile.host

• com.iplanet.am.naming.url

• com.iplanet.am.notification.url

解决方案：在节点 B 上（Access Manager SDK 随 Web Server 一起安装在此），修改 <Web_Server_Instance_dir>/config/server.xml 文件，将所需的 Access Manager JAR 文件添加到类路径中。

在现有 DIT 上安装 Access Manager 需要重新构建 Directory Server 索引 (6268096)

为提高搜索性能，Directory Server 拥有多个索引。因此，在现有目录信息树 (directory information tree, DIT) 中安装 Access Manager 之后，需通过运行 db2index.pl 脚本来重新构建 Directory Server 索引。例如：# ./db2index.pl -D "cn=Directory Manager" -w password -n userRoot

db2index.pl 脚本可在 DS-install-directory/slapd-hostname/ 目录中获得。

使用启用了 SSL 的 Directory Server 安装 Access Manager（无错误号）

如果已经安装 Directory Server 并且仅启用了 LDAPS (SSL)，Access Manager 安装将失败。要安装 Access Manager，首先为 Directory Server 启用 LDAP（而非 SSL）。完成 Access Manager 安装后，可以禁用 LDAP，仅启用 LDAPS。

在密码和根后缀中不允许使用单引号（无错误号）

在密码（如 amadmin 的密码）和 Directory Server 根后缀中，Access Manager 不支持单引号 (\q)。但支持反斜杠 (\\)。

如果 Directory Server 实现重置密码，则 Access Manager 的安装将会失败 (4992507)

在运行 Java Enterprise System 安装程序时，如果 Directory Server 配置为要求用户在首次登录时更改其密码，则 Access Manager 的安装将会失败。

解决方案：将 Directory Server 密码重置策略设置为“关”。

在不同的机器上分别安装 Access Manager 和 Directory Server 时，未初始化验证服务 (6229897)

尽管在安装过程中更新了 classpath 和其他 Access Manager Web 容器环境变量，但安装过程并未重新启动 Web 容器。如果试图在安装后、Web 容器重新启动之前登录到 Access Manager，则会返回下列错误：

验证服务未初始化。请与您的系统管理员联系。

解决方案：在登录到 Access Manager 之前，重新启动 Web 容器。登录前 Directory Server 必须在运行。

Access Manager 不更新 Application Server domain.xml (6439597)

Access Manager 未使用 JVM 选项和服务器类路径正确更新 Application Server domain.xml。已知这种现象会在下列情况下发生：

1. 安装并配置 Application Server 和 Directory Server。

2. 创建节点代理。

3. 创建非默认 Application Server 实例。

4. 在“以后再配置”模式下安装 Access Manager。

5. 编辑 amsamplesilent 文件，然后使用 amconfig 运行该文件。

6. 试图使用浏览器登录到 Access Manager 时，显示一条错误消息。

解决方案：在安装 Access Manager 之前，编辑 amsamplesilent 文件，使容器块包括以下信息：

AS81_HOME=/opt/SUNWappserver/appserver
AS81_PROTOCOL=$SERVER_PROTOCOL
AS81_HOST=$SERVER_HOST
#AS81_HOST=$DISTAUTH_HOST
AS81_PORT=$SERVER_PORT
AS81_ADMINPORT=$ADMIN_PORT
AS81_ADMIN=admin
AS81_ADMINPASSWD="$ADMINPASSWD"
AS81_INSTANCE=server1
AS81_DOMAIN=domain1
AS81_INSTANCE_DIR=/var/opt/SUNWappserver/nodeagents/nodename/server-instance
AS81_DOCS_DIR=/var/opt/SUNWappserver/nodeagents/nodename/server-instance/docroot
AS81_ADMIN_IS_SECURE=true

完成编辑后，运行 amconfig 命令：

./amconfig -s amsamplesilent

Application Server 安装问题

在安装 Domain Administration Server 之后，Node Agent 列为已安装并兼容 (6379283)

如果安装 Application Server Domain Administration Server，则在随后的安装会话中，Application Server Node Agent 列为已安装并兼容。出现此问题的原因是 Domain Administration Server 和 Node Agent 使用同一套软件包，而且仅配置不同。

解决方案：无。安装了支持节点代理的软件。要创建节点代理，请使用 asadmin create-node-agent 命令。有关更多信息，参见 create-node-agent(1)。

安装程序不识别用户在配置页面中输入的主机名 (4931514)

安装程序会提示您输入 Application Server 的“服务器名”。但是，无论您在文本字段中输入何内容，安装程序都使用计算机的实际主机名。

解决方案：如果服务器名与服务器的主机名不同，请以超级用户身份登录，然后在相应的域目录（“服务器根”目录）中键入以下命令：

# find . -type f -exec grep -l $HOSTNAME {} \\ ;

然后，相应地更改文件内容。

无法在 Linux 上启动域 (6396102)

在 Linux 上，试图启动域会生成引用 libstdc++ 的异常。发生这种情况的原因是 Application Server 需要在 Linux 上有某些兼容性库，而这些库在默认情况下不进行安装。

解决方案：安装以下兼容性库：

• compat-gcc-7.3-2.96.build.i386.rpm

• compat-gcc-c++-7.3-2.96.build.i386.rpm

• compat-libstdc++-7.3-2.96.build.i386.rpm

默认情况下不安装这些库，但它们可以在 Red Hat Linux 分发包中获得。注意，build 的值在不同版本的 Red Hat Linux 上可能不同。

在 Windows 上，HADB 实例在 Application Server 中未启动 (6480152)

如果 Windows 机器未连接到网络，则 HADB 实例就不会启动。

解决方案：将 Windows 机器连接到网络。

Directory Server 安装问题

在 Solaris 9 上安装后存在两种版本的 Directory Server（无错误号）

Solaris 9 捆绑了 Directory Server 5.1。因此，从 Java ES 5 Update 1 安装 Directory Server 后，系统中会存在两个版本：来自 Solaris 9 的 5.1 版本和来自 Java ES 的 6.2 版本。

在这类系统上使用 Directory Server 时，必须确保使用与您试图管理的 Directory Server 版本相关联的命令集。

在 Solaris 10 上，即使 Directory Server Control Center 正在运行，也无法与其联系 (6590078)

如果运行的是 Solaris 10 08/07 或带有 Solaris 修补程序 120037–19 (x86) 或 120473–10 (sparc) 或更新版本的 Solaris 10 系统，则在尝试连接到 Directory Server Control Center 时会收到以下形式的错误：

无法联系 hostname 上的 DSCC 代理。请使用命令 cacaoadm 检查是否安装了 
DSCC 代理并且正在端口 port-number 上运行该代理。

当与 Directory Server Control Center 通信的 cacao 进程为非超级用户所拥有时，就会出现此错误，而且即使 Directory Server Control Center 正在运行，该错误也会出现。

解决方案：安装修补程序 123896–14 (x86) 或 123893–04 (sparc) 或更新版本。

Monitoring Console 安装问题

Monitoring Console 不能与其他 Java ES 组件安装在同一主机上 (6441664)

Java ES 安装程序允许您选择任意组件和全部安装组件随 Sun Java System Monitoring Console 一起安装。但是，由于 Monitoring Console 的限制，如果 Monitoring Console 与其所监视的组件安装在同一主机上或 Solaris 区域中，它将不会运行。如果随其他组件一起选择了 Monitoring Console，安装将不会失败，但将无法配置和运行 Monitoring Console。

解决方案：在一台没有安装其他 Java ES 组件的专用主机上安装 Monitoring Console。运行安装程序时，如果安装其他组件，则不要选择安装 Monitoring Console。有关详细信息，参见《Sun Java Enterprise System 5 Update 1 Monitoring Guide》中的“To Install the Monitoring Console with the Java ES Installer” 过程。

或者，也可以使用 Solaris 10 操作系统在本地区域中创建专用逻辑主机，从而将 Monitoring Console 安装在与其他 Java ES 组件相同的物理机器上。有关详细信息，参见《Sun Java Enterprise System 5 Update 1 Monitoring Guide》中的“To Install the Monitoring Console in a Solaris Zone” 过程。

如果希望在先前安装并配置了 Monitoring Console 的主机上安装 Java ES 组件，请按照《Sun Java Enterprise System 5 Update 1 Monitoring Guide》中的“To Unconfigure the Monitoring Console” 过程进行操作。

Monitoring Console 必须安装在默认位置 (6471270)

如果 Monitoring Console 未安装在默认位置，Web Console 将无法找到它，因而无法启动它。

解决方案：安装 Monitoring Console 时不要指定默认位置以外的位置。

安装程序不自动配置 Monitoring Console（与 6488160 相关）

安装 Sun Java System Monitoring Console 后，Java ES 安装程序不自动配置和启动 Monitoring Console。

解决方案：安装后必须手动运行命令以配置和启动 Monitoring Console。参见《Sun Java Enterprise System 5 Update 1 Monitoring Guide》中的“Installing the Monitoring Console” 过程，然后参见《Sun Java Enterprise System 5 Update 1 Monitoring Guide》中的“Starting the Monitoring Console” 过程。

Portal Server 安装问题

在 Windows 上，Portal Server 不会被用作部署平台（无错误号）

在 Microsoft Windows 上，只能将 Portal Server 用作评估平台或开发平台。不能将其用作部署平台。

在 Windows 上，Java ES 安装程序得不到有效的 Portal Server 安装（无错误号）

如果在 Microsoft Windows 上使用 Java ES 安装程序安装 Portal Server，则最后得到的安装无法正常工作。

解决方案：不要在 Windows 上使用 Java ES 安装程序安装 Portal Server。而是要从 Sun 下载中心下载 Portal Server 7.1 Update 1，网址为 http://www.sun.com/download/products.xml?id=465e130d。按照下载时附带的 ReadMe 文件中的说明即可得到有效的 Portal Server 安装。

在 Windows 上，如果未在 DHCP 中配置反向查找，则 PS-SRA、FTP 和 Netlet 便无法工作 (6472391)

在 Netlet 中使用 IP 地址时，如果没有在 DHCP 服务器中为特定主机配置反向查找条目，就无法进行与该主机相关联的操作。

例如，如果 nslookup.exe ipaddress 无法返回主机名，就无法对这些 IP 地址进行 Netlet 操作。

解决方案：用主机名代替 IP 地址。

安装后无法登录到 Mobile Access (6437280)

发生该问题的原因是 AMLControllerFilter 过滤器的过滤器条目在 Access Manager Web 应用程序的 web.xml 文件中被注释掉。

解决方案：在 Access Manager Web 应用程序的 web.xml 文件中，取消对 AMLControllerFilter 过滤器条目的注释。

帮助文件链接对桌面上的 iFrameprovider 不起作用 (6199105)

在 SampleIFrame 频道单击帮助图标会生成“HTTP Status 404 — /portal/docs/en/desktop/iframechann.htm is not available”消息。

解决方案：无。未提供有关 iFrame 提供者的任何帮助。

Portal Server 的安装和卸载似乎挂起 (5106639, 6350387)

在安装和卸载 Portal Server 期间，安装程序和卸载程序似乎挂起。

解决方案：忽略表面上的不活动状态并等待 Portal Server 安装或卸载过程完成，在低端系统上，该过程可能要花长达 45 分钟的时间。

在 Portal Server Secure Remote Access 多会话安装期间，没有对访问主机进行验证 (6592103)

如果在一个安装程序会话中安装 Portal Server，随后在另一安装程序会话中安装 Portal Server Secure Remote Access，则安装程序不会对您在随后的会话期间在“Portal Server：Secure Remote Access：配置对 Portal 的访问”页面上提供的“访问主机”值进行验证。

解决方案：无。

在 Portal Server Secure Remote Access 多会话安装期间，没有对日志用户密码进行验证 (6592140)

如果在一个安装程序会话中安装 Portal Server，随后在另一安装程序会话中安装 Portal Server Secure Remote Access，则安装程序不会对您在随后的会话期间在“Portal Server：Secure Remote Access：配置对 Portal 的访问”页面上提供的“日志用户密码”值进行验证。

因此，portal.fabric 日志会包括诸如 PSFB_CSPFCO312: Incorrect LogUserPassword Entered 和 PSFB_CSPFCO189: Validation of gateway Data Failed 等错误。

解决方案：无。

Sun Cluster 安装问题

安装程序要求不适用于 Solaris 9 update 6 的修补程序 (6315304)

当在适用于 x86 平台的 Solaris 9 update 6 上安装 Sun Cluster 10 时，由于它所需的修补程序（修补程序 117714–06）在 update 6 上不适用，所以安装将会失败。

解决方案：无。在 x86 平台上，Sun Cluster 要求 Solaris 9 update 7 或更高版本。

运行 Solaris 10 的 x86 机器无法在群集模式下运行 (6299971)

由于对 Solaris 引导体系结构项目进行了更改，运行 Solaris 10 的 x86 机器无法在群集模式下运行。引导机器时显示下列错误消息：

必须依据许可证条款使用。
注意：无法打开 /etc/cluster/nodeid

注意：正在非群集模式下引导
注意：无 PCI 支持
注意：无 PCI 支持
正在配置设备。
主机名：pvyom1
devfsadm：minor_init 对模块 /usr/lib/devfsadm/linkmod/SUNW_scmd_link.so 失败。
加载 smf(5) 服务描述：24/24
/usr/cluster/bin/scdidadm：无法加载 DID 实例列表。
无法打开 /etc/cluster/ccr/did_instances。
未作为群集的一部分进行引导
/usr/cluster/bin/scdidadm：无法加载 DID 实例列表。
无法打开 /etc/cluster/ccr/did_instances。
注意：path_to_inst 可能未被更新。请根据需要使用 'boot -r' 进行更新。

解决方案：执行以下步骤：

1. 将 /etc/cluster/nodeid 添加到 /boot/solaris/filelist.ramdisk 中。

2. 输入以下命令：

   # bootadm update-archive # reboot -- -r

同时引导所有节点时无法构成 16 节点群集 (6320429)

如果试图同时引导 16 节点群集的所有节点，会导致节点故障，节点会挂起等待达到法定数目。

此错误是由于专用互连交换机的错误配置造成的。需要禁用交换机端口用于 Sun Cluster 专用互连的生成树。未对 16 节点群集上的交换机执行此操作，因而出现了此错误。由于此错误，群集无法进入联机状态。

为解决此问题，需要禁用交换机端口用于 Sun Cluster 专用互连的生成树。

解决方案：无。

Sun Cluster 本地化软件包安装显示警告消息 (6338473)

安装 Sun Cluster 本地化软件包时，在 Java ES 安装日志中显示以下警告消息。本地化软件包名为 SUNW*scspmu。未选择安装本地化组件时，不出现此警告消息。

警告：smreg 已过时，保留的目的只是为了与传统控制台应用程序兼容。请改用 wcadmin。

要查看更多信息，请键入 "man wcadmin" 或 "wcadmin --help"。

生成此警告的原因是 Sun Cluster 本地化软件包使用 smreg 命令而非 wcadmin 命令，它是 Sun Java(TM) Web Console 3.x 中的一个新命令。由于该消息暗示客户需要执行另一个步骤完成 Sun Cluster 安装，因而会误导客户。

解决方案：此警告不是由于安装错误造成的。可以放心地忽略此警告消息。

Sun Cluster HA Application Server Agent 不支持 Application Server 8.1 和 HADB 8.1 (6212333)

安装程序为您提供了是否选择随 Application Server 和 HADB 8.1 一起安装 Sun Cluster HA Application Server Agent 的选项。但 HA Application Server Agent 不支持 Application Server 和 HADB 8.1。因此，无法配置 HA Application Server。

解决方案：不要随 Application Server 和 HADB 8.1 一起安装 HA Application Server Agent。

适用于以前版本 Directory Server 的 Sun Cluster 数据服务（ 无错误号）

Java Enterprise System 2005Q1 包含适用于 Sun Java System Directory Server 5 2004Q2 的 Sun Cluster 数据服务。 如果需要适用于 Sun Java System Directory Server 5.0（或 5.1）或适用于 Netscape HTTP 4.1.6 版本的 Sun Cluster 数据服务，可以在 Sun Cluster 3.1 数据服务 10/03 发行版中获得。如果您需要此发行版，请与 Sun 客户服务代表联系。

适用于 Oracle Parallel Server/Real Application Cluster 的 Sun Cluster 数据服务未从 Sun Cluster 3.1 CD 进行安装（无错误号）

而是从 Java Enterprise System 1 Accessory CD, Volume 3 安装。同样，数据服务也不是从代理 CD 安装的。而是从 Java Enterprise System 1 Accessory CD, Volume 3 安装的。

如果系统中已存在 Sun Cluster 代理，安装程序不允许再安装其他 Sun Cluster 代理（无错误号）

如果在运行 Java Enterprise System 安装程序之前已经安装了 Sun Cluster Agent，则安装程序不允许安装其他代理。

解决方案：使用 pkgadd 安装其他 Sun Cluster Agent。

Web Server 安装问题

在 Windows 上，成功在评估模式下进行配置后，Web Server 服务不启动 (6472285)

在 Windows 上，在 eval config 模式下安装 Web Server 后，没有自动启动 Web Server 服务。

解决方案：手动启动 Web Server 服务。

如果安装目录包含以前安装版本的文件，Web Server 安装将会失败（无错误号）

解决方案：备份所有配置文件。然后，在使用 Java Enterprise System 安装程序安装 Web Server 之前删除安装目录。

在 CLI 模式下，如果在 Web Server 安装期间指定的端口超出范围，则会产生令人费解的消息 (6592653)

在 CLI 模式下安装 Web Server 时，如果所指定的端口值超出范围，则安装程序会显示以下令人费解的消息：

EntSysResources:webServerInstancePanel-OUtOfRangeAdminPort-Error-CLI

解决方案：无。

Web Proxy Server 安装问题

在评估模式下配置成功后，Web Proxy Server 服务不启动 (6472289)

在 Windows 操作系统上，在 eval config 模式下安装 Web Server 后，没有自动启动 Web Proxy Server 服务。

解决方案：手动启动 Web Proxy Server 服务。

升级问题

《Sun Java Enterprise System 5 Update 1 Upgrade Guide for UNIX》提供了在 Solaris 和 Linux 平台上升级到 Java ES 5 Update 1 的说明。下面各节中的问题描述了升级指南中未介绍的情况，因此它们只应与升级指南结合使用，而不能替代升级指南。

升级指南以及下面各节中介绍的问题均通过发行版本和发行版本号指代 Java ES 发行版。下表显示发行版本和发行版本号如何关联：

升级问题明细

Access Manager pre61to62upgrade 脚本未正确处理基于 DB 的日志记录 (5042233)

在 Access Manager 从版本 6.1 到 6.2 的升级过程完成后，升级日志指出未正确处理基于 DB 的日志记录。

解决方案：无。Access Manager 从版本 6.1 到版本 6.2 的升级过程不支持 DB 日志表备份。

在其他组件升级到 Java ES 5 Update 1 之后，在 Application Server 中发生 JSP 编译错误 (6388329)

在运行 Application Server 发行版本 3 或发行版本 4（8.1 版本）的系统上将任何 Java ES 组件升级到 Java ES 5 Update 1 之后，编译 JSP 页面时，Application Server 报告错误。

解决方案：将 Application Server 升级到 Java ES 5 Update 1，或将以下修补程序应用到 Application Server 8.1：

• 在 Solaris 系统上：119166–17

• 在 Linux 系统上：119168–17

在 Solaris 和 Linux 上，Portal Server 升级失败 — 无法找到 /opt/SUNWappserver7/bin/asadmin (6313972)

解决方案：参阅以下出版物以获得有关此问题的最新升级文档：《Sun Java Enterprise System 5 Update 1 Upgrade Guide for UNIX》

在 Linux 上，将 Application Server 从 Java ES 3 升级后，Access Manager 停止工作 (6447925)

在 Linux 上将 Application Server 从 Java ES 3 升级后，Access Manager 停止工作，并且 server.log 文件指示启动 amlcontroller 时出现错误。

解决方案：手动安装 sun-jss (JSS 4) 和 sun-jss3：

1. 输入命令 rpm -qa | grep sun-jss 以检查 sun-jss 和 sun-jss3 是否存在。

2. 如果缺少 sun-jss，则手动进行添加：

   rpm -Uhv download-root/Linux_x86/Product/shared_components/Packages/sun-jss-4.2.4-4.i386.rpm

3. 如果缺少 sun-jss3，则手动进行添加：

   rpm -Uhv download-root/Linux_x86/Product/shared_components/Packages/sun-jss3-3.1.11-1.i386.rpm

在非英文语言环境中升级 Portal Server 7.1 后，某些 portal 应用程序无法正常工作 (6569515)

使用修补程序将 Portal Server 7.1 升级到 Portal Server 7.1 Update 2 时，在非英文语言环境中运行 psupdate 后，各种与 portal 相关的 Web 应用程序可能无法正常工作。

解决方案：在英文语言环境中重新运行 psupdate 脚本：

1. 显示并记下 $LC_ALL 和 $LANG shell 变量的当前值：

   echo $LC_ALL echo $LANG

2. 将这些变量设置为英文语言环境的值：

   export LC_ALL=en_US.UTF-8 export LANG=en_US.UTF-8

3. 重新运行 psupdate 脚本：

   psupdate -a -i

4. 恢复 $LC_ALL 和 $LANG 的值：

   export LC_ALL=在步骤 1 中记录的值 export LANG=在步骤 1 中记录的值

Web Server 和 Portal Server 具有特殊的升级依赖性（无错误号）

如果将 Portal Server 部署到即将升级到 Java ES 5 Update 1 的 Web Server 版本，则必须还要升级 Portal Server。

由于在 Windows 上无法将 Portal Server 升级到 Java ES 5 Update 1，故而也无法在升级 Web Server 时升级 Portal Server。必须转而在尝试升级 Web Server 之前，先行迁移 Portal Server，以使用 Application Server 作为它的容器。

对部署到 Web Server 中的 Portal Server 7.0 进行升级需要遵循非常规顺序 (6507069)

升级部署在 Web Server 中的 Portal Server IFR（Interim Feature Release，过渡功能版本）7.0 2005Q4 时，必须以非标准顺序升级组件。有关更多信息，参见《Sun Java Enterprise System 5 Update 1 Upgrade Guide for UNIX》。

对部署到 Web Server 的 Portal Server 7.0 进行升级后，无法创建新社区 (6562802)

升级 Portal Server 7.0 和 Web Server 后，尝试在 Portal Server 控制台中创建新社区时会产生错误。

解决方案：按以下步骤操作：

1. 登录到 Web Server 管理控制台。

2. 单击“配置”。

3. 选择正在运行的 Portal Server 实例的配置。

4. 单击 "Java" 选项卡。

5. 查看“类路径前缀”的“路径”设置。

6. 将 /opt/SUNWcacao/lib/cacao_cacao.jar 替换为 /usr/lib/cacao/lib/cacao_caca0.jar。

7. 保存更改并退出管理控制台。

升级 Portal Server 7.0 后，“开发者样例”中先前存在的社区无法使用 (6591992)

升级 Portal Server 7.0 后，无法再使用“开发者样例”中已存在的社区。

解决方案：更改文件 /var/opt/SUNWportal/portals/portal1/desktop/default/SearchProvider/dbMenu.jsp，如下所示：

com.sun.portal.desktop.util.OrderedMap dbs =
  (com.sun.portal.desktop.util.OrderedMap)pageContext.findAttribute(
  "availableDatabases");

java.util.Map dbs = (java.util.Map)pageContext.findAttribute(
  "availableDatabases");

若启用，含 Instant Messaging 的 Monitoring Framework 1.0 需要升级 (6515859)

如果在 Java ES 2005Q1 或 2005Q4 中启用 Instant Messaging 的监视功能，则在升级到 Java ES 5 Update 1 之后，需要手动升级属性文件。

解决方案：在给定主机上升级 Instant Messaging 实例之后，编辑新的 mfwk.properties 文件，使其中包含旧的 agent.properties 文件中希望保留的配置参数。

在适用于 x86 的 Solaris 9 上升级 Java ES 3 时，如果有两个版本的 cacao 正在运行，则 psupgrade 会失败 (6550198)

在适用于 x86 的 Solaris 9 上从 Java ES 3 进行升级时，可能会有两个版本的 cacao 正在运行：用于支持 Instant Messaging 的 Java ES 3 版本，以及用于支持已升级组件的 Java ES 5 Update 1 版本。在这种情况下，用于升级 Portal Server 的 psupgrade 脚本会失败。

解决方案：在运行 psupgrade 脚本之前，先停止 cacao 的 Java ES 3 版本：

/opt/SUNWcacao/bin/cacaoadm stop

在运行 psupgrade 之后，重新启动 cacao 的 Java ES 3 版本：

/opt/SUNWcacao/bin/cacaoadm start

在 Windows 上，使用“安装后手动配置”选项升级时会创建 Message Queue 和 High Availability，但不会创建 Application Server 程序组 (6500958)

每当在“安装后手动配置”模式下安装或升级产品组件时，只有对产品手动进行配置后，才会创建该产品的快捷方式。

Message Queue 不受此问题影响。

解决方案：无。

监视问题

本节介绍 Monitoring Console 和 Monitoring Framework 中的已知问题。Monitoring Framework 是一个共享组件，它随其他组件一起自动安装以启用监视。

执行监视所需的修补程序

为防止出现 Monitoring Framework 中的某些已知问题，需要以下修补程序。这些修补程序通常包括在 Java ES 所需的其他修补程序包或更新版本的 Solaris 操作环境中。但是，应在要监视 Java ES 产品组件的任何主机上检验是否存在这些修补程序或其替代程序：

对于 HP-UX 操作系统，监视所需的修补程序包含在HP-UX 要求和问题所介绍的那些修补程序中。

Monitoring Console 界面问题

未显示新的主机证书来进行检验 (6467360)

添加要监视的新主机时，Monitoring Console 使用 SSL 来保障连接安全，但不显示所选主机出具的证书。由于 Monitoring Console 会将主机的根密码传送给节点代理，因此就向攻击者暴露了一个致命弱点，使其得以乘机伪造欲攻击主机的 IP 地址并接收密码。但发生这种情况的风险很低，因为大多数节点代理运行所在的主机都已处于安全网络之内。

解决方案：如果节点代理主机不在安全网络内，则在将其作为新主机添加到 Monitoring Console 中之前，应当先检验其真实性。要检验主机的真实性，请登录到该主机并确保您认可其配置及文件系统。对于 UNIX 主机，可以使用 ssh 进行登录，以查看证书信息。

Application Server 指的是应用程序实例 (6495539, 6388513)

在 Monitoring Console 中，产品中包含的对象称为“应用服务器”。不要将此术语与 Sun Java System Application Server 混淆。

解决方案：在 Monitoring Console 的上下文中，应用服务器是指所安装 Java ES 组件的运行实例。

Monitoring Console 中的响应时间太久 ( 6490794, 6438443)

在某些情况下，在 Monitoring Console 中显示和切换页面所花费的时间长达 30 秒。

解决方案：在没有其他应用程序的功能强大的主机上运行 Monitoring Console。

没有简单的方法禁用特定组件的监视 (6446505)

Monitoring Console 不能以各个组件为基础启用或禁用监视。

解决方案：必须通过每个组件自身的机制来启用和禁用组件监视。有关说明，参见《Sun Java Enterprise System 5 Update 1 Monitoring Guide》中的第 2  章 “Enabling and Configuring the Monitoring Framework” 中特定于组件的章节。

控制台并不总能反映受监视组件停止的时间 (6487785)

当受监视组件崩溃或正常停止时，可能不会从代理节点中删除该组件受监视的对象，它们在 Monitoring Console 左侧的树中有可能仍然可见。同样，如果停止整个节点代理，可能也不会从左侧的树中删除主机节点。此问题间歇性地出现。

解决方案：停止或重新启动服务器实例时，可能需要重新启动节点代理、主代理和 Monitoring Console。如果停止主机及其节点代理，则可能需要重新启动主代理和 Monitoring Console。《Sun Java Enterprise System 5 Update 1 Monitoring Guide》中的“To Restart a Node Agent” 过程介绍了如何进行这两项操作。

监视规则和报警不随其主机一起删除 (6474032)

从 Monitoring Console 中删除主机时，不会自动删除与其受监视组件相关联的监视规则和报警。这样，如果再次添加同一主机，便会保持规则和报警状态。

解决方案：如果不打算再添加该主机，请使用“规则”对话框查找并删除与该主机相关联的所有规则。删除主机时存在的报警可能已确认，但由于无法再访问触发报警的受监视属性，这些报警仍会留在 Monitoring Console 中。为避免遗留已确认状态的报警，请在删除主机之前解析受监视组件中的所有报警条件，并在 Monitoring Console 中确认这些报警。

当设置了调度时间间隔时，“监视规则”中的“禁用”按钮不起作用 (6513968)

如果为某个规则设置了调度时间间隔，则无法禁用该规则。

解决方案：删除该规则，而不是将其禁用。

严重程度较低的 Monitoring Console 问题

下表跟踪 Monitoring Console 的其他已知问题。

6366190

默认情况下各种表未进行排序

6375583

从“使用此已安装产品的对象”链接的主机不应为未知对象

6388558

使用 AppServer 插件时，“此服务器包含的对象”不应包括子项的子项

6390983

启用和禁用功能在主机表中无法正确工作

6396891

显示 Statistics 和 Settings 对象的标题和说明字段，但不显示基对象的标题和说明字段

6495587

选择对象并单击“监视规则”->“新建”时，不应要求用户再次选择该对象

6405363

为给定主机列出的 JVM 对象的名称不一致

6405949

Application Server 创建的 CMM_Cluster 对象未在任何位置显示

6412408

“新建规则”对话框中可看到的对象的列表不清晰

6429231

Portal、Web 和 Application Server 对象的对象和操作状态显示为未知

6388513

在 Application Server 中部署的 Enterprise Java Bean 应有更多描述性名称

6434184

不能使用 Application Server 监视对象中的属性名称

6434241

内部 Application Server 配置变化未反映在 Monitoring Console 中

6446325, 6496542

Monitoring Console 应该能够公开域视图

6515039

在 de 语言环境中，联机帮助的索引与英文版本不一致

6572284

当设置了“显示选定对象”时，“显示处于以下状态的对象”功能无法正常工作

6581977

从规则中删除调度时间间隔会因脚本错误而失败

6592561

在 JVM-General 表中，某些字符串未本地化

6593147

在西班牙文用户界面中，版权字符串未本地化

6594741

在 Monitoring Console 用户界面中，许多字符串未本地化

6581987

将某规则的调度时间间隔从 0:00 更改为 0:00 时会删除该规则本身

Monitoring Framework 问题

在 Linux 上，C 组件的监视性能低下 (6332884)

依靠 C 库与 Monitoring Framework 连接的组件在 Linux 操作环境中运行时，可能在 Monitoring Console 中显示得更慢。

解决方案：无。

C 组件不能与节点代理安全通信 (6405037)

在同一主机上依赖于 C 库的组件和节点代理之间的进程间通信不安全。默认情况下，通信使用回送接口，因而降低了安全风险。

解决方案：无。

Java 组件的 SNMP 性能低下 (6437945)

通过 SNMP 访问时，依靠 Java 库与 Monitoring Framework 连接的组件可能会遇到性能问题。

解决方案：无。

节点代理无法在 Solaris 9 上找到受监视组件 (6504230)

由于 Solaris 9 中存在的一个错误，发往 IPv4 地址的包未传送到 IPv6 套接字上的侦听器。这会中断该主机上节点代理与受监视组件之间的搜索机制。

解决方案：使用以下命令强制节点代理的 JVM 侦听 IPv4 套接字：

cacaoadm stop
oldvalue=`cacaoadm get-param java-flags --value`
cacaoadm set-param java-flags="${oldvalue} -Djava.net.preferIPv4Stack=true"

然后按照《Sun Java Enterprise System 5 Update 1 Monitoring Guide》中的“To Restart a Node Agent” 过程，重新启动节点代理、主代理和 Monitoring Console。

如果时钟未同步，会阻止在 Monitoring Console 中添加主机 (6487357)

如果节点代理和主代理主机上的时间相差甚远，则无法将该节点添加到 Monitoring Console。主代理的 Monitoring Framework 的错误日志将在“建立 JRMP 连接期间”报告一个严重错误。

解决方案：设置任一主机上的时间以使两者同步。

HP_UX：同时存在过多的监视规则会导致异常 (6481758)

当在 HP-UX 操作系统上的某个节点代理中并行创建大量监视规则时，Java 虚拟机 (Java Virtual Machine, JVM) 中的线程数可能会超出内核参数限制，进而导致 OutOfMemory 异常。

解决方案：如《Sun Java Enterprise System 5 Update 1 Monitoring Guide》中的“To Optimize Kernel Parameters for Monitoring Framework on HP-UX” 过程所述，下载并运行 HPjconfig 工具。

在 Windows 上，mfwkadm 会产生错误 ( 6535233)

在 Windows 上运行 mfwkadm 命令时会产生以下错误：

'C:\Program' is not recognized as an internal or external command,
operable program or batch file.

解决方案：注释掉 C:\Program Files\Sun\JavaES5\share\mfwk\bin\masetup.bat 文件的第四行，方法是在该行开头添加 REM。

if defined MFWK_PATH goto perl_cmd

REM if defined MFWK_PATH goto perl_cmd

严重程度较低的 Monitoring Framework 问题

以下列表跟踪 Monitoring Framework 中存在的其他已知问题。

6356355

在 Linux 上，启用 IPv6 后无法进行搜索

卸载问题

一般卸载问题

在 Windows 上，“卸载完成”面板上的“查看日志”按钮不显示日志文件 (6505473)

在远程会话中完成安装时，安装程序日志存储在 temp 目录中。

如果在安装或卸载期间重新引导系统，则会删除 temp。因此，单击“查看日志”按钮时，就没有可用的日志文件。

解决方案：无。

在 Windows 上，卸载某些 Java ES 修补程序需要 Sun Java(TM) Enterprise System 5.msi (6594140)

在尝试卸载某些 Java ES 5 Update 1 修补程序时，会出现一条错误消息，指出 Sun Java(TM) Enterprise System 5.msi 不在其原始安装位置 C:\t\Windows。

解决方案：下载 Java ES 5 并将其解压缩到错误消息中提到的安装位置。然后，在卸载 Java ES 修补程序之后，可以将下载和解压缩的文件删除。

Access Manager 卸载问题

卸载过程中，Access Manager 监视模块未注销 (6360971, 6369681)

卸载 Access Manager 时，未注销其监视模块描述符。仅在已升级了 Access Manager 之后，才会发生此问题。

解决方案：使用 cacaoadm 注销 com.sun.cmm.am 描述符。

1. 确认存在 com.sun.cmm.am 描述符：

   # cacaoadm list-modules List of modules registered: com.sun.cacao.agent_logging 1.0 ... com.sun.cmm.am 1.0 ...

2. 注销描述符：

   # cacaoadm unregister-module com.sun.cmm.am.xml

3. 重新启动 cacao：

   cacaoadm restart

4. 确认已注销 com.sun.cmm.am：

   # cacaoadm list-modules List of modules registered: com.sun.cacao.agent_logging 1.0 ...

   （com.sun.cmm.am 1.0 不应再出现在已注册模块列表中。）

修补程序信息

从 Java ES 5 发行版本开始，Sun 采用了一种新的维持模式，以简化搜索、下载修补程序并将其应用于 Java ES 组件的任务。这种模式有两个主要特征：

• 包含适用于所有 Java ES 组件的最新适当修补程序的修补程序簇

• 各组件修补程序的关键字标记

修补程序簇。对于 Java ES 所支持的多个平台，都可以下载修补程序簇，其中包含 Java ES 5 中所交付组件版本的最新修补程序，包括用于将组件提升到 Java ES 5 Update 1 级别的修补程序。这些修补程序簇随着组件提供新修补程序而不断更新。

要获取其中的一个修补程序簇：

1. 请转至 http://sunsolve.sun.com。

2. 单击 "Patches and Updates"。

3. 单击 "Recommended Patch Clusters"。

4. 找到以 "Java ES Accumulated" 开头并适用于您的操作系统版本和处理器体系结构的修补程序簇，并进行下载。

关键字标记。从 Java ES 5 发行版本开始，Java ES 发行版本中所包括的任何组件版本的任何修补程序都会在其自述文件中用一个关键字进行标记，以此指明该修补程序适用于该 Java ES 发行版本。对于 Java ES 5 及更新发行版，关键字标记为 java_es-5。由于采用了此关键字标记，您可以使用 SunSolve 的 "PatchFinder" 功能，通过输入关键字 java_es-5 快速找到适用于 Java ES 5 及更新发行版的各个组件修补程序。

也可以在 Solaris 10 上使用 Sun Connection 获得适用于 Java ES 的修补程序。有关更多信息，参见 http://www.sun.com/service/sunconnection。

可再分发的文件

Sun Java Enterprise System 5 Update 1 的一些组件包含可再分发的文件。有关这些文件的信息，参见您正在使用的组件的发行说明。

Berkeley Database 使用权限通告

本产品包含 Oracle Corporation 的产品 Berkeley Database 的对象和/或源代码。如果脱离 Java Enterprise System 而单独使用 Berkeley Database 软件，或使用其授权派生产品，均会受到其他许可条件的限制。

为残疾人士提供的辅助功能

欲获得自本介质发行以来所发布的辅助功能，请联系 Sun 索取有关 "Section 508" 法规符合性的产品评估文档，以便确定哪些版本最适合部署辅助功能解决方案。可通过以下网址获取应用程序的更新版本： http://sun.com/software/javaenterprisesystem/get.html。

有关 Sun 在辅助功能方面所做出的努力，请访问 http://sun.com/access。

Java ES 5 Update 1 的文档

在 docs.sun.com 上提供了 Java ES 5 Update 1 的产品文档：

• 发行说明：http://docs.sun.com/coll/1315.3 及 http://docs.sun.com/coll/1396.3

• 系统级安装、升级和规划手册：http://docs.sun.com/coll/1286.3 及 http://docs.sun.com/coll/1382.3

• 每个组件的手册集：http://docs.sun.com/prod/entsys.5 及 http://docs.sun.com/prod/entsys.5?l=zh

此外，您还可以在 BigAdmin 上 Java ES 的信息中心找到其他各种文档： http://www.sun.com/bigadmin/hubs/javaes.

文档、支持和培训

Sun Web 站点提供了有关以下附加资源的信息：

• 文档

• 支持

• 培训

搜索 Sun 产品文档

除了从 docs.sun.com^SM Web 站点搜索 Sun 产品文档外，还可以使用搜索引擎进行搜索，方法是在搜索字段中键入以下语法：

search-term site:docs.sun.com

例如，要搜索 "broker"，请键入以下内容：

broker site:docs.sun.com

要将其他 Sun Web 站点包括到搜索范围内（例如，java.sun.com、www.sun.com 和 developers.sun.com），请在搜索字段中将 docs.sun.com 替换为 sun.com。

第三方 Web 站点引用

本文档所引用的第三方 URL 提供了其他相关信息。

Sun 对本文档中提到的第三方 Web 站点的可用性不承担任何责任。对于此类站点或资源中的（或通过它们获得的）任何内容、广告、产品或其他资料，Sun 并不表示认可，也不承担任何责任。对于因使用或依靠此类站点或资源中的（或通过它们获得的）任何内容、产品或服务而造成的或连带产生的实际或名义损坏或损失，Sun 概不负责，也不承担任何责任。

Sun 欢迎您提出意见

Sun 致力于提高其文档的质量，并十分乐意收到您的意见和建议。要共享您的意见，请访问 http://docs.sun.com，然后单击 "Send Comments"（发送意见）。请在联机表单中提供完整的文档标题和文件号码。文件号码包含 7 位或 9 位数字，可在书的标题页或文档的 URL 中找到该号码。例如，本书的文件号码是 820-2942。提出意见时您还需要在表格中输入文件的英文文件号码和标题。本文件的英文文件号码是 820-2829，文件标题为《Sun Java Enterprise System 5 Update 1 Release Notes》。