test

Sun Java System Web Server 6.1 2006Q2 SP6 发行说明

文档和联机帮助

下表列出了文档和联机帮助方面的已知问题。

表 14 文档方面的已知问题

问题 ID 

描述 

6378473 

6378423 

《Release Notes for Sun Java System Web Server 6.1 Add-Ons Reverse Proxy Plugin》包含错误的 validate-server-cert SAF 默认值。

更正：默认值为 true。

6367812 

联机帮助未介绍重新启动 schedulerd 的步骤。

附加信息：要从命令行启动 schedulerd，请通过以下这些步骤设置 ADMSERV_ROOT 环境变量：

  1. 运行 ADMSERV_ROOT=$SERVER_ROOT/https-admserv/config

  2. 导出 ADMSERV_ROOT

  3. 转到 $SERVER_ROOT/bin/https/bin 目录

  4. 运行 ./schedulerd -d <server_root>

4957123 

管理员指南未介绍搜索查询运算符。

6391505 

5059527 

安装和迁移指南应介绍配置文件的可写性、超级用户安全性风险和 Solaris net_privaddr 权限。

附加信息：

  • 通常，只有超级用户可以绑定到 <= 1024 的端口。但是，为了提高安全性，您应禁止以超级用户身份运行实例。

  • 您可以将实例配置为以其他用户身份运行。默认情况下，实例的配置文件可由有权运行实例的用户来编写。这表示非超级用户可以修改实例的配置文件，从而获得超级用户访问权限。

  • 因此，为了进一步提高安全性，您应避免以超级用户身份启动实例。

  • Solaris 提供 net_privaddr 权限以允许特定非超级用户绑定到 < 1024 的端口。使用此权限表示即使实例绑定到 < 1024 的端口，也可以由非超级用户来启动。

6359385 

Administrator's Configuration File Reference 应介绍 64 位服务器的 magnus.conf 变量 MaxKeepAliveConnections 值的范围。

附加信息：对于 64 位服务器，magnus.conf MaxKeepAliveConnections 指令值范围为 0 到 1048576。

6358849 

Administrator's Configuration File Reference 应介绍 nsfc.conf 配置文件中的 MaxOpenFiles 属性。

附加信息：MaxOpenFiles 属性的详细信息如下：

  • 属性：MaxOpenFiles

  • 默认值：1024

  • 描述：对打开的高速缓存文件描述符数目的限制。

4964908 

没有可用的关于功能升级的文档。 

5065188 

6173274 

管理员指南的“高级搜索”部分中对 "Find" 菜单中的 "Passage Search" 选项的介绍是错误的。此菜单选项不可用。

6155266 

管理员指南对配置日志级别的介绍是错误的。

更正：应按如下所示定义 Web Server 配置级别：

Message indicate a misconfiguration

6206074 

Administrator's Configuration File Reference 中介绍的 ChildRestartCallback 指令的默认值不正确。

更正：默认值为 no directive。

6170766 

安装和迁移指南中的“安装 Sun One Web Server 之前”部分介绍的新版 Web Server 的升级方法不正确。

更正：要升级作为 Sun Java Enterprise System 1 的一部分的 Sun One Web Server 6.1，请使用 patchadd。

6170769 

Administrator's Configuration File Reference 中介绍的关于 AdminLanguage 指令的信息不正确。

更正：AdminLanguage 指令仅适用于日志消息中显示的语言，而不适用于 GUI。

6173273 

管理员指南中的“选择 MIME 类型”部分中有一个排字错误。

更正：那一部分内容应当为：有关更多信息，请参见联机帮助中的“MIME 类型”页面和“使用虚拟服务器”。

6173133 

NSAPI Programmer's Guide 中介绍的 NSAPI 函数引用的示例不正确。

更正：该示例应当为：

FilterMethods methods = FILTER_METHOD_INITIALIZER;

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。如果您打算使用管理服务器，则必须安装 JDK。 

5016571 

