发行说明修订历史记录 发行说明修订历史记录 本节列出了初次发行 Sun ONE Application Server 7 产品后对这些发行说明所作的更改 表 1 修订历史记录 日期 更改说明 2004 年 5 月 初次发行 Sun ONE Application Server 7 Update 4

Transcription

1 Sun Java System Application Server 7 发行说明 ( 以前的 Sun ONE Application Server) 版本 7 Update 4 文件号码 : 年 5 月 本发行说明包含发行 Sun Java System Application Server 版本 7 产品 ( 以前称为 Sun Open Net Environment [ONE] Application Server) 的 Update 4 时提供的重要信息 注意在本文档和文档集的其他文档中, 仍将该产品称为 Sun ONE Application Server 还介绍了增强功能 安装说明 已知问题以及其他最新问题 开始使用 Sun ONE Application Server 7 Update 4 产品之前, 请先阅读本文档和相关文档 本文档包括以下内容 : 发行说明修订历史记录 关于 Sun ONE Application Server 版本 7 Update 4 本版本修复的错误 重要信息 已知问题和限制 可重新分发的文件 如何报告问题和提供反馈 其他 Sun 资源 文件号码 第 1 页, 共 66 页

2 发行说明修订历史记录 发行说明修订历史记录 本节列出了初次发行 Sun ONE Application Server 7 产品后对这些发行说明所作的更改 表 1 修订历史记录 日期 更改说明 2004 年 5 月 初次发行 Sun ONE Application Server 7 Update 4 关于 Sun ONE Application Server 版本 7 Update 4 Sun ONE Application Server 7 提供了高性能的 J2EE 平台, 广泛适用于各种应用程序服务和 Web 服务的部署 本节包括 : Sun ONE Application Server 7 产品的新增功能 要求和限制 Sun ONE Application Server 7 产品的新增功能 有关 Sun ONE Application Server 7 产品新增功能的信息, 可以在 Sun ONE Application Server What's New 文档中找到, 其所在位置如下 : 要求和限制 有关 Sun ONE Application Server 7 Update 4 产品的平台要求的信息, 可以在 Sun ONE Application Server 平台 文档中找到, 其所在位置如下 : 第 2 页, 共 66 页 Sun Java System Application Server 7 发行说明 2004 年 5 月

3 关于 Sun ONE Application Server 版本 7 Update 4 本节包括以下主题 : 平台要求 Solaris 修补程序 Solaris x86 限制 平台要求 下表总结了 Sun ONE Application Server 7 Update 4 的要求 有关完整的平台信息, 请参见 Sun ONE Application Server 平台 文档, 其所在位置如下 : 表 2 Sun ONE Application Server 的平台要求 操作系统 体系结构 最小内存 建议的内存 最小磁盘空 间 UNIX 建议的磁盘空间 适用于 SPARC 的 Sun Solaris 8 或 Sun Solaris 9 32 位和 64 位 256 MB ( 不安装 Sun Java Studio) 512 MB 250 MB 可用空间 500 MB 可用空间 Solaris x86, Version 9 Red Hat Linux 位 512 MB ( 安装 Sun Java Studio) Red Hat Enterprise Linux Microsoft Windows Windows 2000 Advanced Server SP2 Intel 32 位 256 MB ( 不安装 Sun Java Studio) 256 MB( 不安装 Sun Java Studio) 250 MB 可用空间 500 MB 可用空间 Windows 2000 Server SP2 256 MB ( 安装 Sun Java Studio) 512 MB ( 安装 Sun Java Studio) Windows 2000 Professional SP2 Windows XP Professional Solaris 修补程序 Solaris 8 用户必须安装 Sun 建议的修补程序集, 可以在 建议的安全修补程序 下找到此修补程序集, 其所在位置如下 : 文件号码 第 3 页, 共 66 页

4 本版本修复的错误 Solaris 8 必需的修补程序包括 以及 ( 可以是任何版本, 仅用于基于软件包的安装 ) 如果没有这些修补程序 ( 安装程序将检查这些修补程序是否存在 ), 将无法安装或运行 Sun ONE Application Server 软件 这些修补程序已包含在最新的推荐修补程序集中 Solaris x86 限制 Sun ONE Studio 插件 由于在 Solaris x86 平台上无法使用 Sun Java Studio, 所以 Sun Java Studio 插件不是此版本的一部分 Solaris 支持 仅在 Solaris 9 Update 2 及更高版本 ( 不包括任何早期 Solaris 版本 ) 上支持 Solaris x86 版本 在 Solaris x86 平台上无法使用 Java Smart Ticket 应用程序样例 该样例需要 Java 2 Platform, Micro Edition Wireless Toolkit (v1.0.4), 而在 Solaris 9, x86 平台上无法使用该软件 本版本修复的错误 本节列出了由客户提出并已在 Sun ONE Application Server 7 Update 4 产品中得到解决的问题 表 3 Application Server 7 Update 4 中修复的错误 错误编号 说明 EJB 编译器无法生成适用于内部类的有效 java 代码 jar 清单中的循环路径导致 从 mbean 接收到的错误为空 错误 当您在非 J2EE URL 和真实存在的 URL 之间建立映射时, errorhandlerrequest.getattribute("javax.servlet.error.request_uri") 的返回值为空 在 JSP 代码中使用 jsp:usebean 时, 如果在指定范围内找不到具有指定 的对象, 将使用 Beans.instantiate() 创建对象, 而不考虑所使用的属性 部署 WAR 文件过程中, Application Server 有时会崩溃 appclient 不受 -mainclass 选项控制 验证工具与 EJB 2.0 和 EJB 2.1 规范中用于 ejb-name 命名惯例的规则不兼容 停止并启动 ( 重新启动 ) 实例时, SNMP 不工作 无法使用 asant 创建新的域 即使重新启动服务器后, SNMP MIB 变量的值也始终为零 例如, SNMP MIB 变量 iwsinstancedeathcount 第 4 页, 共 66 页 Sun Java System Application Server 7 发行说明 2004 年 5 月

5 重要信息 表 3 Application Server 7 Update 4 中修复的错误 ( 续 ) 错误编号 说明 Performance Tuning Guide 关于启用 stats-xml 的说明中存在文档错误 在日文版中, 管理界面不能正常工作 如果将 Bean 的远程接口命名为 Util, 则部署会失败 Application Server 日志加密问题 在启用 SSL 的情况下, 使用 passthrough 插件访问应用程序时, Application Server 不稳定 asadmin --passwordfile 选项不能使用大小写混用的字符组合 部署 jdbc/simple 样例时, 出现警告消息 代理插件截断 XML 返回数据 使用 DB2 类型 2 驱动程序时, 空闲超时后 DB2 服务器连接数不断增加 请参见第 24 页的 数据 库驱动程序 重要信息 本节包括以下主题 : 文档 易用性 升级说明 文档 所有 Sun Microsystems 产品文档都可以在以下网址找到 : 本节介绍以下主题 : Sun ONE Application Server 7 文档 参考文档 文件号码 第 5 页, 共 66 页

6 重要信息 Sun ONE Application Server 7 文档 除这些发行说明以外, Sun ONE Application Server 7 Update 4 产品还包含一套完整的文档 在 Update 4 中更新的 Sun ONE Application Server 7 文档拥有新的文件号码, 并且在以下列表中以修订版表示 相对于以前更新版没有发生变化的文档, 其文件号码不变 注意 如果发现重大问题, 可能会对文档进行修订 在此情况下, 修订后的版本将在此站点上发布 最近的更新日期将与版权信息一起显示在此文档的 HTML 版本中 Sun ONE Application Server 7 Update 4 文档可以在以下网址中找到 : 下表列出了 Sun ONE Application Server 文档集中每个文档的文件号码和简短说明 : Product Overview ( 文件号码 : ) 介绍了 Sun ONE Application Server 7, 包括该产品每个版本的功能 Server Architecture ( 文件号码 : ) 提供了服务器体系结构的示意图和说明, 讨论了 Sun ONE Application Server 体系结构方法的优点 What s New ( 文件号码 : ) 列出了 Sun ONE Application Server 7 中新增的企业功能 开发者功能和操作功能 平台修订版 ( 文件号码 : ) 以表格形式全面而概括地介绍了所支持的操作系统 JDBC 驱动程序和数据库 Web 服务器 目录服务器 浏览器以及相关联的软件包 Getting Started Guide ( 文件号码 : ) 介绍了如何开始使用 Sun ONE Application Server 7 产品 本文档的适用对象是初次使用本产品的开发者, 以及试用本产品的用户 安装指南 ( 文件号码 : ) 提供了安装或升级 Sun ONE Application Server 软件及其组件 ( 如应用程序样例 管理界面和 Sun Open Net Environment [ONE] Message Queue) 的说明 Migrating and Redeploying Server Applications ( 文件号码 : ) 提供了将应用程序迁移到新的 Sun ONE Application Server 7 编程模型 ( 特别是从 iplanet Application Server 6.x 和 Netscape Application Server 4.0 迁移 ) 的说明 其中包含一个迁移样例 Developer s Guide ( 文件号码 : ) 开发者文档集的核心部分, 本文档一般性地介绍如何创建意在 Sun ONE Application Server 上运行的 J2EE 应用程序, 这些应用程序遵循针对 Servlet Enterprise JavaBean (EJB ) JavaServer Page (JSP) 和其他 J2EE 组件的开放式 Java 标准模型 其中包括以下主题 :J2EE 应用程序设计 安全性 部署 调试和创建生命周期模块 还包含一个详尽的 Sun ONE Application Server 词汇表 第 6 页, 共 66 页 Sun Java System Application Server 7 发行说明 2004 年 5 月

7 重要信息 Developer s Guide to Web Applications ( 文件号码 : ) 介绍了如何在 J2EE 应用程序中使用 Servlet 和 JavaServer Page (JSP), 以及如何使用 SHTML 和 CGI 其中包含以下主题 : 结果缓存 JSP 预编译 会话管理 安全性和部署 Developer s Guide to Enterprise Java Beans Technology ( 文件号码 : ) 介绍了如何在 Sun ONE Application Server 环境下开发和部署不同类型的企业 Bean 其中包括以下主题 : 容器管理的持久性 只读 Bean 以及与企业 Bean 关联的 XML 和 DTD 文件 Developer s Guide to J2EE Features and Services ( 文件号码 : ) 介绍了 J2EE 功能, 例如 Java 数据库连接 (JDBC) Java 命名和目录接口 (JNDI) Java 事务服务 (JTS) Java 消息服务 (JMS) 和 JavaMai Developer s Guide to NSAPI ( 文件号码 : ) 介绍了如何创建 NSAPI 插件 Developer s Guide to Web Services ( 文件号码 : ) 介绍了如何在 Sun ONE Application Server 环境中开发和部署 Web 服务 Developer s Guide to Clients ( 文件号码 : ) 介绍了如何开发和部署访问 Sun ONE Application Server 7 上的 J2EE 应用程序的应用程序客户机容器 (ACC) 管理员指南 ( 文件号码 : ) 管理员文档集的核心部分, 本文档提供了有关如何从管理界面和命令行界面配置 管理和部署 Sun ONE Application Server 子系统和组件的信息和说明 还包含一个详尽的 Sun ONE Application Server 词汇表 Administrator s Configuration File Reference ( 文件号码 : ) 介绍了 Sun ONE Application Server 配置文件 ( 例如 server.xml 文件 ) 的内容 Administrator s Guide to Security ( 文件号码 : ) 介绍了如何配置和管理 Sun ONE Application Server 操作环境的安全性 其中包括有关一般安全性 证书和 SSL/TLS 加密的信息 同时还介绍了基于 HTTP 服务器的安全性 J2EE CA SPI Administrator s Guide ( 文件号码 : ) 介绍了如何配置和管理 Sun ONE Application Server 环境的 JCA SPI Implementation 功能 其中包括以下主题 : 管理工具 池监视器 部署 JCA 连接器, 以及连接器样例和应用程序样例 Performance Tuning Guide ( 文件号码 : ) 介绍了优化 Sun ONE Application Server 以提高性能的方法和原因 Error Messages Reference ( 文件号码 : ) 介绍了 Sun ONE Application Server 中的所有错误消息 Manpages for Command-line Interface 为所有命令行界面命令提供了以手册页样式编写的 XML 页 Manpages for Utilities 为所有 Sun ONE Application Server 实用程序命令提供了以手册页样式编写的 XML 页 管理界面联机帮助 为 Sun ONE Application Server 图形管理界面提供特定于内容的联机帮助 文件号码 第 7 页, 共 66 页

