此元素启动 WebSphere HTTP 插件配置文件。它可以包含一个或多个下列元素和属性:
- IgnoreDNSFailures
- 指定启动时插件是否忽略配置中的 DNS 故障。当设置为 true 时,如果每个 ServerCluster 中至少有一个服务器能够解析主机名,则插件忽略配置中的 DNS 故障并成功启动。任何主机名无法解析的服务器在配置期间标记为不可用。稍后在路由请求期间不会尝试解析该主机名。如果发生 DNS 故障,则日志消息将被写入插件日志文件,并继续插件初始化而不会导致无法启动 Web 服务器。缺省值为 false,意味着 DNS 故障会导致 Web 服务器不启动。
- RefreshInterval
- 插件应该检查配置文件以查看是否发生更新或更改的时间间隔(以秒计)。插件检查文件自上次装入插件配置以来,是否有任何修改。
在经常发生更改的开发环境中,低于缺省设置 60 的设置更合适些。在生产环境中,因为不会经常更新配置,所以比缺省值高的值更合适些。如果由于某些原因重新装入插件失败,则一条消息被写入插件日志文件,并使用先前的配置,直到成功重新装入插件配置文件。如果您还未看到对插件配置的更改,则检查插件日志文件以获取对问题的说明。
- ASDisableNagle
- 指定用户是否要对插件和应用程序服务器之间的连接禁用 nagle 算法。缺省情况下,nagle 算法处于启用状态。
值可以为 true 或 false。
- IISDisableNagle
- 指定用户是否要在 Microsoft Internet Informations Services(IIS)上禁用 nagle 算法。缺省情况下,nagle 算法处于启用状态。
值可以为 true 或 false。
- AppServerPortPreference
- 此属性用于指定 Application Server 应该使用哪个端口号构建 sendRedirect 的 URI。可以指定以下值:
- webserverPort(如果要使用入局 HTTP 请求的主机头的端口号)。
- hostHeader(如果要使用 Web 服务器接收请求的端口号)。
缺省值为 hostHeader。
- ResponseChunkSize
- 插件读取响应主体(以 64k 块计),直到读取所有的响应数据。此方法会导致包含大量数据的响应主体请求的性能问题。
ResponseChunkSize 属性使您可以指定读取响应主体时要使用的最大块大小。例如,Config ResponseChunkSize="N">,其中 N 等于块大小(以千字节计)。
如果响应主体的内容长度是未知的,则会分配 N 千字节的缓冲区大小,并且以 N 千字节大小的块读取主体,直到读完整个主体。如果内容长度已知,则使用内容长度或 N(哪一个较小就用哪一个)的缓冲区大小以读取响应主体。
缺省块大小为 64k。
- AcceptAllContent
- 指定当请求头中包含 Content-Length 或 Transfer-encoding 头时,用户是否可以在 POST、PUT、GET 和 HEAD 请求中包含内容。您可以为此属性指定下列某个值:
- 如果内容是期望的并要为所有请求读取该内容,则请指定 True
- 如果内容是期望的并要仅为 POST 和 PUT 请求读取该内容,则请指定 False。
False 为缺省值。
- ChunkedResponse
- 指定当对客户机的响应中包含 Transfer-Encoding : Chunked 响应头时,插件是否应该将该响应进行分块。
此属性仅适用于 IIS、IPlanet 和 Domino Web 服务器。IBM HTTP Server 自动处理是否将对客户机的响应进行分块。
您可以为此属性指定下列某个值:
- 如果当对客户机的响应中包含 Transfer-Encoding : Chunked 响应头时插件要将该响应进行分块,则指定 true。
- 如果不要将该响应分块,则指定 false。
false 是缺省值。
- IISPluginPriority
- 指定 IIS Web 服务器装入 WebSphere Web 服务器插件的优先级。您可以为此属性指定下列某个值:
缺省值为 High。
注意:
- IIS Web 服务器在启动期间使用此值。因此,必须重新启动 Web 服务器,此更改才会生效。
- 缺省值 High 确保所有请求在由任何其他过滤器/扩展处理前已由 WebSphere Web 服务器插件处理。如果使用优先级 Medium 或 Low 时发生问题,则必须重新排列干预过滤器/扩展的顺序或更改它们的优先级。
- Log
- 日志描述由插件写的日志消息的位置和级别。如果配置文件中未指定日志,则在一些情况下,日志消息将被写到 Web 服务器错误日志中。
例如,您可以指定以下各项:
<Log LogLevel="Error" Name="/log_directory/filename"/>
- Name(每个 Log 必须有且只能有一个该属性)
- 日志文件的标准路径,插件会将错误消息写入该日志文件。
注: 日期与时间戳记以及进程标识都不再追加到您为插件日志文件指定的名称。因此,将创建单个 Web 服务器插件日志文件,而不是创建多个按日期来区别的日志文件。此行为与 V5.x 的行为有所不同。
- LogLevel(每个 Log 可以有零个或一个该属性)
- 插件应该写入日志的日志消息的详细信息级别。您可以为此属性指定下列某个值:
- Trace。此请求过程中的全部步骤都详细记录。
- Stats。记录了为每个请求选择的服务器和其他与请求处理相关的负载均衡信息。
- Warn。所有来自异常请求处理的警告和错误消息被记录。
- Error。仅记录来自异常请求处理导致的错误消息。
- Debug。记录处理请求时执行的所有关键步骤。
- Detail。记录关于请求和响应的所有信息。