通用线程池下的 "Online Help" 页面提供的信息无效。

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

更正：这两行应当为：

certmap sun1 ou=Sun Certificate Authority,o=Sun, c=US

certmap sun2 ou=Sun Certificate Authority, o=Sun, c=US

5031366 

联机版本的管理员指南中存在无效链接。

4968568 

Administrator's Configuration File Reference 指南中对 ConnQueueSize 指令的描述不明确。

4975161 

Administrator's Configuration File Reference 没有介绍 pool-init 的可选参数 "block-size"。

5002190 

管理员指南未包含关于 htpasswd 命令实用程序的信息。

附加信息：htpasswd 命令用于生成或修改适于与 htpasswd 访问控制机制结合使用的密码文件。

htpasswd 用法如下：

htpasswd [-c] passwordfile username [password]

-c 选项将通过覆盖旧的密码文件（如果已存在）来创建新密码文件。如果没有 -c，该命令将通过更新用户的密码（如果用户已存在）或以给定名称添加新用户来修改现有文件。

如果未提供可选的密码参数，系统将采用交互方式提示您输入要指定的密码。 

请注意，在 Web Server 中，htpasswd 不是首选的访问控制机制。如果有可能，请改为使用 ACL。

5002192 

Administrator's Configuration File Reference 中介绍的关于 loglevel 属性的信息是错误的。

更正：loglevel 描述应当为：

控制由其他元素记录到错误日志中的消息的默认类型。允许的值如下所示（从高到低排列）：finest、finer、fine、info、warning、failure、config、security 和 catastrophe。

5020640 

NSAPI Programmer's Guide 没有说明 %duration% flex-log format 变量。

5029321 

Administrator's Configuration File Reference 中对 <Client uri="*foo*" uri="*~bar*"> 指令的描述是错误的。

更正：在某些情况下，可以重新写入评估以占用单个评估语句：

<Client uri="*foo*~*bar*">

该语句的功能 

<Client uri="*foo*" uri="~*bar*">

5038534 

Administrator's Configuration File Reference 中介绍的 LogFlushInterval 指令的默认值是错误的。

更正：LogFlushInterval 指令的正确默认值为 2 秒。

5043491 

联机帮助内容不正确。 

4781137 

管理员指南描述的以下信息是错误的：

  • 指南中未定义 libdigest-plugin.ldif 所在的路径。

    附加信息：libdigest-plugin.ldif 可在 <server-root>/plugins/digest/libdigest-plugin.ldif 获得。

  • 提供了配置 Web Server 以处理摘要验证的信息（在 dbswitch.conf 中设置数据库定义的 digestauth 属性），但并未介绍执行该操作的过程。

  • 提及 libdigest-plugin.so 时错误地称为 libdigest-plugin.lib。

  • 缺少对 iplanetReversiblePassword 的描述。

4823362 

需要用关于 ACL 的附加信息更新管理员指南。

附加信息：如果有多个匹配的 ACL，服务器将使用匹配的最后一个语句。当 uri ACL 是匹配的最后一个语句时将忽略默认的 ACL。

4862795 

管理员指南中对 "Archive Log File" 页面的描述不明确。

更正：请在文档中添加以下注释以做出更明确的描述：用户可以归档或删除旧的日志文件（此操作不是由 Web Server 来完成的）。

5046588 

Installation and Migration Guide 中介绍支持的 Sun 加速器硬件版本是错误的。

更正：支持的 Sun 加速器硬件版本为 500 和 1000。

5052605 

NSAPI Programmer's Guide 没有明确指明内容类型必须为小写。

5053339 

管理员指南和联机帮助中缺少“联机帮助—目录索引”信息。

5062560 

Installation and Migration Guide 中没有介绍禁用引导时启动选项的方法。

附加信息：您可以按照以下方式禁用引导时启动选项：

在 Solaris 和 HP-UX 上—通过编辑 webserver01 脚本中的 S1WS_START_ONBOOT 变量可以禁用该选项。