8 重要信息 参考文档 Sun ONE Application Server 文档中常常引用的其他 Sun ONE 产品的文档 Sun ONE Message Queue 文档与 Sun ONE Application Server 集成的 Sun ONE Message Queue ( 也称作 iplanet Message Queue) 子系统具有自己的文档, 可以在以下网址中找到 : Sun Java Studio 5, Standard Edition 文档可与 Sun ONE Application Server 一起使用的 Sun Java Studio 5, Standard Edition 产品有自己的文档, 可以在以下网址中找到 : Sun Java Studio 5, Standard Edition Update 1 文档的所在位置如下 : 易用性 Sun ONE Application Server 产品文档以易用格式提供, 可通过辅助技术阅读 本产品提供了很多易用性功能, 使用户能够以最舒适和最方便的方式阅读和使用产品 这些功能包括 : 助记键和键盘快捷键 可自定义的字体 可自定义的颜色 可自定义的工具栏 可自定义的样式表 注意 Solaris 操作系统使您可以使用窗口样式管理器设置窗口行为 使用助记键时, 应将窗口行为设置为 单击 ( 鼠标 ) 激活窗口 如果未设置此选项, 则在某些情况下, 助记键可能无法使用 如果要修改 Sun ONE Application Server HTML 联机帮助, 可以转到帮助目录并编辑样式表, 其所在位置如下 : server_root/lib/install/applications/admingui/admingui_war/help 重新启动管理服务器, 即可使更改生效 第 8 页, 共 66 页 Sun Java System Application Server 7 发行说明 2004 年 5 月

9 升级说明 有关升级到 Sun ONE Application Server Update 4 的完整说明, 请参见 Sun ONE Application Server 安装指南, 其所在位置如下 : 已知问题和限制 本节介绍 Sun ONE Application Server 7 Update 4 产品的已知问题和相应的解决方法 注意 如果问题说明未指明特定平台, 则所有平台都可能出现此问题 本部分信息按以下内容进行组织 : 安装与卸载 启动与关闭服务器 数据库驱动程序 Web 容器 EJB 容器 容器管理的持久性 消息服务和消息驱动 Bean Java 事务服务 (JTS) 应用程序部署 验证器 配置 部署描述符 监视 服务器管理 Sun ONE Studio 4 插件 文件号码 第 9 页, 共 66 页

10 样例应用程序 ORB/IIOP 侦听器 国际化 文档 安装与卸载 本节介绍已知的安装和卸载问题以及相应的解决方法 在 Microsoft Windows 中, 若软件包 / 路径 / 应用程序名称的长度超过 255 个字符, 将无法部署应用程序 仅在 Microsoft Windows 中, 由于受 JDK 限制, 系统不支持长软件包 / 路径名称 部署期间, 部署工具将尝试从归档文件中提取类文件 如果展开后的名称超过 255 个字符, 则提取将失败 长应用程序名称示例 : J2EE 应用程序名称为 servlet_jsh_httpservletrequestwrapper.ear 长软件包名称示例 : Servlet 位于以下软件包中 : servlet_jsh_httpservletrequestwrapper_1\ servlet_jsh_httpservletrequestwrapper_servlet_war\web-inf\classes\tests\ javax_servlet_http\httpservletrequestwrapperhttpservletrequestwrappercon structortestservlet.class 长路径名示例 : Sun ONE Application Server 安装于 drive \:>Sun \ApplicationServer 解决方法考虑以下解决方法 : 1. 安装过程中设定较短的目录结构 例如, 用 drive:>app\ 代替缺省的 drive:\>sun\apsserver7 2. 使用 create_instance 命令重命名实例使其变短 例如, 可以将 /instance1/domain1/ 更改为 /i/d 3. 使用较短的软件包名称 路径名和应用程序名称 第 10 页, 共 66 页 Sun Java System Application Server 7 发行说明 2004 年 5 月

11 在 Solaris setup-sdk/jdk 中, 在不包含 XWindows 的计算机的命令行模式下安装时出现错误 在不含 XWindows 库的僵化的 Solaris 系统中, 即使在命令行模式下, 也无法在其上运行 Sun ONE Application Server 安装程序 安装程序在实例化 SetupSDK/Webstart 向导的安装程序框架使用的 AWT 对象时, 将抛出 java.lang.unsatisfiedlinkerror 解决方法 1. 临时安装 XWindows 支持软件包, 并在安装 Sun ONE Application Server 产品后将其删除 2. 使用 pkgadd 命令安装 Sun ONE Application Server 软件包, 并使用 asadmin 命令创建初始域 安装期间出现警告消息 安装期间, 可能会出现一些无效的错误消息 例如 : 警告 : 无法刷新系统首选项 :java.util.prefs.backingstoreexception: 无法获取文件锁定 警告 : 无法锁定系统首选项 Unix 错误代码 解决方法忽略这些警告消息, 或者创建系统首选项目录 ( 通常为 /etc/.java/.systemprefs) 这通常由 JDK 安装脚本完成 在 Solaris 中, 如果同时安装基于软件包的安装和常规安装, 将出现冲突 如果同时安装产品的基于软件包的安装 (Solaris 9 附带的 ) 和产品的主流安装程序版本, 则存在潜在的冲突 这两个安装的 Sun ONE Message Queue 代理程序均被共享, 因此如果域和实例的名称不唯一, 则在启动第二个具有相同域 / 实例名的实例时, 可能会显示以下消息 : 严重错误 : JMS5024: JMS 服务启动失败 严重错误 : CORE5071: 在初始化过程中出现错误 尤其要注意的是, 这两种安装的缺省域和实例名称都是相同的 解决方法请按照 Sun ONE Application Server 管理员指南 的 JMS 管理 一章中的说明进行操作 如果安装目录中包含非字母数字字符, 则 Sun ONE Application Server 将不启动 如果安装目录包含 # 空格或其他任何非字母数字字符, 则 Sun ONE Application Server 将无法启动 在此情况下, 将不创建服务器日志文件 Sun ONE Application Server 安装目录只能包含下列字符 : 字母数字 ( 破折号 ) 或 _ ( 下划线 ) 安装过程中输入现有 Java 2 SDK 目录时也应遵循此规则 解决方法安装过程中, 请指定一个名称中只包含字母数字 破折号或下划线字符的目录 文件号码 第 11 页, 共 66 页

12 无提示安装程序不检查用户权限 尽管交互式安装程序 (GUI 或命令行 ) 会检查适当的用户权限 ( 对于 Microsoft Windows 平台为 Admin 用户, 对于 Solaris 基于软件包的安装为 root 用户 ), 但在无提示安装过程中不进行此检查 这样, 后续安装会因为用户没有足够的软件包安装权限 ( 对于 Solaris) 或服务创建权限 ( 对于 Microsoft Windows) 而失败 解决方法确保以适当的用户身份运行无提示安装 对于 Solaris, 安装程序会接受 JDK_LOCATION 值, 即使安装位置包含早期版本 (Solaris 1.2 以前的版本 ) Sun ONE Application Server 7 要求 Java 2 SDK 的版本为 1.4.0_02 或更高 但在 Solaris 中, 如果用户选择重复使用现有 Java 2 SDK (Solaris 1.2 以前的版本 ), 安装程序可能不会显示警告消息 安装可能会成功完成, 但 Sun ONE Application Server 可能无法正常工作 这是因为环境中包含现有 JAVA_HOME 解决方法在启动安装程序前取消设置 JAVA_HOME, 如下所示 : ( 在 ksh 中 ):unset JAVA_HOME ( 在 csh 中 ):unsetenv JAVA_HOME 在无提示模式下, 在现有的试用安装中安装开发安装时未报告错误 影响在无提示模式下运行的安装程序 如果用户尝试在 Sun ONE Application Server 7 的现有试用安装中进行安装 ( 在同一目录中进行 ), 无提示安装将不会报告任何错误并正常进行 系统将保留现有的试用安装文件 解决方法在同一位置安装新的开发安装之前, 先卸载现有的试用安装 在命令行和无提示模式下, 在同一安装会话中选择 Application Server 和 Sun ONE Studio 4 Enterprise Edition for Java 组件时导致安装程序无法正常运行 影响开发和操作安装 在命令行或无提示模式下运行安装时, 可以选择在同一个安装会话中, 同时安装 Application Server 和 Sun ONE Studio 4 Enterprise Edition for Java 支持组件 ( 在 GUI 模式下, 这两个组件是互斥的 ) 安装程序无法正确处理组件相关性, 并尝试安装管理客户机组件, 而不是选定的 Sun ONE Application Server 组件 解决方法模拟 GUI 模式, 首先在命令行或无提示模式下安装 Sun ONE Application Server 组件, 然后运行另一个安装程序并安装 Sun ONE Studio 支持 第 12 页, 共 66 页 Sun Java System Application Server 7 发行说明 2004 年 5 月

13 N/A 在 Solaris 中, 如果 Sun ONE Application Server 安装程序将现有的 Sun ONE Message Queue 3.0 升级到 3.0.1, 则最终的安装将在 Sun ONE Application Server 卸载期间被删除 影响 Solaris 开发和操作安装程序 如果检测到系统中已安装了 Sun ONE Message Queue 3.0, 则将提供将此软件自动升级到 版的选项 如果选择此选项, 则安装的 Sun ONE Message Queue 软件将在 Sun ONE Application Server 卸载期间被卸载 解决方法卸载 Sun ONE Application Server 并保留 Sun ONE Message Queue 安装的步骤 : 1. 屏幕显示自动升级选项时退出安装程序 2. 根据 Sun ONE Message Queue 文档将 Sun ONE Message Queue 升级为 版本 3. 再次运行 Sun ONE Application Server 安装 在 Solaris 中, 在非缺省位置安装 Sun ONE Application Server 时, Solaris 中基于软件包的安装程序不在正确的位置检查磁盘空间 尝试在 Solaris 的非缺省位置安装 Sun ONE Application Server ( 使用基于软件包的安装程序 ) 时, 安装程序不检查指定的目标目录中的磁盘空间 而是仅检查缺省位置 (/opt) 中的磁盘空间 解决方法开始安装前, 请确保 /opt 中有足够的磁盘空间 (85 MB), 即使您不打算在 /opt 中安装 此外, 请确保目标目录中也有足够的磁盘空间 (85 MB) 在 Microsoft Windows XP 中, 无法增量式安装应用程序样例和 PointBase 4.2 组件 此问题会影响 Windows XP 平台 如果尝试在已安装的 Sun ONE Application Server 组件中增量式安装应用程序样例和 / 或 PointBase 4.2 组件, 则安装程序将不会正确检测现有的 Sun ONE Application Server 安装, 并会报告 未找到 Application Server 安装无法继续 解决方法在安装 Sun ONE Application Server 组件的同时安装应用程序样例和 PointBase 4.2 组件 如果系统上已安装了 Sun ONE Application Server, 请卸载它, 然后重新运行安装, 同时选择所有必需的组件 在一般的无提示安装期间发生目录错误 此问题影响所有平台上的无提示安装 如果安装程序发现给定的安装目录有问题, 会报告一般性错误消息 安装目录无效 此错误消息会在以下情况下出现: 选定的目录不可写 选定的目录字符串为空或包含空格字符 解决方法针对这两个问题检查所提供的安装目录值, 确定错误原因 文件号码 第 13 页, 共 66 页

