Sun Java System Web Server 6.1 2005Q1 SP4 发行说明 |
Sun Java System Web Server 发行说明
版本 6.1 SP4
文件号码 819-2042
2005 年 3 月
Sun Java System Web Server 6.1 2005Q1 SP4(以下称作 Sun Java System Web Server 6.1 SP4)包含重要的安全缺陷修复程序。Sun Java System Web Server 的所有用户,特别是那些站点中使用了安全套接字层 (SSL) 版本 3 或传输层安全性 (TLS) 的用户,强烈建议您安装此服务包。此版本还支持 HP-UX 和 AIX 平台。
本发行说明包含发行 Sun Java System Web Server 6.1 SP4 版本时可用的重要信息,包括关于功能和增强功能、已知的限制和问题、技术说明以及其他资源的提示信息。请在安装和配置软件之前查看发行说明,并在以后定期查看最新信息。
可在以下位置找到完整的 Sun Java System Web Server 6.1 文档:
http://docs.sun.com/db/prod/s1websrv#hic 和
http://docs.sun.com/db/prod/s1websrv#hic?l=zh本发行说明包含以下内容:
功能和增强功能Sun Java System Web Server 具有以下功能和增强功能:
Java Servlet 2.3 和 JavaServer Pages (JSP) 1.2 支持
Sun Java System Web Server 具有 Java 2 Platform, Enterprise Edition (J2EE) 兼容的 Java Servlet 2.3 和 JavaServer Pages (JSP) 1.2 规范的实现。J2EE 兼容的 Web 容器提供了设计和部署符合 Java 技术标准的 Web 应用程序所需的灵活性和可靠性。可以基于每台虚拟服务器来部署 Web 应用程序。
有关这些技术的信息,请访问以下资源:
- Java Servlet
http://java.sun.com/products/servlet/index.html- JavaServer Pages
http://java.sun.com/products/jsp/index.html有关在 Sun Java System Web Server 中开发 Servlet 和 JSP 的信息,请参见《Sun Java System Web Server 6.1 Programmer's Guide to Web Applications》。
J2SE 平台 1.4.2_04 JDK/JRE 支持
Sun Java System Web Server 支持 Java 2 Platform, Standard Edition (J2SE) 1.4.2_04 及更高版本(仅支持 32 位;不支持 64 位)。J2SE 软件与 Web Server 捆绑在一起,并在安装过程中进行安装(如果选择安装该软件)。您也可以在安装 Web Server 之后安装自己的 JDK。如果您打算使用 Administration Server,则必须安装 JDK。
HP-UX 平台
请注意,用于 HP-UX 平台的 Sun Java System Web Server 6.1 包含 JDK 1.4.1。J2SE 平台 1.5.0 JDK/JRE 支持
Sun Java System Web Server 支持在 Solaris、Linux 和 Windows 平台上使用 1.5.0_01-b08 证明的 Java 2 Platform, Standard Edition (J2SE) 1.5.0。
WebDAV 支持
Sun Java System Web Server 支持基于 Web 的分布式创作和版本管理 (WebDAV) 协议,该协议通过以下功能实现协作式 Web 发布:
WebDAV 为内容元数据、名称空间管理和覆盖保护提供了集成的支持。这些技术与许多支持 WebDAV 的设计工具的结合为协作式环境提供了一个理想的开发平台。
NSAPI 过滤器支持
自 6.1 版起,Sun Java System Web Server 扩展了 Netscape 服务器应用程序编程接口 (NSAPI) 以支持 NSAPI 过滤器。
使用过滤器可以自定义 HTTP 请求和响应流的处理,使一个函数可以截取并有可能修改另一个函数提供或生成的内容。例如,某个插件可以安装 NSAPI 过滤器以截取由另一个插件的服务器应用程序函数 (SAF) 生成的 XML 页面,然后将该 XML 页面转换成适用于客户机的 HTML、XHTML 或 WAP 页面。或者,在将从客户机接收到的数据提供给另一个插件之前,NSAPI 过滤器可以对这些数据进行解压缩。
有关详细信息,请参见《Sun Java System Web Server 6.1 NSAPI Programmer's Guide》。
HTTP 压缩支持
Sun Java System Web Server 支持内容压缩,这使您得以提高向客户机传送的速度,并处理更多内容,而不会相应地增加硬件的开支。压缩内容减少了内容的下载时间,对使用拨号连接和高流量连接的用户尤其有用。
有关详细信息,请参见《Sun ONE Web Server 6.1 管理员指南》。
搜索引擎支持
Sun Java System Web Server 支持基于 Java 的搜索引擎,该引擎提供了全文搜索索引和检索功能。该搜索功能允许用户在服务器上搜索文档并在 Web 页面上显示搜索结果。服务器管理员可以根据用户要搜索的文档来创建文档索引,并且可以自定义搜索界面以满足用户的特定需要。
最终用户可用于访问搜索功能的默认 URL 为:
http://<server-instance>:port number/search
示例:
http://plaza:8080/search
最终用户调用此 URL 时,将启动“搜索”(一个 Java Web 应用程序)。
有关执行基本搜索和高级搜索的详细信息(包括关于关键字和可选的查询运算符的信息),请参见搜索引擎的联机帮助。要获得这些信息,请单击“搜索”上的帮助链接。
有关详细信息,请参见《Sun ONE Web Server 6.1 管理员指南》。
增强的安全性
Sun Java System Web Server 允许您使用文本文件验证来限制访问。自 6.1 版起,Sun Java System Web Server 已开始支持 Java Security Manager。默认情况下,安装产品时将禁用 Security Manager,这会显著提高某些类型的应用程序的性能。启用 Security Manager 后,通过对授予 J2EE Web 应用程序的权限做出限制可以提高安全性。要启用 Security Manager,请对 server.xml 文件中的条目“取消注释”:
<JVMOPTIONS>-Djava.security.manager</JVMOPTIONS>
<JVMOPTIONS>-Djava.security.policy=instance_dir/config/server.policy</JVMOPTIONS>其中,instance_dir 是此服务器实例的安装目录的路径。
有关 server.xml 的详细信息,请参见《Sun Java System Web Server 6.1 Administrator's Configuration File Reference》。
JNDI 支持
Sun Java System Web Server 支持 Java 命名和目录接口(Java Naming and Directory Interface,JNDI),后者可以为各种企业命名和目录服务提供无缝连接。
JDBC 支持
Sun Java System Web Server 的出厂配置提供了立即可用的、无缝 Java 数据库连接 (JDBC),同时支持广泛的行业标准 JDBC 驱动程序和自定义 JDBC 驱动程序。
Sun ONE Studio 5 支持
Sun Java System Web Server 支持 Sun ONE Studio 5 Standard Edition。Sun ONE Studio 技术是 Sun 的一种功能强大的、可扩展的集成开发环境 (IDE),适用于 Java 技术开发者。Sun ONE Studio 5 基于 NetBeans 软件并与 Sun ONE 平台集成在一起。(Sun Java System Web Server 6.1 及更高版本也支持 NetBeans 3.5 和 3.5.1。)
在 Sun Java System Web Server 6.1 SP4 支持的所有平台上都可以获得 Sun ONE Studio 支持。用于 Web 服务器的这一插件可以通过以下方式获得:
- Sun Java System Web Server 媒体工具包中的 Companion CD
- 使用 Sun ONE Studio 的 AutoUpdate 功能
- 从以下 Sun Java System Web Server 下载中心获得:
http://wwws.sun.com/software/download/products/3f567f91.html请注意,用于 Sun Java System Web Server 6.1 SP4 的 Sun ONE Studio 5 插件只能与本地 Web Server 结合使用(即与同一台计算机上的 IDE 和 Web Server 结合使用)。
用于 Sun Java System Web Server 的 Sun ONE Studio 5 插件的行为与用于 Sun ONE Application Server 7 的该插件的行为相同。有关在 Sun ONE Studio 5 中使用 Web 应用程序功能的信息,请参见以下教程:
http://developers.sun.com/prodtech/javatools/jsenterprise/learning/tutorials/cdshop.pdf请将 Sun Java System Web Server 6.1 SP4 实例设置为默认设置,然后执行教程中所述的操作。
另请参见位于以下位置的 NetBeans 教程:
http://usersguide.netbeans.org/tutorials/webapps/index.html有关 Sun ONE Studio 5 的详细信息,请访问
http://www.sun.com/software/sundev/jde/要获得其他开发者资源,请参见本发行说明中的“其他 Sun 资源”。
使用 Sun ONE Studio 5 进行调试
如果您要将 IDE 手动附加到在调试模式下启动的远程 Web Server,可以使用 Sun ONE Studio 5 进行“远程调试”。步骤包括:
Active Server Pages 支持
Sun Java System Web Server 6.1 SP4 通过 Sun ONE Active Server Pages 4.0.1 版(以前称作 Sun Chili!Soft ASP)支持 Active Server Pages 3.0 规范。Sun ONE Active Server Pages 向 Sun Java System Web Server 添加了安全的企业级 Active Server Pages 引擎。
Sun Java System Web Server 6.1 SP4 在以下平台上支持 Sun ONE Active Server Pages 4.0.1:
将 Sun ONE Active Server Pages 安装到 Sun Java System Web Server 时不需要许可证。如果您购买了 Sun Java System Web Server 媒体工具包,可以从 Companion CD 获得 Sun ONE Active Server Pages 安装程序,也可以从以下位置下载:
http://wwws.sun.com/software/chilisoft/index.html请注意以下事项:
有关 Sun ONE Active Server Pages 的详细信息,请访问上面列出的 URL。
PHP 兼容性
PHP 是由 The PHP Group (http://www.php.net/) 提供的一种常用页面脚本语言。通过一种支持的 API(CGI、NSAPI 或 FastCGI〕,可以与 Sun Java System Web Server 一起使用 The PHP Group。The PHP Group 在其 Web 站点上提供了有关配置 PHP 软件以使用任何一种支持的 API(共三种〕的详细说明。
CGI API 是可以使用的最稳定的接口,但会受 CGI 中固有的性能限制的影响。
NSAPI 使用 Sun Java System Web Server 的本地 API 在 Web Server 的内存中运行 PHP 软件。此配置将提供最佳的性能,但是如果使用了对线程来说不安全的 PHP 模块,则将存在服务器崩溃的风险。
FastCGI 接口通过使 PHP 软件在处理请求后保持运行状态,同时在 Web Server 的内存之外继续运行,从而兼顾了性能和稳定性。如果使用了不稳定的 PHP 模块,将不会导致 Web Server 崩溃。因此,Sun 建议将 FastCGI 接口与 PHP 软件一起使用。
通过安装 FastCGI 附加软件,可使 Web Server 支持 FastCGI 接口。该附加软件可从以下位置获得:http://www.sun.com/download/products.xml?id=3f567f91
有关安装和配置 FastCGI 附加软件的详细信息,请参阅位于以下位置的 FastCGI 附加软件文档:http://docs.sun.com/source/819-1809/fcgi61.html
请注意,PHP 软件使用两个环境变量来控制作为 FastCGI 进程运行的 PHP 进程的生命周期。PHP_FCGI_CHILDREN 用于确定将为响应请求而创建的 PHP 进程的数目。PHP_FCGI_MAX_REQUESTS 用于确定 PHP 进程在自行终止并被新的 PHP 进程替换之前可以响应的请求数目。Sun 建议您不要使用 PHP_FCGI_CHILDREN,而应使用 FastCGI 附加软件配置参数 min-procs 来控制 PHP 进程的最小数目。
NSS 3.9.5 和 NSPR 4.5.1 支持
Sun Java System Web Server 6.1 SP4 中的 NSS 支持已从 3.3.10(在版本 6.1 SP3 中)升级到 3.9.5。 NSS 是一组库,可支持启用了安全性的服务器应用程序的跨平台开发。Sun Java System Web Server 6.1 SP4 还支持 NSPR 4.5.1。
增强的硬件加速器加密支持
Sun Java System Web Server 提供了对 Sun Crypto Accelerator 4000(一种加密的加速器板,可以增强 Web Server 上 SSL 的性能)的硬件加速器支持。
支持的平台Sun Java System Web Server 6.1 SP4 可以安装在 Solaris、HP-UX、AIX、Linux 和 Windows 平台上。下表概述了支持的平台。有关安装要求的详细信息,请参见本发行说明中的“必需的修补程序”和《Sun Java System Web Server 6.1 安装和迁移指南》中的第 2 章。
注:仅在 PA-RISC 平台上支持 HP-UX 11i。
*自 iPlanet Web Server 6.0 起,不支持较早的 SPARC CPU。Sun Java System Web Server 6.1 仍然支持 UltraSPARC 体系结构。
***目前不支持以下 Linux 操作系统,并且 Sun Java System Web Server 6.0 产品的“下一个”发行版将不再支持此操作系统:
- Sun Linux 5.0
请执行必要的操作以将您的 Web Server 移动或迁移至支持的操作系统。
必需的修补程序建议您使用最新的可用修补程序来更新您的操作系统。下面按平台列出了必需的修补程序。
Solaris 的修补程序
Solaris 用户必须安装 Sun 建议的修补程序群集,该群集可以从以下站点的 "Recommended and Security Patches" 部分获得:http://sunsolve.sun.com
Solaris 8 (SPARC)
- Solaris 8 Update 7
- Sun 建议的最新推荐安全修补程序群集。
Solaris 9(SPARC 和 x86)
- Solaris 9 Update 4 或更高版本。
- Sun 建议的最新推荐安全修补程序群集。
HP-UX 的修补程序
对于使用 Sun Java System Web Server 6.1 SP4,以下修补程序是必需的:
HP-UX 11i
注:仅在 PA-RISC 平台上支持 HP-UX 11i。
- HP-UX 11i 操作环境组件 B.11.11.0203
- 用于 lli 的必需的修补程序包,2003 年 6 月发布——B.11.11.0306.1
- 用于 HP-UX 11i 的 Gold Base 修补程序,2003 年 6 月发布——B.11.11.0306.4
- 用于 HP-UX 11i 的 Gold Application 修补程序,2003 年 6 月发布——B.11.11.0306.4
- Pthread 增强功能和修复程序——PHCO_29109
- Pthread.h 修复程序和新的增强功能——PHCO_27633
- libc 手册页累积修补程序——PHCO_29328
- libc 累积修补程序——PHCO_29495
- Java Out-of-Box——JAVAOOB, 1.0.00.02
Java Out-of-Box 工具用于配置必要的内核可调参数。建议使用此工具修改内核值。如果有必要,请修改以下可调参数,使它们的值等于或大于下列值:
注意:修改内核可调参数可能会对系统产生不良影响。除非您完全了解所作修改产生的影响,否则请勿修改这些参数。
AIX 的修补程序
对于使用 Sun Java System Web Server 6.1 SP4,以下修补程序是必需的:
AIX 5.1
AIX 5.2
如果在 Web Server 上部署了 Java Web 应用程序,则根据 IBM JDK 文档的说明,启动服务器之前必须将以下环境变量设置为下面指定的值:
可以将上述内容直接添加至 Web Server 的启动脚本中。
安装、升级和迁移说明本节包括有关安装、升级和迁移 Sun Java System Web Server 的说明。有关这些主题的详细信息,请参见《Sun Java System Web Server 6.1 安装和迁移指南》中的信息。该指南中有关 Sun Java System Web Server 6.1 的信息也适用于 Sun Java System Web Server 6.1 SP4。有关此 Sun Java System Web Server 发行版中的已知问题,请参见本发行说明中的 “已知问题”。
安装
不要将 Web Server 安装到名称包含空格的目录中。
有一点需要特别注意,如果将 Web Server 安装到名称包含空格的目录(例如 Program Files)中,Web Server 将无法启动。您在安装过程中不会收到关于此问题的错误消息,但是在安装后,服务器将不启动。Web Server 不能安装在没有 compat-libstdc++ 的 RHLAS 3.0 上
未安装 compat-libstdc++ 就不能安装 Web Server。升级
在现有安装的 Sun Java System Web Server 上安装 Sun Java System Web Server 6.1 SP4 时,安装程序将自动检测并执行升级。
如果已安装 Sun ONE Web Server 6.1 SP1,请将 6.1 SP4 安装程序指向安装 6.1 SP1 的位置,然后再进行升级。如果系统中安装了 Sun Java Enterprise System 1,并且您要将 Sun Java Enterprise System 1 的一部分 Sun ONE Web Server 6.1 升级到 Sun Java System Web Server 6.1 SP4,请参阅以下文档:http://docs.sun.com/source/817-7056/upgrading.html#wp467664
迁移
不支持从 4.1 版以下的 iPlanet Web Server 直接迁移到 Sun Java System Web Server 6.1 SP4。必须首先将传统服务器迁移到 iPlanet Web Server 4.1,然后再迁移到 Sun Java System Web Server 6.1 SP4。
有关迁移的详细信息,请参见《Sun Java System Web Server 6.1 安装和迁移指南》。该指南包含有关从版本 4.1 迁移到 6.1 SP4 以及从版本 6.0 迁移到 6.1 SP4 的信息。再次说明,该指南中有关 Sun Java System Web Server 6.1 的信息也适用于 Sun Java System Web Server 6.1 SP4。
产品文档Sun Java System Web Server 包括一整套产品文档,可以从以下位置获得:
http://docs.sun.com/db/prod/s1websrv#hic 和
http://docs.sun.com/db/prod/s1websrv#hic?l=zhSun Java System Web Server 手册以 PDF 和 HTML 格式作为联机文件提供。该文档中有关 Sun Java System Web Server 6.1 的信息也适用于 Sun Java System Web Server 6.1 SP4。下表列出了每本手册中介绍的任务和概念。
已解决的问题本节列出了在以下版本中已解决的最重要问题:
已在 6.1 SP4 中解决的问题
下表列出了已在 Sun Java System Web Server 6.1 SP4 中解决的问题。
表 3 已在 Sun Java System Web Server 6.1 SP4 中解决的问题
问题 ID 描述
6021153
必需的 ID 为 112396-03 的修补程序不存在。
在早期发行说明中列为“必需”的修补程序 112396-03 不正确。仅存在修补程序 112396-02,该修补程序修复了错误 ID 为 4498984 的错误(对于某些旧版本的操作系统 patchadd 命令,*fgrep* 失败并显示 "wordlist too large")。
正确的修补程序号为:112396-02。
Solaris 用户必须安装 Sun 建议的修补程序群集,该群集可以从以下站点的 "Recommended and Security Patches" 部分获得:http://sunsolve.sun.com
Solaris 8 (SPARC)
- Solaris 8 Update 7
- Sun 建议的最新推荐安全修补程序群集。
Solaris 9(SPARC 和 x86)
- Solaris 9 Update 4 或更高版本。
- Sun 建议的最新推荐安全修补程序群集。
6066252
带有 AKI 扩展名的客户机证书导致 SEC_ERROR_UNKNOWN_ISSUER 错误。
6092498
如果客户机证书包含捷克语字符,SJWS 6.1 无法使用 LDAP 验证该客户机证书。
6171311
在 JDK 1.5 环境中运行 Web Server 时经常遇到错误。
6171784
由于某个日志记录配置错误,Web Server 性能出现问题。
4925875
国际化(韩文):使用带星号的韩文进行搜索时,返回结果为空。
6171950
sun-web.xml 中含有 reload-interval 参数时,经过预编译的 JSP 未按预期运行。
解决方法
使用属性 "use-precompiled"(在 sun-web.xml 中的 jsp-config 下将其设置为 "true")来指定 JSP 已经过预编译并且不需要在运行时对其进行编译。
sun-web.xml 样例
<sun-web-app>
<session-config>
<session-manager/>
</session-config>
<jsp-config>
<property name="use-precompiled" value="true" />
</jsp-config>
</sun-web-app>
5048940
从 SP1 升级后,无法访问管理 UI 中的 "Superuser Access Control" 页面。
6177544
通过 RPM 安装插件后,libpassthrough.so 不存在。
6176231
使用 NSS 3.9.3 beta 时,Sun Java System Web Server 6.1 SP4 的管理删除证书 (bin/https/admin/security) 发生核心转储。
6173365
对 Solaris SPARC/x86 的 Web Server 的同一内部版本使用了多个软件包安装程序。
5039633
将 NSS 更新到 3.9 系列。
5063134
J2SE 定位未使用 Java ES 符号链接。
6067407
使用 ACL_LDAPSessionFree() 时出现问题。
6173293
如果设置了 Servlet 过滤器,则 Web Server 始终将内容类型设置为 text/html。
6176264
Web Server 6.1 SP4 Solaris x86 无法通过管理 GUI 启动 SSL 实例。
6180677
适用于 JES3 的 Web Server SP4 无法从适用于 JES2 的 Web Server SP2 上进行升级。
6066139
JSTLTCK——当在 JDK1.5_beta2 版本环境中运行 Web Server 时,16 个测试失败。
6088595
在 JDK 1.5.0_beta2 环境中创建或编辑类时,Admin 抛出异常。
4904913
国际化搜索:使用带 "?" 通配符的日文进行搜索时,出现匹配错误。
已在 6.1 SP3 中解决的问题
下表列出了已在 Sun Java System Web Server 6.1 SP3 中解决的问题。
已在 6.1 SP2 中解决的问题
下表列出了已在 Sun Java System Web Server 6.1 SP2 中解决的问题。
已在 6.1 SP1 中解决的问题
下表列出了已在 Sun Java System Web Server 6.1 SP1 中解决的问题。
表 6 已在 Sun Java System Web Server 6.1 SP1 中解决的问题
问题 ID 描述
4642650
需要使用特定选项以禁止在 Servlet/JSP 容器中附加绝对 URL。
有关修复的详细信息
已在 sun-web.xml 中添加了新属性:relativeRedirectAllowed
默认值:false
描述:如果设置为 true,则将允许 Web 应用程序使用 HttpServletResponse.sendRedirect() API 向客户机发送相对 URL(即,该设置将阻止容器将相对 URL 转换成全限定 URL)。4793938
从 Server Manager 用户界面中启用远程文件操作将允许任何远程用户获得服务器 URI 空间中的任何目录的列表。
4904201
添加未捆绑 JDK 的服务器时,javahome 路径设置错误。
4911580
添加新服务器实例可能失败,并显示服务器错误消息。
4928794
尝试通过 PUT 创建空资源时,服务器重新启动。
4929913
搜索引擎无法提取 PDF 文件中的 FTS 信息并为其编制索引。
有关修复的详细信息
此修复方法适用于除 Linux 以外所有支持的平台。始终可以为 Author、Subject 和 Keywords 元标记编制索引。添加的功能现在允许为任意元标记(包括那些从 PDF 文件转换 FTS_* 属性时产生的元标记)编制索引。需要按照下面的说明在 server.xml 中手动配置一项新的设置。
- 在 server.xml 的 SEARCH 部分中,添加一个内容为 name="indexMetatags" 的 PROPERTY。其值应当是以逗号分隔的元标记名称的列表(请注意,不管该设置如何,将始终为 Author、Subject 和 Keywords 元标记编制索引)。
- 要为 PDF 文件和其他类型文档在转换时产生的元标记编制索引,此配置必须使用元标记的名称,而不是特定文档类型中“字段”的名称。例如,要为 PDF 文件的 FTS_Title 内容编制索引,则 "Title" 必须是 "indexMetatags" 设置的一部分:
<PROPERTY name="indexMetatags" value="Title"/>注:有关在搜索结果中显示自定义元标记信息的详细信息,请参见“搜索”一节中的问题 4956415。
4933935
在 Solaris 9 上:Reconfig 在基于软件包的安装中不起作用。
4945089
SSL 中的 ASN.1 解析问题。
在实现 Web Server 使用的 SSL 协议时,会出现一个可被用作“拒绝服务”攻击的问题。Sun Java System Web Server 6.1 SP1 中解决了此问题。如果您使用 Web Server 来托管使用 SSL 版本 3 或 TLS 的站点,强烈建议您安装此服务包。
4950388
"reconfig" 命令在 Windows XP 上不起作用。
4964069
commit.exe 实用程序在 Windows 平台上崩溃。
已在 6.1 中解决的问题
下表列出了已在 Sun Java System Web Server 6.1 中解决的问题。
已知问题本节列出了在 Sun Java System Web Server 6.1 SP4 发行时已知的重要问题和限制。这些问题包括以下几类:
一般问题
下表列出了一般的已知问题。
管理
下表列出了管理方面的已知问题。
表 9 管理方面的已知问题
问题 ID 描述
6197731
访问 Admin Server 时出现内部错误。
解决方法:如果在已安装 Directory Server(版本 5.2 Patch 3 或更低版本)的 Windows 计算机上安装了 Web Server 6.1 SP4,您可能会在使用 Web Server Admin Server 时遇到问题。建议将 Web Server 和 Directory Server 分别安装到不同的计算机上,以避免遇到此类问题。此问题只会在 Windows 平台上出现。
6021151
使用 HttpServerAdmin 创建包含 LDAP DN(含有逗号)的 JNDI 资源时出现问题。
解决方法:
对于 HttpServerAdmin,要将属性中的 "," 进行换码,请使用 "\\" 作为换码符(在 Windows 平台中使用 "\")。在属性
java.naming.provider.url=ldap://localhost:389/ou=loggingQueues,ou=tms,ou=services,ou=abc
中,"," 按以下所示进行换码:
-property java.naming.provider.url=ldap://localhost:389/ou=loggingQueues\\,ou=tms\\,ou=services\\,ou=abc
5007892
dist-admin:ACL 删除没有彻底清除对象。
解决方法:
注释掉 https-admserv 的 NameTrans:
#NameTrans fn="assign-name" name="https-admserv" from="/https-admserv/*"
5035129
仅在 RHLAS 3.0 上使用 WS 6.1 SP2 Admin 无法管理 DS 用户/组/组织单元。
4650456
View Access 和 View Error 无法正确地与多字节字符结合使用。
4652585
启用分布式管理后,本地管理用户被禁用
解决方法
在分布式管理组内创建一个使用默认管理用户名的用户。请注意,新创建的 LDAP 管理用户必须与 Web Server 管理用户具有相同的密码。
4725683
日志文件的日期戳没有考虑本地时区,显示的日期不正确。
解决方法
如果日志文件文件扩展名中的日期应当与日志条目本身的日期匹配,请将服务器配置为在 23:59(每天最后)旋转日志文件。4761960
在版本 6.0 SP4 中,使用 SASL 和匿名绑定时无法启用分布式管理。
解决方法
对于启用了 SSL 的目录服务器不使用匿名绑定。4841310
通过
.htaccess
进行验证时,无法获得REMOTE_USER
变量。解决方法
如果启用了 .htaccess 文件,服务器在提供资源之前将检查 .htaccess 文件。服务器在与资源相同的目录及其父目录,直到包含文档根的目录中查找 .htaccess 文件。例如,如果主文档目录设置为 /sun/server/docs,并且客户机请求 /sun/server/docs/reports/index.html,则服务器将在 /sun/server/docs/reports/.htaccess 和 /sun/server/docs/.htaccess 查找 .htaccess 文件。请注意,服务器的附加文档目录和 CGI 目录功能使管理员可以定义替代文档根。替代文档根的存在会影响 .htaccess 文件的处理。例如,假定服务器的主文档目录设置为 /sun/server/docs,并且 CGI 程序位于 /sun/server/docs/cgi-bin/program.cgi。如果启用 CGI 作为文件类型,则当客户机发出对 CGI 程序的请求时,服务器对 /sun/server/docs/.htaccess 和 /sun/server/docs/cgi-bin/.htaccess 的内容都要进行评估。但是,如果您选择在 /sun/server/docs/cgi-bin 配置 CGI 目录,服务器将只检查 /sun/server/docs/cgi-bin/.htaccess,而不检查 /sun/server/docs/.htaccess。出现这种情况的原因是:将 /sun/server/docs/cgi-bin 指定为 CGI 目录便将其标记为替代文档根。
4865295
不再支持最终用户管理功能(位于管理界面中 "Distributed Administration" 下)。
4882999
管理用户界面中页面的外观不一致。
4888696
在 Netscape 7.0 中,如果未在管理用户界面的 "Add Server" 页面中输入足够的信息,该页面将“消失”。
解决方法
单击 "OK" 之前,在 "Add Server" 页面中输入完整信息。如果有必要,可以重新装入该页面以恢复 "Add Server" 用户界面,也可以先单击另一个页面或选项卡,然后再返回到 "Add Server" 页面。这个问题仅出现在 Netscape 7.0 中。4910309
警报信息的单词 "null" 显示不正确。
在 Virtual Server Manager 中编辑 "Virtual Server" 页面的 "Pick Directory" 中的目录服务时,会发生此问题。
4905808
超级用户在启用分布式管理后无法访问管理界面。
解决方法
启用分布式管理后,在 LDAP 中创建一个管理用户名和密码与“超级用户”相同的用户。4908694
日志设置的默认链接无法使用。
"Virtual Server" 页面的 "Logging Settings" 上的 "Default" 链接未设置默认路径,而是相当于重置按钮。
4910197
编辑 JDBC 资源时,删除值之后属性页面中仍保留这些值。
4911552
在不应该解析的情况下解析 .shtml 文件。
此问题发生在 Class Manager 中 "Content Management" 选项卡上的 "Parse HTML" 页面。即使将此页面上的设置配置为不进行解析,也将对 .shtml 文件进行解析。例如,如果只是指定 "Yes, with exec tag" 和 "All HTML files",仍将对 .shtml 文件进行解析。
无 ID
Web Server 捆绑的 sun-web.xml 文件指向了错误的 DTD 位置。
正确的位置是:
http://www.sun.com/software/dtd/webserver/sun-web-app_2_3-1.dtd
内核
下表列出了内核方面的已知问题。
文档和联机帮助
下表列出了文档和联机帮助方面的已知问题。
表 11 文档方面的已知问题
问题 ID 描述
6173273
管理员指南中说明支持的 Java 版本为 "1.4.1_03",该说明是不正确的。
6173272
管理员指南中说明支持的 Java 版本为 "1.4.1_03",该说明是不正确的。
Sun Java System Web Server 支持 Java 2 Platform, Standard Edition (J2SE) 1.4.2_04 及更高版本(仅支持 32 位;不支持 64 位)。J2SE 软件与 Web Server 捆绑在一起,并在安装过程中进行安装(如果选择安装该软件)。您也可以在安装 Web Server 之后安装自己的 JDK。如果您打算使用 Administration Server,则必须安装 JDK。
6173274
管理员指南中第 18 章“使用搜索”的“高级搜索”部分所介绍的 "Find" 菜单中的 "Passage Search" 选项是无效的。此菜单选项不可用。
4898077
启用 SSL,HttpServerAdmin 和 iWS 控制台之间的行为不一致。
5056989
应使用新的属性信息更新《Sun ONE Web Server 6.1 Programmer's guide to Web Applications》中的下列各表(有关参考,请参见 SP3 的已解决问题中的错误 5056989)。
《Sun ONE Web Server 6.1 Programmer's Guide to Web Applications》-> "Session Managers"
- Table 4-4 manager-properties Properties for StandardManager
- Table 4-5 manager-properties Properties for PersistentManager
- Table 4-6 manager-properties Properties for IWSSessionManager
《Sun ONE Web Server 6.1 Programmer's Guide to Web Applications》-> "Deploying Web Applications" -> "Elements in the sun-web.xml File"
- Table 6-15 manager-properties Properties
应使用新属性 "prefixSessionIDWithHostName" 将上述 4 个表全部更新。
此新属性的值如下所示:
- 属性名:prefixSessionIDWithHostname
- 默认值:false
- 描述:通知会话管理器为 Web 应用程序在会话 ID 中(比如在 6.0SPx 中)启用前缀主机名。当该值为默认值 "false" 时,会话 ID 将不使用主机名作为其前缀。
4849907
联机帮助 shtml 管理页面应显示以下信息:
Files with the execute bit and the extension .html or .htm instead of Files with the execute bit and the extension .shtml.
4684775
默认情况下,禁用 Async DNS:Administrators Configuration File Reference 需要附加信息。
Windows 上不支持 AsyncDNS。
Administrators Configuration File Reference 中有三 (3) 部分需要更新。包含在圆括号内的内容应为 "Specifies whether Asynchronous DNS is allowed"。 首先,在 "DNS Lookup - AsyncDNS" 部分中:
指定是否允许使用异步 DNS。(此指令被忽略。即使将值设置为 "on",服务器也不执行异步 DNS 查找。)
在附录 A 中:Configuration Changes Between iPlanet Web Server 4.1 and Sun ONE Web Server 6.1 (Table A-1):
AsyncDNS AsyncDNS (忽略。即使将值设置为 "on",服务器也不执行异步 DNS 查找。)在附录 A 中:Configuration Changes Between iPlanet Web Server 6.0 and Sun ONE Web Server 6.1 (Table B-2):
AsyncDNS AsyncDNS (忽略。即使将值设置为 "on",服务器也不执行异步 DNS 查找。)5019026
本地化问题:许多二级联机帮助屏幕仅以英文显示。
已本地化的联机帮助文件内部引用 manual/https/ag/
下的许多文件,这些文件尚未本地化。 4657465
encodeCookies
属性 Web App Programmer's Guide默认情况下,在将 Cookie 发送到客户机之前,Sun ONE Web Server URL 将对其进行编码。如果不需要对 Cookie 进行编码,请将以下内容添加到 sun-web.xml 中:
<property name="encodeCookies" value="false"/>
对于上述示例,请直接将其添加在 <sun-web-app> 标记之下;请勿将其嵌入任何其他标记。此标志的默认值为 "true"。
5029460
管理员指南的 certmap.conf 描述中的错误。
管理员指南的
certmap.conf
描述中包含以下文本:第一行用于指定项的名称以及形成 CA 证书中独特的名称的属性。该名称是任意的,您可以将其定义为所需的任何名称。但是,
issuerDN
必须与颁发客户机证书的 CA 的签发者 DN 完全匹配。例如,以下两个issuerDN
行仅在分隔属性的空格上有所差异,但服务器将其视为两个不同的项:
certmap sun1 ou=Sun Certificate Authority,o=Sun, c=US
certmap sun2 ou=Sun Certificate Authority,o=Sun, c=US请注意两个 DN 是相同的。应当将这两行更改为以下内容:
certmap sun1 ou=Sun Certificate Authority,o=Sun, c=US
certmap sun2 ou=Sun Certificate Authority, o=Sun, c=US5031366
联机版本的管理员指南中的无效链接。
Sun 文档站点超级链接不起作用。URL 中有一个多余的空格。正确的链接为:http://www.sun.com
4909738
文档错误。
在 Magnus Editor 中,LogVerbose 和 LogVsId 在设置为 "On"(替代 server.xml 文件中 LOG 元素的 loglevel 和 logvsid 属性)时被忽略。
4911551
联机帮助中缺少默认式样的文档(Class Manager 中的 "Styles" 选项卡)。
Sun Java System Web Server 包括下面列出的默认式样。这些式样是在 obj.conf 文件中创建的默认对象。当您开始自定义您的服务器配置后,式样列表将发生更改(添加一些新式样,删除一些式样等等)。默认式样包括:
有关默认式样的问题,请参见本发行说明中“管理”一节的问题 4911550。
安装
下表列出了安装方面的已知问题。
迁移
下表列出了迁移方面的已知问题。
表 13 迁移方面的已知问题
问题 ID 描述
4790457
无法更改从 4.1 迁移的服务器的文档根目录。
解决方法:
手动编辑迁移的实例的 obj.conf 和 server.xml。这些文件位于<code><SERVER_ROOT>/<HTTPS-INSTANCE>/config
目录下。在
obj.conf
中,将行:
更改为NameTrans fn=document-root root="<existing_doc_root>"
NameTrans fn=document-root root="$docroot"
在
server.xml
中的相应VSCLASS
下,将行:
更改为<PROPERTY name="docroot" value="<existing_doc_root>"/>
<PROPERTY name="docroot" value="<new_doc_root>"/>
5042600
无法将 Web Server 6.0 SP7 实例迁移到 Web Server 6.1 SP2。
解决方法:
要解决此问题,请执行以下步骤:(1) 转至 <webserver root directory>/bin/https/admin/bin 目录。
(2) 制作 import60 的备份副本。
(3) 在编辑器中打开 import60。
(4) 转至行 65,您将看到以下条目:
if ($idnum != 0) {
$validuser = 1;
} else {
$validuser = 0;
}
(5) 删除这 5 行并替换为以下代码:
if ($idnum == 0 && $cgiVars{'user'} ne "root") {
$validuser = 0;
} else {
$validuser = 1;
}
(6) 保存文件。然后尝试进行迁移。
6213097
在 Sun Java Enterprise System 3 (JES3) 上没有正确迁移 ktsearch.jar。
解决方法
手动编辑迁移实例的 server.xml 文件,使其指向正确的路径。对于 Linux,正确路径为:/opt/sun/private/share/lib/ktsearch.jar
对于 Solaris Sparc,正确路径为:/usr/share/lib/ktsearch.jar
5007081
从 6.0 迁移到 6.1 过程中,Web 应用程序文件状态被忽略
server.xml
文件中定义在文件级别的 Web 应用程序状态未被迁移。如果用户已关闭 Web 应用程序文件状态以对其进行抑制,则迁移时这些应用程序将被公开。解决方法:
编辑迁移实例的 server.xml 文件并关闭各 Web 应用程序的状态。4988156
如果要将作为 Sun Java Enterprise System (JES) 的一部分安装的 Sun Java System Web Server 6.1 升级到最新的 Service Pack,您需要下载并应用相关修补程序。有关详细信息,请参阅位于以下位置的 JES 3 迁移和升级指南:http://docs.sun.com/app/docs/doc/819-2237。
样例
下表列出了样例应用程序方面的已知问题。请注意,这些问题不会影响样例应用程序正常执行功能。
表 14 样例方面的已知问题
问题 ID 描述
5014039
由于 web.xml 中的 <distributable> 标记而导致简单 JSP 抛出异常
解决方法:
从 simple/src 目录下的 web.xml 中删除标记 <distributable></distributable>。重新部署 Web 应用程序。无 ID
rmi-iiop 样例中缺少一个步骤。
在“部署样例应用程序”一节中,执行 "ant deploy" 命令(步骤 2)后,重新启动 Web 服务器实例。
注:Ant 是基于 Java 的生成工具,必须从 Apache 的 http://ant.apache.org 下载。另请参见 <install_root>/plugins/java/samples/docs/ant.html 中提供的信息。
无 ID
jdbcrealm 样例中 Oracle 驱动程序的名称不正确。
在“编译和汇编样例应用程序”一节的步骤 2b 中,将以下内容:
<PROPERTY name="dbdrivername" value="oracle.jdbc.pool.OracleDataSource"/>
更改为:
<PROPERTY name="dbdrivername" value="oracle.jdbc.driver.OracleDriver"/>
搜索
下表列出了搜索方面的已知问题。
安全性
下表列出了安全性方面的已知问题。
表 16 安全性方面的已知问题
问题 ID 描述
4898077
启用 SSL,HttpServerAdmin 和 iWS 控制台之间的行为不一致。
解决方法:
使用以下语法:
HttpServerAdmin create -l -id <id> -ip <ip> -port <port> -sname serverName -defaultvs <defaultvs> [-cert <certificate name>] [-sec <on|off>] [-acct <#accthreads>] -d server_root -sinst http_instance
注:对于 -sec 选项,请勿使用 "true|false"、"1|0" 或 "yes|no",而应使用 "on|off"。
4671445
如果需要进行 LDAP 客户机验证,则 Sun Java System Web Server 无法通过 SSL 连接到 LDAP。
如果 Sun Java System Web Server 与需要客户机验证的 LDAP 服务器联系(在这种情况下 Web Server 是客户机),则无法发送 Web Server 的证书,访问将失败。
4863599
在不同的组织单元中不能使用相同的组名称。
如果使用相同的组名称,并尝试通过组名称来限制访问,则当客户机尝试访问站点时,Sun Java System Web Server 会返回一个错误。
解决方法
每个组织单元使用不同的组名称。4963468
在某些情况下,"list" 权限对目录列表不起作用。
按照《Sun ONE Web Server 6.1 管理员指南》第 9 章中的“设置访问权限”一节的说明,必须有 "list" 权限才能从不包含索引文件的目录中获得目录列表。但是,在某些情况下,即使适用的 ACL 拒绝 list 权限,也可能获得目录列表。因此,如果需要限制对目录编制索引,建议您通过禁用索引编制(如《Sun ONE Web Server 6.1 管理员指南》第 16 章的“选择目录索引”一节所述)或在拒绝 list 权限的同时禁用索引编制来实现,而不是仅通过拒绝 list 权限来实现。
工具
下表列出了工具方面的已知问题。
Web 容器
下表列出了 Web 容器方面的已知问题。
表 18 Web 容器方面的已知问题
问题 ID 描述
4903162
Windows 上与 url-patterns 的大小写相关的问题。
按照 Servlet 规范,web.xml 中的 url-pattern 元素是区分大小写的。这可能使 Windows 用户获得意外的结果(例如,客户机请求 index.HTML 时,实际是认为此文件等同于 index.html)。
WebDAV
下表列出了 WebDAV 方面的已知问题。
如何报告问题和提供反馈如果您在使用 Sun Java System Web Server 6.1 SP4 期间遇到问题,请通过以下方式与 Sun 客户支持部门联系:
- 联机的 Sun 软件支持服务:
http://www.sun.com/service/sunone/software- 随维护合同一起分发的电话号码
为了便于我们更好地帮助您解决问题,当您联系客户支持部门时请提供以下信息:
Sun 欢迎您提出意见
Sun 致力于提高其文档的质量,并十分乐意收到您的意见和建议。请使用以下网址上的 "Send comments" 链接将您的意见发送给 Sun:http://docs.sun.com/
请在您的意见中注明标识信息,例如书的文件号码和标题。在您提出意见时,可能需要在表单中输入英文版书名和文件号码,本书的英文版文件号码和书名为:819-0290,《Release Notes for Sun Java System Web Server 6.1 2005Q1 SP4》。
其他 Sun 资源在以下位置可以找到有关 Sun Java System 的有用信息:
- Sun Java System Web Server 6.1 和 Service Pack 文档
http://docs.sun.com/db/coll/WebServer_05q1 和
http://docs.sun.com/db/coll/WebServer_05q1_zh- Sun 软件产品和服务
http://www.sun.com/software- Sun 开发者信息
http://developers.sun.com/- Sun 开发者支持服务
http://developers.sun.com/prodtech/support/- Sun 支持和培训服务
http://www.sun.com/supportraining
版权所有 © 2005 Sun Microsystems, Inc. 保留所有权利。对于本文档中介绍的产品,Sun Microsystems, Inc. 对其所涉及的技术拥有相关的知识产权。需特别指出的是(但不局限于此),这些知识产权可能包含在 http://www.sun.com/patents 中列出的一项或多项美国专利,以及在美国和其他国家/地区申请的一项或多项其他专利或待批专利。SUN 专有/机密。美国政府权利——商业软件。政府用户应遵循 Sun Microsystems, Inc. 的标准许可协议,以及 FAR(Federal Acquisition Regulations,即“联邦政府采购法规”)的适用条款及其补充条款。必须依据许可证条款使用。本发行版可能包含由第三方开发的内容。本产品的某些部分可能是从 Berkeley BSD 系统衍生出来的,并获得了加利福尼亚大学的许可。Sun、Sun Microsystems、Sun 徽标、Java 和 Solaris 是 Sun Microsystems, Inc. 在美国和其他国家/地区的商标或注册商标。所有 SPARC 商标的使用均已获得许可,它们是 SPARC International, Inc. 在美国和其他国家/地区的商标或注册商标。