[Solaris] 

/etc/init.d/webserver01

[HP-UX] 

/sbin/init.d/webserver01

在 Linux 上—删除以下链接可以将其禁用： 

/etc/rc.d/rc3.d/S75webserver01

/etc/rc.d/rc5.d/S75webserver01

6067059 

在管理员指南中，任何不带有内容主体的标记的结束 ">" 标记前都必须有 "/"。

4928287 

所有文档都没有告知用户 <instance>/lib 目录不存在。

附加信息：此目录不是由安装程序创建的。如果此目录不存在，则用户必须创建此目录。

4970961 

Administrator's Configuration File Reference 没有详细说明 ChunkedRequestTimeout。

6308091 

Administrator's Configuration File Reference—ppath 中的带有波浪号的通配符模式没有按介绍的方式起作用。

更正：可以采用以下配置之一：

配置 1

<Object ppath="*~*.gif*"> AddLog fn=flex-log name="access"</Object>

配置 2

<Object ppath="*~*(.gif|.gif/)"> AddLog fn=flex-log name="access" </Object>

6285234 

Administrator's Configuration File Reference 中介绍 StrictHttpHeaders 指令的默认值为 on 是错误的。

更正：StrictHttpHeaders 指令的默认值为 off。

6067318 

Administrator's Configuration File Reference 中提供的关于 set-variable 错误参数的信息不足。

更正：set-variable 错误参数的描述应当为：

通过返回 REQ_ABORTED 设置 HTTP 状态代码并中止请求。要设置 HTTP 状态代码而不终止请求，请使用 set-variable 错误参数和 noaction 参数。

要重写 HTTP 状态代码，请使用 Client 标记匹配原始的状态代码，再使用 Output 指令设置新的状态代码。例如，以下示例将把所有的 302 Moved Temporarily 响应都重写为 301 Moved Permanently 响应：

<Client code="302">Output fn="set-variable" error="301 Moved Permanently" noaction="true" </Client>

6237303 

《SUN ONE Web Server 6.1 发行说明》中未列出 Solaris SPARC 必需的所有修补程序。

附加信息：109326-09 是在 Solaris 8 上使用 Web Server 6.1 所必需的修补程序。

6230379 

Administrator's Configuration File Reference 中未正确介绍 remove-file() SAF。

更正：将 remove-file() 重命名为 delete-file()。

6208955 

NSAPI Programmer's Guide 中错误地将 SERVER_SOFTWARE 描述为 MAGNUS_VERSION_STRING。

更正：SERVER_SOFTWARE 的 NSAPI 变量为 system_version()。

4673436 

iWS 能够识别域控制器环境中的远程共享。 

6320016 

Administrator's Configuration File Reference 没有明确定义 listenQ 在 Windows 中的默认值。

更正：listenQ 在 Windows 中的默认值为 200。

6354681 

Administrator's Configuration File Reference 需要有关 DNS 的更多信息。

附加信息：

现有文档中的 DNS 描述如下： 

DNS 指令指定服务器是否在访问服务器的客户机上执行 DNS 查找。当客户机连接到服务器时，服务器可以知晓客户机的 IP 地址，而不是其主机名（例如，服务器知晓客户机的 IP 地址 198.95.251.30，而不知晓其主机名 www.a.com）。服务器将客户机的 IP 地址解析为主机名以用于诸如访问控制、CGI、错误报告和访问日志记录等操作。 

DNS 描述如下： 

服务器可以将客户机的 IP 地址解析为主机名以用于诸如访问控制等操作。DNS 指令指定服务器是否在访问服务器的客户机上执行 DNS 查找。当客户机连接到服务器时，服务器可以知晓客户机的 IP 地址，而不是其主机名（例如，服务器知晓客户机的 IP 地址 198.95.251.30，而不知晓其主机名 www.a.com）。服务器将客户机的 IP 地址解析为主机名以用于诸如访问控制、CGI、JSP、Servlet、错误报告和访问日志记录等操作。