14 在 Microsoft Windows XP 上, 无法使用卸载程序卸载独立的管理客户机安装 此问题影响 Windows XP 平台上的独立管理客户机安装 如果用户尝试通过提供的卸载程序卸载独立的管理客户机, 卸载会尝试卸载一组不正确的组件, 然后挂起 解决方法手动卸载独立的管理客户机 应删除 install_dir 目录中的文件 还应删除相关的程序组文件夹 ( 开始 -> 程序 -> Sun Microsystems -> Sun ONE Application Server ) 独立的管理客户机组件没有相关的 Microsoft Windows 注册表条目 ; 这些步骤将完全将系统恢复到安装管理客户机前的状态 如果增量式安装了应用程序样例组件, 则样例文档不会被发布到初始服务器实例 此问题会影响所有平台上的开发和操作安装程序 如果在独立的安装会话中在已安装的 Sun ONE Application Server 上安装应用程序样例, 则样例文档将不会被发布到初始服务器实例, 也无法通过 URL 进行访问 但文档将安装到文件系统中, 并可以在以下位置以本地方式进行访问 :file:///install_root/samples/index.html 解决方法在本地访问样例文档 在 Solaris 中, 安装程序在执行 Sun ONE Message Queue 升级期间将不保留 Sun ONE Message Queue 配置文件 如果检测到系统上现有的 Sun ONE Message Queue 3.0 软件包, 安装程序会将此安装升级到 Sun ONE Application Server 可以使用的 版本 在此升级操作期间, 将删除现有的 3.0 Solaris 软件包, 从而导致删除以下配置文件 : /etc/imq/passwd /etc/imq/accesscontrol.properties 如果已对这些文件进行了修改, 则所作的修改将丢失, 且最终的 Sun ONE Message Queue 安装将包含缺省的配置值 解决方法为所有用户修改的文件创建备份副本, 并在升级完成后将恢复这些文件的备份副本 有关详情, 请参见 Sun ONE Message Queue 3.0 安装指南 第 14 页, 共 66 页 Sun Java System Application Server 7 发行说明 2004 年 5 月

15 在 Solaris 中, 从 CD 上运行安装时出现安装程序错误消息 将卷插入 CD-ROM 驱动器时, Solaris 卷管理会将下一个符号名分配给此卷 例如, 如果两个 CD-ROM 都与缺省的正规表达式匹配, 则它们将被命名为 cdrom0 和 cdrom 任何与添加的正规表达式相匹配的 CD-ROM 都会从 cdrom2 开始进行命名 这将记录在 vold.conf 手册页上 每次从 CD 安装 Sun ONE Application Server 时,CD-ROM 安装点都会在标签名后附加一个数字 第一次安装 CD 时, 一切都顺利进行 在后续安装中, 安装程序启动时会显示以下错误消息 : IOException:java.io.FileNotFoundException:/cdrom/appserver7 ( 装入缺省的 flavormap.properties 文件 URL:file:/cdrom/appserver7#4/AppServer7/pkg/jre/lib/flavormap.properties 时, 无此文件或目录 ) 解决方法安装程序的功能不会受任何影响 但仍可以使用以下方法解决 : 1. 在命令提示符下输入 su 命令以及 root 用户口令, 或者以 root 用户的身份登录, 成为超级用户 命令提示符将更改为磅符号 (#) 2. 如果 /cdrom 目录不存在, 请输入以下命令创建该目录 : # mkdir /cdrom 3. 安装 CD-ROM 驱动器 注释 :vold 进程管理 CD-ROM 设备并执行安装 CD-ROM 可能会自动安装到 /cdrom/cdrom0 目录中 如果正在运行文件管理器, 会出现一个单独的文件管理器窗口, 显示 CD-ROM 的内容 4. 如果 /cdrom/cdrom0 目录因未安装 CD-ROM 而为空, 或者如果文件管理器未打开一个显示 CD-ROM 内容的窗口, 请输入下列命令, 以验证 vold 守护程序是否正在运行 : # ps -e grep vold grep -v grep 5. 如果 vold 正在运行, 则系统将显示 vold 的进程标识号 如果系统未显示任何内容, 请键入以下命令以终止此守护程序 : # ps -ef grep vold grep -v grep 6. 输入以下命令停止 vold 进程 : # kill -15 process number 7. 手动安装 CD-ROM: # mount -F hsfs -r ro /dev/dsk/cxtyd0sz /cdrom/cdrom0 其中 x 是 CD-ROM 驱动器控制器编号, y 是 CD-ROM 驱动器 SCSI 编号, z 是 CD-ROM 所在分区的分片 现在已经安装了 CD-ROM 驱动器 请参见 在 Solaris 上安装和设置 CD 1, 获取安装步骤 文件号码 第 15 页, 共 66 页

16 在 Microsoft Windows 中, 如果只在运行 setup.exe 时提供管理员用户凭证, 安装程序的功能将受到影响 此问题会影响 Microsoft Windows 平台上的所有安装 如果用户登录时不具备管理员权限, 系统会在他 / 她尝试运行 setup.exe 时提示输入管理员用户凭证 如果输入的凭证正确, 安装程序对用户权限的检查便会通过, 安装将继续进行 但是, 某些安装程序的功能将会受到影响 : 如果在安装目录选择屏幕上选择了 浏览 按钮, 安装程序将挂起 可能不会创建 Sun ONE Application Server 项目的程序组条目 解决方法执行安装时, 以具有管理员权限的用户身份登录 在 Solaris 中, 在先前安装了管理客户机组件的系统上增量式安装 Sun ONE Application Server 组件可能会使安装不可用 此问题会影响 Solaris 平台上基于软件包的 Solaris 安装 如果用户尝试在已经安装了独立管理客户机组件的系统上安装 Sun ONE Application Server 组件, 并选择与最初用于管理客户机安装的目录不同的安装目录, 则最终的 Sun ONE Application Server 安装将不可用, 即使报告安装已经成功 这是因为系统将检测到管理客户机 Solaris 软件包已安装在系统上, 因此这些软件包将不会作为 Sun ONE Application Server 安装的一部分进行安装 这样, 将缺少对产品功能至关重要的文件 解决方法尝试在同一 Solaris 系统上安装 Sun ONE Application Server 之前, 先卸载独立的管理客户机 或者, 您也可以尝试进行增量式安装, 但应使用与用于管理客户机安装的目录相同的安装目录进行后续的 Sun ONE Application Server 安装 在 Solaris 中, 如果选定的自定义配置目录是选定的安装目录的子目录, 并称为 etc, 则安装将失败 此问题会影响 Solaris 平台上基于软件包的 Solaris 安装 如果选择了下列自定义目录位置的组合, 安装会因相同目录的组所有者信息不一致而失败 : 安装目录 :install_dir 配置目录 :install_dir/etc /var/sadm/install/logs 目录中的 pkgadd 日志文件将包含以下错误消息 : pkgadd: 错误 : 重复的路径名 /install_dir/etc pkgadd: 错误 : 无法处理 pkgmap 解决方法选择一个不同于 install_dir/etc 的自定义配置目录 在 Solaris SPARC 和 Linux 中, 由安装用户以外的用户运行的 PointBase Shell 脚本失败 此问题仅影响试用安装 所有 PointBase Shell 脚本仅对安装用户设置为执行权限 解决方法如果安装此产品的用户以外的用户需要执行这些脚本, 请将权限更改为 0755 第 16 页, 共 66 页 Sun Java System Application Server 7 发行说明 2004 年 5 月

17 在 Solaris 中, Sun ONE Message Queue 软件包 SUNWiqsup 不会在 Message Queue 升级过程中被删除 此问题仅存在于 Solaris 中 Sun ONE Application Server 7 安装过程涉及安装 Sun ONE Message Queue 版本 在 Solaris 上, 如果检测到 Sun ONE Message Queue 3.0 版本, 则先将其卸载 ( 用户确认后 ), 然后再安装 版本 存在这样一个小小的清除问题 : 升级过程中,Solaris 安装程序不会删除 Sun ONE Message Queue 3.0 的 Solaris 软件包之一 (SUNWiqsup) 但此软件包的存在不会带来任何危害, 它不会影响 Sun ONE Message Queue 或 Sun ONE Application Server 7 解决方法使用以下命令 ( 以 root 用户身份 ) 手动删除 SUNWiqsup 软件包 : # pkgrm SUNWiqsup 在 Window 2000 Pro 中, 卸载程序无法找到 JDK 以运行卸载 在 Windows 2000 Pro 中, 卸载失败并显示以下消息 : 卸载程序无法找到适当的 j2sdk 以运行卸载程序 请再次运行卸载, 同时将 -javahome 选项设置为已安装了 j2sdk 1.4.0_02 或更高版本的目录 按 Enter 键退出 解决方法使用 -javahome JDK 位置 在 Windows 上进行升级时, 如果正在运行 SNMP, 将会显示错误并且升级失败 解决方法升级前停止 SNMP 服务 : 1. 在 控制面板 中选择 管理工具 2. 选择 服务 3. 向下滚动到 SNMP 服务 并将其停止 在 Linux 上, 如果执行的是完全安装, 并且已经安装了可用的 Message Queue, 那么将安装两个 Message Queue 软件包 解决方法由于 xx 中的 Linux rpm 实用程序存在一个错误, 因此无法识别已安装的 Sun ONE Message Queue( 标识为 imq)rpm 由于此原因,Sun ONE Application Server 安装程序将另外安装一个 Sun ONE Message Queue rpm 要解决此问题, 或者在系统上安装 rpm 的 版本, 或者在安装 Application Server 之前卸载 Message Queue 除非在以前的 Linux 系统版本中升级了 rpm 软件包, 否则通常 Red Hat Enterprise Linux Advanced Server 3.0 中存在的是 rpm 的 xx 版本 在 Linux 上, 卸载程序不会删除已升级的软件包 解决方法通过键入以下命令手动删除软件包 : rpm -e --nodeps SUNWas* packages 文件号码 第 17 页, 共 66 页

18 如果将 Sun ONE Application Server 7 Update 3 作为 Sun Java Enterprise 2004Q2 的一部分进行安装, 然后将 Sun ONE Application Server 升级到 Update 4, 则在 Linux 上会出现此问题 以后尝试创建新的服务器实例和通过已启用 SSL 的 Directory Server 安装 Sun Java System Identity Server 2004Q2 将失败, 并且新创建的服务器实例将崩溃 ( 在重新启动时出现 SIGSEGV 错误 ) 解决方法对于在升级到 Sun ONE Application Server Update 4 之后创建的 Application Server 实例, 请编辑服务器实例的 server.xml 文件并在 server-classpath 中输入 jss3.jar 的正确位置, 如下所示 : 将以下行 : <java-config java-home="/usr/jdk/entsys-j2se" 更改为 : server-classpath="/usr/share/lib/mps/secv1/jss3.jar <--- <java-config java-home="/usr/jdk/entsys-j2se" server-classpath="//opt/sun/private/share/lib/jss3.jar <---- 为防止将来发生此问题, 也要修改以下模板文件 : ${APPSERVER_INSTALL_DIR}/lib/install/template/server.xml.template.admin ${APPSERVER_INSTALL_DIR}/lib/install/template/server.xml.template 在这些模板文件中, 将以下行 : <java-config java-home="%%%java_home%%%" 更改为 : server-classpath="/usr/share/lib/mps/secv1/jss3.jar <java-config java-home="%%%java_home%%%" server-classpath="/opt/sun/private/share/lib/jss3.jar N/A 在 Red Hat Enterprise Linux AS 3.0 上安装 Sun ONE Application Server 之前, 必须先安装 compat-libstdc++ ( 向下兼容的标准 C++ 库 ) 解决方法请在安装 Sun ONE Application Server 之前安装 compat-libstdc++ 这些库包含在 Red Hat Enterprise Linux AS 3.0 的 CD 集中 N/A 在 Windows 上安装 Sun ONE Application Server 时, 可能出现以下消息 : 向磁盘写入本机组件时发生错误 向导异常中止 解决方法 1. 如果具有名为 C:\Documents 的文件, 则处理系统属性 user.home ( 通常指向 C:\Documents and Settings\your_name) 时它会产生影响 请删除或重命名 C:\Documents 文件 2. 另外, 必须设置环境变量 TEMP, 并且它必须指向现有可写目录 第 18 页, 共 66 页 Sun Java System Application Server 7 发行说明 2004 年 5 月

19 启动与关闭服务器 本节介绍已知的启动和关闭服务器的问题以及相应的解决方法 日志服务 create-console 属性的行为 在 Microsoft Windows 中, 如果将 server.xml 中 log-service 元素的 create-console 属性设置为 True ( 缺省设置 ), 则桌面上将显示一个窗口, 其中显示服务器事件日志的内容 从设计角度来看, 关闭此窗口不会导致 App Server 实例进程的永久终止 关闭控制台窗口会终止 appservd.exe 进程, 但 watchdog 进程 (appservd-wdog.exe) 会立即重新启动服务器实例进程 对开发者而言, 关闭实例的事件日志窗口可以作为快速重新启动 App Server 实例的一种方法 但是, 要完全停止 App Server 实例 ( 以及伴随的 watchdog 进程 ), 请使用以下方法之一 : 管理界面 开始 -> 程序 -> Sun ONE Application Server 7 -> 停止 Application Server 命令行界面 asadmin stop-instance --local=true instance name 这是 stop-instance 命令的本地形式 还可以使用远程形式 有关详细信息, 请参见 asadmin stop-instance 帮助 管理控制台 选择服务器实例, 然后单击 停止 利用管理控制台, 可以通过修改 App Server 实例 日志 选项卡下的 创建控制台 设置, 来启用 / 禁用控制台事件日志窗口 Solaris 中不显示许可证终止信息 这会影响 Solaris SPARC 试用许可证 许可证将要到期 (14 天后到期 ) 的警告消息将不通过命令行界面和基于浏览器的界面进行报告, 而是显示在服务器日志文件中 解决方法检查服务器日志文件 文件号码 第 19 页, 共 66 页

20 JMS 服务 /Sun ONE Application Server 启动失败 如果 JMS 供应商 (Sun ONE Message Queue 代理程序 ) 有大量未传送的持久性消息, 则可能会因下列问题而发生 Sun ONE Application Server 初始化失败 : 1. 尝试装入所有待定的消息时, MQ 代理程序可能会耗尽内存并异常中止 解决方法将更多的 Java 堆空间用于 MQ 代理程序进程 为此, 请将 JMS 服务的 Start Arguments 属性设置为 -vmargs -Xmx256m Sun ONE Application Server 管理员指南 中的 使用 JMS 服务 一章介绍了设置此属性的步骤 2. 如果 MQ 代理程序在特定的时间段内无法完成其初始化序列, 则 Sun ONE Application Server 将超时并异常中止 解决方法增大 JMS 服务 启动超时 属性的值 Sun ONE Application Server 管理员指南 中的 使用 JMS 服务 一章介绍了设置此属性的步骤 第 20 页, 共 66 页 Sun Java System Application Server 7 发行说明 2004 年 5 月

21 防火墙规则可能会导致 Sun ONE Application Server 启动失败 如果安装了自己的防火墙, 则可能会遇到这个问题 如果在安装 Sun ONE Application Server 的计算机上存在着严格的防火墙规则, 则可能会导致管理服务器和 App Server 实例启动失败 特别要说明的是, 管理服务器和 App Server 实例将尝试在 Sun ONE Application Server 环境中建立本地连接 由于这些连接尝试使用系统主机名而不是本地主机的主机名来访问端口, 因此防火墙规则可能会阻止此类尝试 本地防火墙还可能会无意中生成警告, 通知发生了 Portal of Doom Trojan ( 例如, 在端口 3700 上尝试进行 TCP 连接 ) 或类似的攻击, 而实际上此类访问尝试是由 Sun ONE Application Server 进行的, 它们对计算机不会构成任何安全威胁 在某些情况下, Sun ONE Application Server 用于各种本地通信的端口号可能与已知的常见攻击中使用的端口号重复 发生此问题时将出现以下情况 : 尝试使用 Microsoft Windows 程序组项目 启动 Application Server 启动 Sun ONE Application Server 失败, 显示如下消息 : 无法启动此实例 :domain1:admin-server 服务器启动失败 : 不正常的子进程终止... 管理和服务器实例日志文件包含连接异常, 后跟此消息 :CORE3186: 无法设置配置 解决方法修改防火墙策略, 以允许 Sun ONE Application Server 尝试连接到本地系统中的端口 要避免对可能的攻击发出不准确的警报, 可以修改相关的规则, 或更改 Sun ONE Application Server 使用的冲突的端口号 要确定管理服务器和 App Server 实例使用的端口号, 请参见 server.xml 文件, 它位于 Sun ONE Application Server 安装的以下位置 : domain_config_dir/domain1/admin-server/config/server.xml domain_config_dir/domain1/server1/config/server.xml 其中 domain_config_dir 是初始服务器配置的位置 例如 : Microsoft Windows:install_dir/domains/... Solaris 9 以及更高的集成安装 :/var/appserver/domains/... Solaris 8 Solaris 9 以及更高的未附带安装 :/var/opt/sunwappserver7/domains/... 查找 <iiop-listener> 和 <jms-service> 元素中的端口设置 可以将这些端口号更改为其他未使用的端口号, 也可修改防火墙策略, 以允许本地计算机上的客户机尝试连接到同一台计算机上的这些端口号 文件号码 第 21 页, 共 66 页

22 在 Solaris 中, Sun ONE Application Server 以 root 用户的身份启动所有实例, 从而使非 root 用户具有 root 用户的访问权限 将 Sun ONE Application Server 作为 Solaris 安装 ( 捆绑式安装 ) 的一部分进行安装时, 有若干与 Application Server 启动有关的问题 : 在 Solaris 系统启动期间, 所有应用服务器实例和管理服务器实例将自动启动 在许多环境中, 并不期望所有实例都在 Solaris 系统启动期间自动启动 启动定义的每个实例会对系统的可用内存造成不利的影响 应用服务器实例和管理服务器实例自动启动时, 每个实例的启动脚本都以 root 用户的身份执行 通过修改实例级的启动脚本, 执行非 root 用户拥有的实例启动脚本可以使非 root 用户访问 root 用户 背景在将 Sun ONE Application Server 作为 Solaris 安装的一部分进行安装时, 将安装 /etc/init.d/appserv 脚本和指向 /etc/rc*.d/ 目录中的 S84appserv 和 K05appserv 脚本的符号链接 这些脚本使定义为应用服务器安装一部分的所有应用程序服务器实例和管理服务器实例在 Solaris 系统启动和关闭期间自动启动和停止 /etc/init.d/appserv 脚本包含以下代码段 :... case "$1" in 'start') /usr/sbin/asadmin start-appserv ;; 'stop') /usr/sbin/asadmin stop-appserv ;;... 运行 asadmin start-appserv 命令使得在所有管理域中定义的管理服务器实例和所有应用服务器实例在 Solaris 系统启动时启动 由于系统启动和关闭脚本是以 root 用户的身份执行的, 因此每个应用服务器实例和管理服务器实例也将以 root 用户的身份执行 实例级启动脚本被命名为 startserv, 它位于 instance-dir/bin/startserv 中 由于实例可能由非 root 用户拥有, 因此非 root 用户可以修改 startserv 脚本, 从而以 root 用户的身份执行命令 如果实例使用特权网络端口, 则此实例的 startserv 脚本必须以 root 用户的身份执行 但这种情况下, 通常在实例的配置中设置 作为用户运行, 以强制实例在最初由 root 用户启动后, 作为指定的用户运行 第 22 页, 共 66 页 Sun Java System Application Server 7 发行说明 2004 年 5 月

23 ( 续 ) 解决方法根据所使用的环境使用以下解决方法之一 : 如果环境不要求所有应用服务器实例和管理服务器实例以 root 用户的身份启动, 则应在 etc/init.d/appserv 脚本中注释出 asadmin start-appserv 和 asadmin stop-appserv 命令的执行 如果环境要求启动特定的管理域 ( 包括每个域的管理服务器实例和所有应用服务器实例 ) 或一个或多个管理域中的特定实例, 则应修改 /etc/init.d/appserv 脚本以启动所需的域和 / 或实例, 或者定义满足环境需要的新 /etc/rc*.d/ 脚本 启动特定域 如果需要以非 root 用户的身份启动管理域或特定实例, 则应确保使用带 -c 选项的 su 命令, 以启动所需的域和 / 或实例 示例启动特定的管理域 - 如果您希望作为 root 用户启动特定管理域中的管理服务器实例和所有应用服务器实例, 您可以对 /etc/rc*.d/ 脚本作如下修改 :... case "$1" in 'start') /usr/sbin/asadmin start-domain --domain production-domain ;; 'stop') /usr/sbin/asadmin stop-domain --domain production-domain ;;... 如果希望以非 root 用户的身份启动特定的应用服务器实例, 请修改 /etc/rc*.d/ 脚本, 以使用带 -c 选项的 su 命令 :... case "$1" in 'start') su - usera -c "/usr/sbin/asadmin start-instance --domain test-domain instance-a" su - userb -c "/usr/sbin/asadmin start-instance --domain test-domain instance-b" ;; 'stop') su - usera -c "/usr/sbin/asadmin stop-instance --domain test-domain instance-a" su - userb -c "/usr/sbin/asadmin stop-instance --domain test-domain instance-b" ;;... 请参见 Sun ONE Application Server 管理员指南 以获取有关可以通过 asadmin 命令行界面使用的启动和关闭命令的详细信息 文件号码 第 23 页, 共 66 页

24 数据库驱动程序 本节介绍已知的数据库驱动程序问题和相应的解决方法 在 Solaris 中, 出现 ORACLE JDBC 驱动程序错误 这个新的 Java 数据库连接 (JDBC) 驱动程序用于与 JDK1.4 一起使用的 Oracle(R) 此问题因同时使用 Oracle 9.1 数据库和 ojdbc14.jar 而引起 应用修补程序可修复运行 Oracle 数据库的 Solaris 32 位计算机上的问题 解决方法从 Oracle Web 站点获取针对错误 的修补程序并将其应用于服务器 请执行以下步骤 : 1. 转到 Oracle Web 站点 2. 单击 修补程序 按钮 3. 在修补程序编号字段中键入 单击 32 位 Solaris OS 修补程序 转到 Metalink.oracle.com 5. 单击修补程序 6. 在修补程序编号中输入 单击 32 位 Solaris OS 修补程序 在 Solaris 中, 使用 Oracle 9.2 客户机访问 Oracle 9.1 数据库可能导致数据损坏 如果使用 Oracle(R) 9.2 客户机访问 Oracle 9.1 数据库, 则当编号列跟在时间标记类列之后时, 可能会出现数据损坏 此问题可能因同时使用 ojdbc14.jar 文件和 Oracle 9.1 数据库而引起 应用修补程序可能有助于解决运行 Oracle 9.1 数据库的 Solaris 32 位计算机上的问题 此 JDBC 驱动程序用于与 JDK1.4 一同使用的 Oracle 解决方法从 Oracle Web 站点获取 Oracle 可能发布的针对错误 的修补程序, 并将其应用于服务器 第 24 页, 共 66 页 Sun Java System Application Server 7 发行说明 2004 年 5 月

25 必须正确配置 Oracle JDBC 驱动程序以便与 J2EE 1.3 兼容 解决方法 对类型 2 和类型 4 驱动程序应用以下配置 : 1. 使用 或更高版本的 JDBC 2. Oracle 数据库的参数 (init.ora) 文件中应具有 compatible= 使用 ojdbc14.jar 文件 4. 配置 Sun ONE Application Server 以定义以下 JVM 属性 : -Doracle.jdbc.J2EE13Compliant=true 此外, 对于类型 2 驱动程序, 必须在启动 Sun ONE Application Server 的环境中定义 ORACLE_HOME 和 LD_LIBRARY_PATH ( 必须包括 $ORACLE_HOME/lib) 例如, 将它们添加到 asenv.conf 文件并确保将其输出 文件号码 第 25 页, 共 66 页

26 使用 DB2 类型 2 驱动程序时, 空闲超时后 Sun ONE Application Server 连接数不断增加问题如下 : 如果为 DB2 数据库配置了错误的 datasource 类, 则由于连接不会被正确关闭, Sun ONE Application Server 将会用尽连接池中的连接 解决方法要避免此问题, 必须正确配置 DB2 类型 2 驱动程序 这些示例使用缺省的 DB2 客户机文件夹 /opt/ibm 1. 在 Sun ONE Application Server 所在的计算机上安装 DB2 客户机, 并在 DB2 服务器中登记数据库别名 2. 修改 Application Server 实例的 startserv 脚本以设置 DB2 环境 将以下行添加到 Application Server 实例的启动脚本中 : DB2DIR=/opt/IBM/db2/V8.1 export DB2DIR DB2INSTANCE=db2tmp export DB2INSTANCE 3. 由于具有口令的用户拥有客户机, 因此将以下值添加到连接池中 : user: db2inst1 password: db2inst1 databasename: sample2 datasourcename com.ibm.db2.jcc.db2simpledatasource 4. 将类路径修改为具有以下值 : /opt/ibm/db2/v8.1/java/db2jcc.jar /opt/ibm/db2/v8.1/java/db2jcc_license_cu.jar /opt/ibm/db2/v8.1/java/db2jcc_license_cisuz.jar /opt/ibm/db2/v8.1/java/db2java.zip 第 26 页, 共 66 页 Sun Java System Application Server 7 发行说明 2004 年 5 月

27 Web 容器 本节介绍已知的 Web 容器问题以及相应的解决方法 sun-web-app_2_3-0.dtd 文件中的 Web 高速缓存示例提供了不正确的 timeout 元素语法 timeout 元素被指定为在 XML 高速缓存对象中按如下方式使用 : <timeout> 60 </timeout> 由于名称参数是必需字段, 因此应将其写为 : <timeout name="foo">60</timeout> 解决方法不要与验证器一起使用 允许单独的 Web 应用程序共享相同的会话 将造成安全缺陷 解决方法根据 J2EE 规范中的规则, 每个已部署的 Web 应用程序都维护着单独 唯一的会话对象 ( 会话 ) 这是 Sun One Application Server 的缺省行为 但是, 在某些实例中可能需要允许单独的 Web 应用程序共享相同的会话 在这种情况下,Sun One Application Server 允许您在 sun-web.xml 部署描述符中指定特殊的部署属性, 以便通知应用服务器允许此特定的应用程序在执行 Web 应用程序模块的过程中重复使用会话 ( 首次访问 Web 应用程序时将生成新的唯一会话 此后向其他具有此属性设置的 Web 应用程序发送请求时将使用此相同的会话, 而不再为此客户机和此 Web 应用程序生成新的会话 ) 为此, 必须将每个要允许共享相同会话对象的已部署 Web 应用程序的 reusesessionid 属性设置为 True 例如: <?xml version="1.0" encoding="utf-8"?> <sun-web-app> <session-config> <cookie-properties> <property name="cookiepath" value = "/" /> <property name="cookiedomain" value = ".sun.com" /> </cookie-properties> </session-config> <property name="reusesession" value="true"/> </sun-web-app> 倒数第二行的属性 reusesession 设置为 True 注意 : 打开 reusesessionid 会可能会产生安全缺陷 ( 即使其本身并没有缺陷 ) 此属性不应当用于允许多个客户在相同 Sun One Application Server 实例上运行其应用程序的共享环境 ( 例如 ISV) 在上述设置下, 使用缺省 J2EE 行为将更加安全, 该行为强制部署于相同服务器实例的不同 Web 应用程序使用不同的会话对象 文件号码 第 27 页, 共 66 页

28 EJB 容器 本节介绍已知的 Enterprise JavaBean (EJB ) 容器问题以及相应的解决方法 无法正确处理 ejbfind 方法返回的空 PK 下列容器管理的持久性 (CMP) 示例可从 ejbfind ( 假设从 EmployeeEJB Bean 调用, 因为它们返回的实例类型必须与 Bean 相同 ) 返回一个或多个空值 : 1. find insurance.employee where insurance.id == 10 如果此保险没有与其关联的雇员, 则会返回空值 2. find all insurance.employee where insurance.id > 10 此命令返回一个集合, 对于没有雇员的保险, 此集合中可能包含空值 对结果集中出现的第一个空 PC, CMP 客户机将获取 JDOFatalInternalException param0 不能为空 BMP 客户机将在单个对象查找程序中获得 EJBException 从 ejbfind 方法返回了空主键, 且 ( 可能 ) 在多对象查找程序中获得 NullPointerException 解决方法无 使用有状态会话 Bean 时, Sun ONE Application Server 有时会抛出 空指针异常 Sun ONE Application Server 中的 EJB 容器对有状态会话 Bean 进行高速缓存, 从而提高性能 如果高速缓存溢出 ( 即, 高速缓存中 Bean 的数量超出 max-cache-size), 则容器会将 Bean 挂起到磁盘 服务器有时会抛出 NullPointerException 当 max-cache-size 与 cache-resize-quantity 的差小于 8 时会出现此问题 解决方法确保 max-cache-size 与 cache-resize-quantity 的差大于 8, 或将 max-cache-size 设置为 0, 以使用无限制高速缓存 , 使用 Java WSPD 1.2 或 1.3 时抛出 javax.ejb.ejbexception: org/dom4j/element 异常 注意 : 如果应用程序没有使用 Java Web Services Developer Pack (Java WSDP) 1.2 或 1.3, 则此问题不适用 在安装了 Java WSDP 1.2 或 1.3 并将其配置为与 Sun ONE Application Server 7 一起使用, EJB 容器可能会抛出 javax.ejb.ejbexception:org/dom4j/element 异常 解决方法在 server.xml 中向 server-classpath 中添加最新的 dom4j-full.jar 该文件可从 下载, 并应该添加到 server-classpath 中的条目 appserv-jstl.jar 之前 如果 ejb-local-ref 未与 ejb-link 结合使用, 则部署时会发生错误 解决方法 ejb-local-ref 需要 ejb-link 使用 ejb-local-ref 时, 必须指定 ejb-link 的值 第 28 页, 共 66 页 Sun Java System Application Server 7 发行说明 2004 年 5 月

29 容器管理的持久性 本节介绍已知的容器管理持久性 (CMP) 问题和相应的解决方法 未初始化 Oracle JDBC 驱动程序优化 要通过容器管理的持久性 (CMP) Bean 利用 Oracle(R) 数据库优化, 必须在 server.xml 文件的 classpath-suffix 属性中指定 Oracle 驱动程序文件, 而不是将其置于实例的 /lib 目录 ( 第三方库的缺省目录 ) 中 解决方法将 Oracle 驱动程序文件添加到 server.xml 文件的 classpath-suffix 属性中 自引用 CMR 在部署期间导致出现问题 EJB 部署描述符的解析器 ejb-jar.xml 未正确处理自引用容器管理的关系 (CMR), 即 ejb-relationship-role 一侧的字段被跳过 解决方法切换 ejb-relationship-role 部分, 以便具有 <multiplicity> Many 的一侧在 ejb-relation 中处于第一位 在 Oracle 中, 如果未指定 -schemaname, 则 capture-schema 实用程序将不起作用 如果在从 Oracle(R) 数据库中捕获数据库模式信息时未指定 -schemaname 选项, 则 capture-schema 实用程序会产生以下问题 : 1. 如果尝试捕获所有表 ( 即不明确选择任何表 ): bin/capture-schema -dburl jdbc:oracle:thin:@oraserver:1521:ora -username scott -password tiger -driver oracle.jdbc.driver.oracledriver -out test.dbschema 您将收到 : java.sql.sqlexceptions ORA-00942: 表或视图不存在 结果输出文件已中断 2. 如果使用 -table 选项指定一个或多个表 : bin/capture-schema -dburl jdbc:oracle:thin:@oraserver:1521:ora -username scott -password tiger -driver oracle.jdbc.driver.oracledriver -table DEPT -out test.dbschema 得到的文件包含指定的表, 但没有列信息, 这表示此文件不能用于 CMP 映射 解决方法从 Oracle 数据库捕获模式时, 应始终使用以大写字母用户名作为值的 -schemaname 选项 : bin/capture-schema -dburl jdbc:oracle:thin:@oraserver:1521:ora -username scott -password tiger -driver oracle.jdbc.driver.oracledriver -schemaname SCOTT -out test.dbschema) 文件号码 第 29 页, 共 66 页

30 对于 capture-schema 实用程序 : 如果在 Oracle 和 / 或 PointBase 中未以大写字母指定 -table 选项的值, 则得到的文件将中断 Oracle(R) 和 PointBase 在内部将区分大小写的标识符转换为大写字母, 除非标识符用 " " 括起 从 Oracle 或 PointBase 捕获数据库模式时, capture-schema 实用程序无法正确地将由小写字母或大小写混合字母组成的表名 ( 例如 -table student 或 -table Student) 作为 -table 选项的参数进行处理 生成的数据库模式文件将不包含相应表的任何列信息 解决方法使用大写字母指定表名 ( 例如 -table STUDENT) 消息服务和消息驱动 Bean 本小节介绍已知的 Java 消息服务 (JMS) Sun ONE Message Queue 以及消息驱动 Bean 方面的问题和相应的解决方法 如果值包含空格, 则所有 MQ Solaris/Microsoft Windows 脚本中的 -javahome 标志将全都不起作用 Sun ONE Message Queue 中的命令行实用程序包含一个 -javahome 选项, 允许您指定替代的 Java 运行时 使用此选项会暴露一个局限性, 即指定的替代 Java 运行时路径不能包含空格 以下是包含空格的路径示例 : Microsoft Windows:C:\jdk 1.4 Solaris:/work/java 1.4 启动 Sun ONE Application Server 实例时会出现此问题 启动 Sun ONE Application Server 实例时, 缺省情况下其相应的 Sun ONE Message Queue 代理程序实例也将启动 此代理程序始终使用 -javahome 命令行选项启动, 以确保其使用的 Java 运行时与 Sun ONE Application Server 所使用的相同 如果配置由 Sun ONE Application Server 使用 ( 进而由代理程序沿用 ) 的 Java 运行时所在路径包含空格, 则代理程序启动将失败, 同时导致 Sun ONE Application Server 实例启动失败 解决方法确保 Sun ONE Application Server 使用的 Java 运行时所在的路径不包含空格 Java 事务服务 (JTS) 本节介绍已知的 Java 事务服务 (JTS) 问题和相应的解决方法 第 30 页, 共 66 页 Sun Java System Application Server 7 发行说明 2004 年 5 月

31 恢复 某些 JDBC 驱动程序的恢复实现中存在一些已知的问题 对于这些已知问题, Sun One Application Server 提供了一些解决方法 缺省情况下不会使用这些解决方法, 除非明确指示要使用这些解决方法 Oracle(R) JDBC 驱动程序的问题 Oracle XA Resource 实现的恢复方法重复返回同一组不确定的 Xid, 不管输入标志为何 根据 XA 规范, 事务管理器应首先通过 TMSTARTSCAN 调用 XAResource.recover, 然后再通过 TMNOFLAGS 反复调用 XAResource.recover, 直到不再返回 Xid 为止 Oracle XA Resource 的提交方法也存在一些问题, 这些问题已在 Sun ONE Application Server 提供的解决方法中得到了解决 要实现此解决方法, 应将以下属性添加到 server.xml 文件的 transaction-service 子元素中 :oracle-xa-recovery-workaround 此属性值应设置为 True Sybase JConnect 5.2 的问题 JConnect 5.2 驱动程序存在一些已知问题, 这些问题已在 JConnect 5.5 中得到解决 如果使用 JConnect 5.2 驱动程序恢复工作, 应将以下属性添加到 server.xml 文件的 transaction-service 子元素中 : sybase-xa-recovery-workaround 此属性值应设置为 True 事务 在 server.xml 文件中, res-type 用于区分连接是非 XA 还是 XA 此区分用于标识数据源的配置以驱动数据 例如, 在 Datadirect 驱动程序中, 同一数据源既可以用作 XA 也可以用作非 XA 数据源的缺省行为是非 XA 要使用事务的 connpool 元素将数据源行为设置为 XA, 则需要 res-type 要使 connpool 元素起作用并参与事务, 请为 server.xml 文件的 res-type 属性添加以下内容 : res-type="javax.sql.xadatasource" 无法使用来自非 txn 上下文中 XADatasource 的连接 这是已知的数据库驱动程序问题 当非 txn 上下文中的 XADataSource 存在连接时, 缺省情况下, Autocommit 将设置为 False 解决方法使用非 XA DataSource 类明确调用提交 / 回滚程序, 而不是通过事务进行调用 文件号码 第 31 页, 共 66 页

32 非零事务超时设置会导致本地事务处理速度降低 本地事务管理器当前不支持具有明确超时的事务 如果将 transaction-service 元素中的 timeout-in-seconds 属性设置为大于 0 的值, 则所有本地事务都将作为全局事务进行处理, 这将花费较长时间才能完成 如果数据源驱动程序不支持全局事务, 本地事务也可能失败 超时值为 0 表示如果事务管理器未从参与的数据源接收到响应, 它将无限期等待 解决方法将 timeout-in-seconds 的值重置为缺省值 0 应用程序部署 本节介绍已知的部署问题和相应的解决方法 Microsoft Windows 不支持长路径名 有关此问题的信息, 请参见第 10 页的 安装与卸载 重新部署 EJB 模块 ( 具有 MDB) 会抛出资源冲突异常 当在使用 Sun ONE Studio 4 的 Microsoft Windows 2000 上使用消息驱动的 Bean (MDB) 时将出现这种情况 如果 EJB 模块包含利用特定队列的 MDB, 则重新部署具有相同 MDB ( 利用相同的队列 ) 的相同 EJB 模块会引起资源冲突 这会使 ( 已修改 ) 模块不可用 解决方法无 无法选择特定虚拟服务器进行部署 在此情况下, 两个虚拟服务器会配置为使用完全相同的主机和侦听器 如果仅对第二个虚拟服务器部署应用程序, 则无法到达此服务器, 因为 host:port 组合会指向第一个虚拟服务器 解决方法虚拟服务器主机名不应与原始主机名相同, 尤其是在使用了相同的 HTTP 侦听器的情况下 无法使用 Bean 软件包中的用户的 Query 类来部署应用程序 对于 concreteimpl 中的 JDO Query 变量, 容器管理的持久性 (CMP) 代码生成不使用全限定名称 如果抽象 Bean 所在的软件包中存在 Query 类, 则会发生编译错误 解决方法将 Query 类移到其他软件包或独立的软件包中 第 32 页, 共 66 页 Sun Java System Application Server 7 发行说明 2004 年 5 月

33 在 Solaris 中, Sun ONE Application Server 可能会在动态重新装入过程中崩溃 对于大型应用程序 ( 具有许多企业 Bean), 应用程序动态重新装入期间可能会崩溃 在开发环境中使用动态重新装入功能, 可以快速测试对应用程序的细微更改 导致崩溃的原因是尝试使用的文件描述符多于可用描述符 解决方法 1. 以下面的格式向 /etc/system 文件添加行, 以增加文件描述符限制 可以根据应用程序的大小设置较高或较低的值 set rlim_fd_max=8192 set rlim_fd_cur= 重新引导系统 验证器 本节介绍已知的验证器问题和相应的解决方法 独立验证器显示 未找到 EJB 类 错误 验证器使用以下测试说明消息指示某些失败的测试 : 未找到 EJB 类 当某个 EJB JAR 文件使用企业 Bean, 并同时引用在同一 EAR 应用程序中另一个 EJB JAR 文件内打包的企业 Bean 时, 测试将失败 如果尝试验证连接器 (RAR) 从属的 EAR 文件, 也会看到失败消息 这是因为 RAR 束无需在具有从属于 RAR 束文件的企业 Bean 的 EAR 文件中打包 仅当使用独立验证器时, 才能发现失败 ( 连接器相关的失败除外 ) 通过部署命令或管理界面调用的验证器不显示失败 解决方法确保应用程序 EAR 打包正确, 如果使用的是任何实用程序 JAR 文件, 则会将其打包到 EAR 文件中 要解决引用错误, 可以使用 asadmin 或管理界面切换到通过部署后端调用的验证器 对于与连接器相关的失败, 请将包含必需类的 JAR 文件放置到验证器的类路径中 可以打开 install_root/bin/verifier[.bat] 文件, 并将 LOCAL_CLASSPATH 变量添加到 JVM_CLASSPATH 变量的后面 从本地将类添加到 LOCAL_CLASSPATH 变量中, 然后运行验证器 配置 java-config 元素的 env-classpath-ignored 属性的缺省值为 True 本版本未实现的内容 : server.xml 中 java-config 元素的 bytecode-preprocessors 属性 ( 可能会在以后的性能修补程序中提供 ) 文件号码 第 33 页, 共 66 页

34 本版本禁止的内容 : is-cache-overflow-allowed max-wait-time-in-millis 由于 J2EE 1.4 体系结构的更改, 在以后的版本中可能不支持某些元素, 例如 : mdb-container 元素的 cmt-max-runtime-exceptions 属性 下表介绍已知的 Sun ONE Application Server 7 的配置问题以及相应的解决方法 如果网络中未使用 IPv6, 则不会出现此问题 注释 : 如果网络中未使用 IPv6, 则不会出现此问题 缺省情况下,Sun ONE Application Server 使用 IPv4 使用 Sun ONE Application Server 的所有平台都支持它 在某些平台上也支持 IPv6 在此情况下, 为保持一致, 需要更改 Sun ONE Application Server 的配置 注 : 如果要更改这些配置, 则必须完全确定平台支持 IPv6 如果将 IPv6 的相关配置应用到仅支持 IPv4 的系统, 则可能不能启动服务器实例 解决方法请执行下列配置更改 : 1. 启动管理服务器 2. 启动管理界面 ( 通过浏览器连接到管理服务器 http 主机 / 端口 ) 3. 选择 App Server 实例 ( 例如 server1) 进行 IPv6 的相关配置 4. 展开树视图中的 HTTP 侦听器 节点 5. 选择 HTTP 侦听器 ( 例如 http-listener1) 进行 IPv6 的相关配置 6. 在 常规 部分, 将 IP 地址 字段中的值更改为 ANY 7. 在 高级 部分, 将 系列 字段中的值更改为 INET6 将 系列 字段设置为 INET6 不会禁用 IPv4 功能, 除非已为 IP 地址选择了 IPv6 地址 选择 ANY 作为 IP 地址将与任何 IPv4 或 IPv6 地址匹配 8. 单击 保存 9. 在左侧窗格中, 选择服务器实例 10. 单击 应用更改 11. 单击 停止 12. 单击 启动 将重新启动服务器并实现更改 第 34 页, 共 66 页 Sun Java System Application Server 7 发行说明 2004 年 5 月

35 部署描述符 本节介绍已知的部署描述符的问题 sun-cmp-mapping.xml 问题 本版本未实现的内容 : check-modified-at-commit lock-when-modified sun-ejb-jar.xml 问题 本版本禁止的内容 : is-cache-overflow-allowed max-wait-time-in-millis 监视 本节介绍已知的监视问题和相应的解决方法 Total-connections-failed-validation 不显示值 该问题伴随引用实现 (RI) 中固有的双倍缓冲问题出现 解决方法无 FlagAsyncEnabled 在 http-server 中未设置为 1 这是已知的 Sun ONE Web Server 问题 解决方法无 未显示 getprimarykey() getejbmetadata() gethomehandle() 方法的监视 Bean 方法属性值 监视工具列出可监视的企业 Bean 中的方法 对于 getprimarykey() getejbmetadata() 和 gethomehandle(), 方法级监视属性始终显示 0 解决方法无 文件号码 第 35 页, 共 66 页

36 服务器管理 本节介绍以下内容 : 命令行界面 (CLI) 管理基础结构 管理界面 命令行界面 (CLI) 本节介绍已知的命令行界面问题和相应的解决方法 如果命令包含的字符多于 256 个, 则 CLI 命令在单模式下溢出 在 UNIX(R) 中, 在单模式下执行包含多于 256 个字符的 CLI 命令时, 命令失败并显示以下错误 :... 未找到命令... 这是终端限制, 而非 CLI 限制 示例 : create-jdbc-connection-pool --instance server4 --datasourceuser admin --datasourcepassword adminadmin --datasourceclassname test --datasourceurl test --minpoolsize=8 --maxpoolsize=32 --maxwait= poolresize=2 --idletimeout=300 --connectionvalidate=false --validationmethod=auto-commit --failconnection=false --description test sample_connectionpoolid) 解决方法 1. 对于需要多于 256 个字符的命令, 请使用 CLI 多模式 2. 如果必须使用单模式, 请使用 OpenWin cmdtool 运行命令 将实例配置为使用 SSL 后, 管理员将无法通过 CLI 或浏览器客户机访问管理服务器 解决方法将 Sun ONE Application Server 证书导入每个使用 SSL 访问管理服务器的客户机, 并指示要信任具有这种证书的服务器 如何在浏览器上进行此操作因浏览器而异 ; 请查阅浏览器联机帮助, 了解如何导入要被信任的证书 对于 CLI, 如果服务器的证书位于某个 servercert.cer 文件中, 且安装目录是 /INSTALL, 则命令为 : keytool -import -file servercert.cer -alias server -keystore /INSTALL/jdk/jre/lib/security/cacerts 注释 : 要避免将来发生此问题, 请确保在将管理服务器配置为使用 SSL 之前, 已在服务器和客户机上安装了管理服务器证书 第 36 页, 共 66 页 Sun Java System Application Server 7 发行说明 2004 年 5 月

37 在单模式的 CLI 命令中使用星号 (*) 字符会产生意外的行为和 / 或错误消息 星号字符被基础 Shell 扩展为名称列表, 此名称列表就是使用命令行界面 (CLI) 命令查看的列表 在星号两边加上引号会防止 Shell 扩展星号, 这样使用 CLI 就可以看到星号本身 解决方法在星号两边加上引号 ( 单引号或双引号均可 ) 对任何实例进行重复更改最终会导致内存不足的错误 管理服务器会保留对系统所执行的全部更改的记录, 这将占用内存 重新配置期间将放弃此更改记录 ( 而非更改本身 ), 从而释放内存以供使用 解决方法定期使用 asadmin 重新配置命令, 放弃以前的更改记录 如果创建重复域的调用失败, 则不进行清除 如果创建的域已存在, 将生成相应的错误消息 但是, 会创建 create-domain 命令中 -path 选项指定的目录 ( 如果它之前不存在 ) 应该删除它, 因为命令已失败 解决方法删除使用 -path 选项后可能创建的任何其他指定的空目录 无法监视缺省 (Pointbase) 连接池 JDBC 资源 JDBC 连接池会根据需要动态创建, 这意味着会在第一次使用连接池时创建它 如果尚未创建 ( 未使用 ) 池, 则无法进行监视 解决方法创建所需的连接池, 以允许进行监视 文件号码 第 37 页, 共 66 页

38 监视 : 少于 1 毫秒的执行时间无法进行测量 监视实体 Bean 方法时, execution-time-millis 属性显示 -1 例如, 当运行以下命令时 : iasadmin>get -m server1.application.usecase1app.ejb-module.usecase1ejb_jar.entity-bean. BeanOne.bean-method.method_create0.* 将返回以下属性 : Attribute name = total-num-errors Value = 0 Attribute name = method-name Value = public abstract com.iplanet.ias.perf.jts.usecase1.ejb.beanoneremote com.iplanet.ias.perf.jts.usecase1.ejb.beanonehome.create() throws javax.ejb.createexception,java.rmi.remoteexception Attribute name = total-num-calls Value = 0 Attribute name = total-num-success Value = 0 Attribute name = execution-time-millis Value = -1 启动监视前, execution-time-millis 的缺省值将设置为 -1, 表示该属性的值当前无效 缺省值 0 会错误地指示执行时间已被测量, 但实际的结果是一个非常小的值 解决方法无 查看通过命令行界面创建的 Persistence Manager Factory 资源时, 管理界面中报告验证器错误 在管理界面中查看 Persistence Manager Factory 资源时, 如果该资源是通过命令行界面创建的, 将报告以下资源错误 : ArgChecker 失败 : jndiname 验证失败 : 对象必须非空 解决方法无 在 Solaris 中, 当对已集成到 Solaris 中的 Sun ONE Application Server 运行 flexanlg 命令时, 会导致打开失败 如果运行的是已集成到 Solaris 操作环境的版本, 且从 /usr/appserver/bin 中使用 flexanlg 命令, 则会显示打开失败错误 ld.so.1: /usr/appserver/bin/flexanlg: 严重 :libplc4.so: 打开失败 : 无此文件或目录已终止 解决方法完成下列步骤 1. 将下列条目添加到 LD_LIBRARY_PATH 文件中 : usr/lib/mps 2. 然后运行 flexanlg 命令 % /usr/appserver/bin/flexanlg 第 38 页, 共 66 页 Sun Java System Application Server 7 发行说明 2004 年 5 月

39 某些 CLI 命令无法在目标管理服务器上运行 create delete 或 list 命令无法在目标管理服务器的 CLI 上执行创建 / 删除 / 列出管理服务器 server.xml 文件中的新元素 ( 例如, SSL mime 事件探查器 资源等) 操作 解决方法使用管理界面创建 删除和列出管理服务器中的元素 管理基础结构 本节介绍有关管理基础结构的已知问题和相应的解决方法 在 Microsoft Windows 2000 上, 将 JVM 堆大小设置为较大值时, 无法创建 JVM 如果尝试在 Windows 2000 上设置较大的 JVM 堆大小, 可能会收到以下错误消息 : 初始化 JVM 期间发生错误 无法为对象堆保留足够的空间内部错误 : 无法创建 JVM 解决方法要在 Windows 2000 上将 Sun ONE Application Server 配置为较大的 JAVA 堆大小, 必须对 Sun ONE Application Server DLL 使用 Rebase 实用程序 Rebase 实用程序 ( 与 Microsoft Framework SDK 和 Microsoft Visual Studio 一同提供 ) 允许从某一地址开始为一些 DLL 设置最佳基地址, 并由此增加 JVM 堆的可用性 SDK Help Rebase 主题建议使用地址 0x 有关 Rebase 实用程序的详细信息, 请访问 : /performance_tools.asp 要求 : 具有 2 到 4 GB 内存的 Window 2000 系统 Visual Studio/Microsoft Framework SDK Rebase 实用程序要将 Rebase 应用到 S1AS 动态库, 请执行以下操作 : 1. 使用 cd 命令进入 install_dir\bin 目录 2. rebase -b 0x *.dll 3. cd..\lib 4. rebase -b 0x *.dll 文件号码 第 39 页, 共 66 页

40 未强制执行 HTTP 服务质量限制 服务质量 (QOS) 包括指定 HTTP 连接的最大数目和带宽限制的方法 当超过这些属性时, 应向客户机返回 503 错误 但是, 通过管理界面启用 QOS 后, 服务器未强制执行 QOS 限制 解决方法要完全启用 QOS 功能, 必须手动将 AuthTrans fn=qos-handler 行添加到虚拟服务器的 obj.conf 文件中的缺省对象的顶部 Developer's Guide to NSAPI 中介绍了 qos-handler 服务器应用程序功能 (SAF) 和 obj.conf 配置文件 如果实例最初在非调试模式下运行, 则在调试模式下重新启动实例可能会失败 如果启动实例时未选中 在调试模式下启动 / 重新启动 复选框, 则此复选框的后续设置将不起作用 在管理界面中, 已启用调试 复选框显示为未选中状态 ( 即使此复选框已被选中 ) server.xml 文件还显示 debug-enabled=false 解决方法无 在 Microsoft Windows 2000 中, 如果在部署期间生成的文件的总路径长度超过 260 个字符, 则 EAR 文件的部署将失败 在 Windows 2000 平台上, Java 虚拟机 (JVM) 将生成文件的路径名长度限制为 260 个字符 这是 Microsoft Windows 对 JVM 的支持方面的问题, 有可能在 J2SE 1.5 版本中得到解决 解决方法部署应用程序时, 使用的路径和文件名字符数加起来不应超过 260 个 在 Solaris 中, 服务器在转换到启用了 SSL 的环境时无法重新启动 如果尝试在安装证书并启用安全性后重新启动 Sun ONE Application Server, 则重新启动将失败 将显示一条消息, 指示服务器无法接收口令 再次单击 启动 按钮将启动服务器 如果未启用 SSL, 则不会高速缓存口令, 从而导致重新启动失败 重新启动命令不支持从非 SSL 模式转换到启用了 SSL 的模式 注释 : 此问题仅在第一次重新启动服务器时出现 以后再重新启动就会正常进行 解决方法如果遇到此问题, 请 : 单击 启动 要避免此问题, 请按照以下步骤操作, 而不要单击 重新启动 按钮 单击 停止 单击 启动 第 40 页, 共 66 页 Sun Java System Application Server 7 发行说明 2004 年 5 月

41 如果域是在其他系统中创建的, 则无法启动管理服务器 如果域是在安装了 PCNFS 的驱动器上创建的, 则无法启动此类域中的管理服务器和任何实例 ( 由于存在一个与 PCNFS 驱动器有关的已知 Microsoft 问题 ) 如果创建的域与产品安装位于相同的本地驱动器中, 但目录路径不同, 则实例和管理服务器会按预期的方式工作, 且具有完全可操作性 解决方法无 在 Microsoft Windows 2000 中, 有时会禁用控制台 在部署期间或运行命令时, 管理服务器或 App Server 实例有时 ( 很少 ) 会挂起 当从控制台日志中选择部分文本时可能会出现此情况 如果取消选择控制台日志上的文本, 进程将继续 解决方法将 log-service create-console 属性设为 False, 以禁止自动创建 server1 实例控制台 在控制台日志上单击鼠标或按 Enter 键也可以解决此问题 从服务器删除安全的 http 侦听器后, 系统仍会提示管理员输入 ( 不再需要的 ) 口令 解决方法删除整个服务器, 然后重新添加它 注释 : 为避免将来出现问题, 在删除 http 侦听器之前, 请先使用以下命令禁用安全性 : /export2/build/bin/> asadmin set --user admin --password adminadmin server1.http-listener.http-listener-1.securityenabled=false 将 securityenabled 属性设置为 False /export2/build/bin/> asadmin delete-http-listener --user admin --password adminadmin ls2 删除 id = ls2 的 Http 侦听器 在 Microsoft Windows 2000 中, 控制台上显示乱码消息 在 Windows 2000 中, 如果是非英文语言环境 ( 如日文 ), 则可能会看到控制台上显示乱码消息 解决方法使用管理界面查看日志消息 文件号码 第 41 页, 共 66 页

42 部分删除的实例会导致某些 CLI 命令发出错误的响应 如果部分删除服务器实例, 则执行某些 CLI 命令会出现以下可知的问题 ( 每个问题的说明中都提供了解决方法 ): 1. 即使实例文件夹下没有子目录, 在本地模式下执行 create-instance 命令也会报告该实例已存在 解决方法手动删除其余的实例目录, 然后运行 create-instance 命令 2. 本地模式下的 list-instances 命令包括部分删除的实例名称和状态 解决方法手动删除其余的实例目录, 然后运行 list-instances 命令 3. 在 Microsoft Windows 2000 中, 远程模式下的 start-instance 命令显示空字符串 解决方法手动删除其余的实例目录, 创建新的实例, 然后运行 start-instance 命令 4. 在 Microsoft Windows 2000 中, 本地和远程模式下的 stop-instance 命令都会报告不正确的异常 在本地模式下, 此命令会显示一条不正确的消息, 指示实例未运行 在远程模式下, 此命令将显示空字符串 在 Solaris 中, 本地模式下的 stop-instance 命令会错误地报告用户无权访问实例的 config 目录 ( 虽然 config 目录并不存在 ) 解决方法手动删除其余的实例目录 如果虚拟服务器引用的缺省 Web 模块不存在或未部署, 则无法删除虚拟服务器 解决方法将虚拟服务器的 缺省 Web 模块 字段设置为 无选定内容, 单击 确定 保存更改, 然后删除虚拟服务器 SNMP: 添加和启动新的实例服务器时, 返回 END OF MIB 如果在添加和启动新实例时未关闭实例服务器和子代理, 则会返回 END OF MIB 消息 解决方法 1. 要查看新实例, 请确保已关闭子代理和所有实例服务器进程 在每个服务器 -> 监视 -> 启用 SNMP 统计集合 : 打开 下, 应用更改, 然后重新启动每个实例服务器, 并仅再启动一个子代理进程 2. 如果子代理已处于运行状态, 请不要在任何实例中启动任何额外的子代理进程 Sun ONE Application Server 安装只能有一个主代理和一个子代理 ( 所有域 / 实例均如此 ) 第 42 页, 共 66 页 Sun Java System Application Server 7 发行说明 2004 年 5 月

43 在 Microsoft Windows 服务或 DOS 提示下不显示许可证过期消息 许可证过期后, 从 Windows 服务或从 DOS 提示命令 (startserv.bat) 启动服务器时, 不显示相应的许可证过期消息解决方法通过 CLI (asadmin) 或 Sun 程序图标启动服务器 存在多个 obj.conf 文件导致混乱 在创建新的 Sun ONE Application Server 实例时,instance-dir/config/ 目录将包含两个 obj.conf 文件 :obj.conf 和 virtual-server-name-obj.conf, 其中 virtual-server-name 的值与在实例创建过程中自动创建的虚拟服务器的实例名相同 该文档中指向 obj.conf 文件的修改, 而实际上它应该指向 与所需虚拟服务器关联的 obj.conf 文件的修改 安装 Sun ONE Application Server 后, obj.conf 和 server1-obj.conf 文件将位于 /domains/domain1/server1/config/ 目录下 obj.conf 文件中的内容将被在虚拟服务器级别指定的 server1-obj.conf 文件的内容所覆盖 实际上, Sun ONE Application Server 实例不使用名为 obj.conf 的文件 例如, 如果在配置 Sun ONE Application Server Web 服务器插件时修改了名为 obj.conf 的文件, 则由于修改了错误的 obj.conf 文件传送设置将不会生效 解决方法如果需要修改实例的 obj.conf 文件, 请修改以所需虚拟服务器名称为前缀的文件 使用 SSL 和 Web 服务器 ( 反向代理 ) 插件时出现的错误 使用 SSL 和 Web 服务器插件时出现 502 错误解决方法在 Sun ONE Web Server 的 magnus.conf 文件和 Sun ONE Application Server 的 init.conf 文件中设置相同的 keepalivetimout 值 如果这些值不同, 则当 Application Server 连接至 Web Server 或 Web Server 连接至 Application Server 时, 连接可能会关闭 如果连接已经关闭, 则显示 502 错误 管理界面 使用管理界面时, 请确保已将浏览器配置成从服务器中检查是否有较新版本的页面, 而不是从高速缓存中选取这些页面 通常, 缺省浏览器设置不会导致出现问题 在 Internet Explorer 中, 请确保 工具 -> 设置... -> 检查更新版本的存储页面 : 未设置为 永不 在 Netscape 中, 请确保 编辑 -> 首选项... -> 高级 -> 高速缓存 -> 比较高速缓存中的页面与网络上的页面 : 未设置为 永不 本节介绍有关 Sun ONE Application Server 7 管理图形用户界面的已知问题和相应的解决方法 文件号码 第 43 页, 共 66 页

44 在 Microsoft Windows 2000 中, 无法编辑或删除新建的 MIME 文件 ( 该文件不具有.types 扩展名 ) 中的条目 在 Windows 2000 上, MIME 文件必须在文件名后包含.types 扩展名, 才能修改文件中的条目 例如, mime2.types ( 而不是 mime2) 解决方法对任何 MIME 文件名均使用.types 作为扩展名 外部证书昵称未显示在管理界面的 昵称 列表中 如果通过 Sun ONE Application Server 管理界面安装外部证书, 则会在尝试使用安装在外部加密模块上的证书为 http 侦听器启用 SSL 时遇到问题 即使成功完成了证书的安装, 证书昵称也不会显示在管理界面中 解决方法 1. 以管理员用户身份登录安装了 Sun ONE Application Server 软件的系统 2. 将 http 侦听器链接到安装在外部加密模块上的证书 执行 asadmin 命令 有关 asadmin 命令的详细信息, 请参见 asadmin(1m) 手册页 /sun/appserver7/bin/asadmin create-ssl --user admin --password password --host host_name --port type http-listener --certname nobody@apprealm:server-cert --instance server1 --ssl3enabled=true --ssl3tlsciphers +rsa_rc4_128_md5 http-listener-1 此命令将建立证书与服务器实例之间的链接, 但并不安装证书 ( 已使用管理界面安装了证书 ) 即使将证书链接到 http 侦听器, http 侦听器也会在非 SSL 模式下进行监听 3. 使用以下 CLI 命令使 http 侦听器在 SSL 模式下监听 /sun/appserver7/bin/asadmin set --user admin --password password --host host_name --port 8888 server1.http-listener.http-listener-1.securityenabled=true 此命令将服务器实例的监听状态从非 SSL 切换到 SSL 完成前面的步骤后, 证书将显示在管理界面中 4. 现在可以使用管理界面根据需要编辑 HTTP 侦听器 第 44 页, 共 66 页 Sun Java System Application Server 7 发行说明 2004 年 5 月

45 创建新的虚拟服务器并且给定日志文件的位置值时, 会报告 未找到文件 错误 在管理界面中, 不能使用 日志文件 字段添加任何值 解决方法删除刚刚创建的虚拟服务器, 创建所需文件, 然后重新创建虚拟服务器 注释 : 要避免将来出现问题, 请在尝试创建新的虚拟服务器之前, 始终先创建日志文件 在 Solaris 9 update 2 上, 缺省浏览器与 Sun ONE Application Server 7 不兼容 当您尝试将 Sun ONE Application Server 管理界面与 Solaris 9 4/03 操作环境缺省浏览器一起使用时, 将显示以下错误消息 : 不支持的浏览器 : Netscape 4.78 建议将浏览器升级至 Netscape 4.79 或 Netscape 6.2, 以运行 Sun ONE Application Server UI 选择不继续和不升级的用户可能会注意到性能下降和/ 或出现意想不到的情况 注意 : 如果运行的 Sun ONE Application Server 管理界面的版本包括在 Solaris 9 4/03 操作环境中, 则您将需要使用 Netscape 4.79 或 Netscape 7.0 解决方法 如果使用 Sun ONE Application Server 7 单机版, 则升级至 Netscape 4.79 或 Netscape 6.2 用 /usr/dt/bin/netscape6 代替 /usr/dt/bin/netscape 如果使用 Solaris 附带的 Sun ONE Application Server 7, 则升级至 Netscape 4.79 或 Netscape 7 用 /usr/dt/appconfig/sunwns/netscape 代替 /usr/dt/bin/netscape 某些版本的 Netscape Navigator 不支持访问控制列表 (ACL) 编辑 如果在使用 Netscape Navigator 版本 6.x 或 7.x 时尝试编辑 ACL 条目, 则可能会遇到间歇性的问题 ( 例如, 浏览器消失, 或 ACL 编辑屏幕从不显示 ) 解决方法请选择以下解决方法之一 使用支持的 Netscape Navigator 4.79 版本 手动编辑 ACL 文件 有关 ACL 文件格式的详细信息, 请参见 Sun ONE Application Server 管理员指南 Netscape 4.8 会在管理界面上显示警告消息 使用 Netscape 4.8 访问管理界面时, 会出现一个警告, 指示 Netscape 4.8 是不受支持的浏览器 尽管尚未确定使用 Netscape 4.8 运行管理界面时的问题, 但仍需要在此版本的 Netscape 浏览器上进行更彻底的测试 解决方法选择警告消息中的 继续 超链接以继续使用管理界面 使用 Netscape 4.79, 或升级到 Netscape 6.2 文件号码 第 45 页, 共 66 页

46 安装证书 屏幕上出现无效的 帮助 按钮 在 安装证书 屏幕 ( 其中显示所有输入的证书信息 ) 上, 管理界面中出现无效的 帮助 按钮 如果单击此按钮, 则会显示错误消息, 指示未找到帮助页 仅当单击任一页面顶部框中的 帮助 链接时, 才可以使用上下文相关的帮助 解决方法单击顶部窗格中的 帮助 链接, 获得上下文相关的帮助 SSL: 由 certutil 生成的自签名证书未显示在 证书昵称 列表中 自签名证书由 certutil 生成, 且 证书昵称 未显示在管理界面中 解决方法要使用自签名证书, 必须手动编辑 server.xml 文件 如果浏览器使用代理服务器, 则在访问管理界面时将出现错误 如果将浏览器设置为使用代理服务器, 但代理服务器没有配置为忽略本地主机, 则在您从 开始 菜单中选择 启动管理控制台 时将发生错误 解决方法禁用代理服务器 或将本地主机包含在应被其代理服务器忽略的域列表中 在 Red Hat Enterprise Linux AS 3.0 中添加 MIME 类型失败 在尝试通过管理界面向 MIME 类型文件中添加 MIME 类型时发生错误, 提示禁止访问 全局 MIME 类型 页 解决方法发生此问题的原因是缺省的语言环境被设置为 en_us.utf-8 而不是 en_us 解决的方法是设置 export LANG=en_US, 然后重新启动管理服务器 在 Solaris x86 上, 管理界面中的 HTTP 侦听器和 IIOP 侦听器页面给出错误 解决方法某些版本的 jss3.jar 会导致此问题 有以下两种解决方法 : 1. 对于修补程序级别 和 , 使用更高版本升级 SUNWjss 软件包 2. 从服务器的类路径中删除 jss3.jar 的路径 要删除该路径, 请打开 server.xml 进行编辑 从类路径中删除 usr/share/lib/mps/secv1/jss3.jar 除非已明确对其进行修改, 否则这是类路径中的第一个条目 保存 server.xml 并运行 asadmin reconfig 在启动服务器实例之前, 还需要重命名 jss3.jar 第 46 页, 共 66 页 Sun Java System Application Server 7 发行说明 2004 年 5 月

47 Sun ONE Studio 4 插件 本节介绍有关 Sun ONE Studio 4, Enterprise Edition ( 以前称为 Forte for Java) 的已知问题和相应的解决方法 当在由 Sun ONE Studio 4 使用的目录中指定空格时, 将发生错误 如果目录结构中使用了空格, 则 Sun ONE Studio 4 无法正确安装 安装程序将检查安装路径中是否包含空格, 如果发现空格, 则将显示错误对话框 解决方法指定 Sun ONE Application Server 的 Sun ONE Studio 4 组件的安装目录时不要使用空格 建立调试器连接时抛出 ConnectionException Sun ONE Studio 4 进行多次提示, 询问是否要创建新的调试会话, 然后抛出异常 解决方法重新启动 E 在 FFJ 中使用 MAD 环境会产生副作用 同时使用 MAD 配置和 Sun ONE Studio 4 时会出现间歇性的问题 解决方法不要同时使用 Sun ONE Studio 4 和 MAD 配置 在应用程序节点应用的 ejb-name 更改无法部署 在应用程序的上下文中, 使用选择应用程序节点的上下文菜单 ( 右击菜单 ) 的 查看 EJB 名称 项目时显示的对话框, 可以更改 Bean 的 ejb-name 元素 这些更改将应用到在打包过程中创建的 alt-dd 上 名称更改不会传播到 Sun ONE Application Server alt-dd 解决方法无 预配置的 Sun ONE 特定的属性值不会显示在编辑器中 如果您有一个 RAR 文件已为了部署到 Sun ONE Application Server 而进行了配置, 则在您尝试查看属性表中的属性值时, 您将会看到缺省值, 而不是在 sun-ra.xml 文件中指定的值 解决方法从 RAR 中解压缩 Sun 特定的描述符 XML 文件, 并将其置于与 RAR 相同的目录中 这样即可编辑 s1as 描述符 注释 : 用户以这种方式编辑不会更改 RAR 文件的初始内容, 但发送到服务器的 RAR 文件将包含已更新的 XML 文件 文件号码 第 47 页, 共 66 页