blog.Toby

在经常发生更改的开发环境中，低于缺省设置 60 的设置更合适些。在生产环境中，因为不会经常更新配置，所以比缺省值高的值更合适些。如果由于某些原因重新装入插件失败，则一条消息被写入插件日志文件，并使用先前的配置，直到成功重新装入插件配置文件。如果您还未看到对插件配置的更改，则检查插件日志文件以获取对问题的说明。

值可以为 true 或 false。

值可以为 true 或 false。

• webserverPort（如果要使用入局 HTTP 请求的主机头的端口号）。
• hostHeader（如果要使用 Web 服务器接收请求的端口号）。

缺省值为 hostHeader。

ResponseChunkSize 属性使您可以指定读取响应主体时要使用的最大块大小。例如，Config ResponseChunkSize="N">，其中 N 等于块大小（以千字节计）。

如果响应主体的内容长度是未知的，则会分配 N 千字节的缓冲区大小，并且以 N 千字节大小的块读取主体，直到读完整个主体。如果内容长度已知，则使用内容长度或 N（哪一个较小就用哪一个）的缓冲区大小以读取响应主体。

缺省块大小为 64k。

• 如果内容是期望的并要为所有请求读取该内容，则请指定 True
• 如果内容是期望的并要仅为 POST 和 PUT 请求读取该内容，则请指定 False。

False 为缺省值。

此属性仅适用于 IIS、IPlanet 和 Domino Web 服务器。IBM HTTP Server 自动处理是否将对客户机的响应进行分块。

您可以为此属性指定下列某个值：

• 如果当对客户机的响应中包含 Transfer-Encoding : Chunked 响应头时插件要将该响应进行分块，则指定 true。
• 如果不要将该响应分块，则指定 false。

false 是缺省值。

• High
• Medium
• Low

缺省值为 High。

例如，您可以指定以下各项：

<Log LogLevel="Error" Name="/log_directory/filename"/>

Name（每个 Log 必须有且只能有一个该属性）

日志文件的标准路径，插件会将错误消息写入该日志文件。

注： 日期与时间戳记以及进程标识都不再追加到您为插件日志文件指定的名称。因此，将创建单个 Web 服务器插件日志文件，而不是创建多个按日期来区别的日志文件。此行为与 V5.x 的行为有所不同。

LogLevel（每个 Log 可以有零个或一个该属性)

插件应该写入日志的日志消息的详细信息级别。您可以为此属性指定下列某个值：

• Trace。此请求过程中的全部步骤都详细记录。
• Stats。记录了为每个请求选择的服务器和其他与请求处理相关的负载均衡信息。
• Warn。所有来自异常请求处理的警告和错误消息被记录。
• Error。仅记录来自异常请求处理导致的错误消息。
• Debug。记录处理请求时执行的所有关键步骤。
• Detail。记录关于请求和响应的所有信息。

如果没有为 Log 元素指定 LogLevel，则将使用缺省值 Error。

将级别设置为 Trace 时，请小心。许多消息在此级别记录，该级别会导致文件系统非常快速地用尽。决不应该在正常运作环境中使用 Trace 设置，因为它会对性能有负面影响。

Value 可以设置为 true 或 false。缺省情况下，ESI 处理器处于启用状态（已设置为 true）。

Value 可以设置为 true 或 false。缺省情况下，此属性设置为 false。

对于 WebSphere for z/OS HTTP Server 插件，必须始终将此属性设置为 false。

Value 可以设置为 true 或 false。缺省情况下，此属性设置为 false。

最简单的情况是集群仅包含一个服务器定义。在定义了多个服务器的情况下，插件将使用循环法或 Random 算法将负载均衡地分布到所定义的服务器上。缺省值为“循环法”（Round Robin）。

以下是 ServerCluster 元素的示例

<ServerCluster CloneSeparatorChange="false"
LoadBalance="Round Robin" Name="Cluster1"
PostSizeLimit="10000000" RemoveSpecialHeaders="true"
RetryInterval="60">
<Server
CloneID="BA36BEC1EB243D8B000000E4000000030926301B"
ConnectTimeout="0" ExtendedHandshake="false"
LoadBalanceWeight="2" MaxConnections="0"
Name="SY1_ClusterMember1" WaitForContinue="false">
<Transport Hostname="BOSSXXXX.PLEX1.L2.IBM.COM" Port="9084" Protocol="http"/>
<Transport Hostname="BOSSXXXX.PLEX1.L2.IBM.COM" Port="0" Protocol="https">
<Property Name="Keyring" value="/WebSphere/V6R0M0/DeploymentManager/etc/
plugin-key.kdb"/>
<Property Name="Stashfile" value=""/WebSphere/V6R0M0/DeploymentManager/etc/
plugin-key.sth"/>
<Property Name="certLabel" Value="selfsigned"/>
</Transport>
</Server>
<Server CloneID="BA36BED017FDF40E000000E4000000030926301B"
ConnectTimeout="0" ExtendedHandshake="false"
LoadBalanceWeight="2" MaxConnections="0"
Name="SY1_ClusterMember2" WaitForContinue="false">
<Transport Hostname="BOSSXXXX.PLEX1.L2.IBM.COM" Port="9085" Protocol="http"/>
<Transport Hostname="BOSSXXXX.PLEX1.L2.IBM.COM" Port="0" Protocol="https">
<Property Name="Keyring" value="/WebSphere/V6R0M0/DeploymentManager/etc/
plugin-key.kdb"/
<Property Name="Stashfile" value="/WebSphere/V6R0M0/DeploymentManager/etc/
plugin-key.sth"/>
<Property Name="certLabel" Value="selfsigned"/>
</Transport>
</Server>
<PrimaryServers>
<Server Name="Server Name="SY1_ClusterMember1"/>
<Server Name="Server Name="SY1_ClusterMember2"/>
</PrimaryServers>
</ServerCluster>

Name（每个 ServerCluster 必须有且只能有一个该属性）

将用于此组服务器的逻辑名或管理名。

LoadBalance（每个 ServerCluster 可以有零个或一个该属性）

缺省负载均衡类型是循环法。

循环法实现具有随机起始点。将随机检取第一个服务器。循环法将用于从该点开始检取服务器。此实现确保基于多个进程的 Web 服务器中，发送第一个请求到同一个 Application Server 并不会启动所有进程。

RetryInterval（每个 ServerCluster 可以有零个或一个该属性）

一个指定时间长度的整数，这段时间应该是从将服务器标记为当机的时间到插件重试连接的时间。缺省值为 60 秒。

RemoveSpecialHeaders（每个 ServerCluster 可以有零个或一个该属性）

在将请求转发到应用程序服务器之前，插件将一些特殊的头添加到请求。这些头存储关于应用程序将需要使用的请求的信息。缺省情况下，插件在添加它假定要添加的头前，将从入局请求中除去这些头。

值可以为 true 或 false。如果将该属性设置为 false，则不会除去入局请求中的头，这是一个潜在的安全性漏洞。

CloneSeparatorChange（每个 ServerCluster 可以有零个或一个该属性）

某些普及型设备无法处理冒号字符（:），该字符用于分隔与会话亲缘关系联合的克隆标识。服务器组的此属性通知插件将使用加号（+）作为克隆分隔符。您必须更改应用程序服务器配置，以便应用程序服务器也使用加号来分隔克隆标识。

值可以为 true 或 false。

PostSizeLimit（每个 ServerCluster 可以有零个或一个该属性）

插件尝试将请求发送到应用程序服务器时所允许的请求内容最大字节数。如果接收到大于此大小的请求，则插件不会发送该请求。缺省值为 -1 个字节，表明发布大小没有限制。

 PostBufferSize（每个 ServerCluster 可以有零个或一个该属性）

指定读取 HTTP 请求内容时使用的最大缓冲区大小（以千字节计）。如果最初接收到请求的应用程序服务器无法处理该请求，则将此缓冲区中包含的数据发送给另一应用程序服务器以尝试让该应用程序服务器处理此请求。

此选项改进了插件的可用性。现在，如果所选应用程序服务器未响应，则将重试包含内容但未完成的请求。如果值设置为零，则不会缓冲和重试包含内容的请求。缺省值为 64。

Server（每个 ServerCluster 可以有一个或多个该元素）

一个 WebSphere Application Server 实例，已配置它来处理使用插件配置的路由规则路由至它的请求。该服务器应该对应于在本地机器或远程机器上运行的应用程序服务器。

Name（每个 Server 必须有且只能有一个该属性）

服务器的管理名或逻辑名。

CloneID（每个 Server 可以有零个或一个该属性） (参考web容器定制属性HttpSessionCloneId)

如果请求的 HTTP cookie 头（或 URL，如果使用 URL 重写的话）中包含此唯一标识，则只要符合所有其他路由规则，插件就会将该请求路由至此特定服务器（。如果在 Server 中未指定 CloneID，则不会对此服务器启用会话亲缘关系。

此属性将与会话亲缘关系一起使用。当设置了此属性时，插件检查入局 cookie 头或 URL 中是否有 JSESSIONID。如果找到了 JSESSIONID，则插件查找一个或多个克隆标识。如果找到了克隆标识，且与对此属性指定的值匹配，则会将请求发送到此服务器而不是均衡地加载在集群中。

如果您不打算使用会话亲缘关系，则最好从配置中除去这些克隆标识，因为设置这些标识会增加插件处理请求时的负载。如果插件中没有克隆标识，则假定会话亲缘关系未打开，并且请求将均衡地加载在集群中。

WaitForContinue（每个 Server 可以有零个或一个该属性）

指定在将请求内容发送到应用程序服务器之前，是否要使用 HTTP 1.1 100 Continue 支持。可能的属性值为 true 或 false。缺省值为 false；插件在发送请求内容之前，不会等待来自应用程序服务器的 100 Continue 响应，因为这会降低性能。

对于 POST 请求，将忽略此属性，以便在应用程序服务器由于保持活动超时而关闭连接时，不会发生故障。

当配置插件以使用某些类型的代理防火墙时，请启用此功能（设置为 true）。

LoadBalanceWeight（每个 Server 可以有零个或一个该属性）

指定当插件执行加权循环法负载均衡时，与此服务器相关联的权重。服务器的开始值可以为 0 和 20 之间的任何整数。然而，对于已关闭的服务器，只应该指定零。

此属性的算法会递减服务器集群内的所有权重，直到所有权重达到零。在对特定服务器指定的权重达到零之后，在集群中的所有服务器权重为零之前，不会再将请求路由至该服务器。在所有服务器达到零之后，将复位集群中所有服务器的权重，并且该算法重新开始。

当某个服务器已关闭时，建议您将该服务器的权重设置为零。然后插件可以复位仍在运行的服务器的权重，并维持适当的负载均衡。

ConnectTimeout（每个 Server 可以有零个或一个该属性）

Server 元素的 ConnectTimeou 属性使插件可以执行与应用程序服务器的非分块连接。当插件无法联系目标以确定端口是可用还是不可用时，非分块连接是有益的。

如果未指定 ConnectTimeout 值，则插件执行分块连接，插件在操作系统超时（根据平台，它可以长达 2 分钟）前位于该连接中，并且该连接允许插件将服务器标记为不可用。值 0 导致插件执行分块连接。大于 0 的值指定您要插件等待成功连接的秒数。如果在该时间间隔后不发生连接，则插件将服务器标记为不可用并故障转移到集群中定义的另一台服务器。

ExtendedHandshake（每个 Server 可以有零个或一个该属性）

当代理防火墙在插件和应用程序服务器之间时，则使用 ExtendedHandshake 属性。在这种情况下，插件不会像期望的那样执行故障转移。

当 connect() 失败时插件标记服务器为当机。但是，当代理防火墙在插件和应用程序服务器之间时，即使后端应用程序服务器当机了，connect() 也会成功。这导致插件没有正确地故障转移到其他应用程序服务器。

插件与应用程序服务器执行某些握手以确保它在发送请求前已启动。这使插件能够在应用程序服务器当机时执行故障转移。

值可以为 true 或 false。

MaxConnections（每个 Server 有一个该元素）

MaxConnections 属性用于指定可以及时流经任何点上的 Web 服务器进程的、与 Application Server 的最大暂挂连接数。

例如，假设：

• 此应用程序服务器前端有 5 个运行 IBM HTTP Server 的节点。
• 每个节点启动 2 个进程。
• MaxConnections 属性设置为 50。

在此示例中，应用程序服务器可以潜在地获取最多 500 个连接。（用节点数 5 乘以进程数 2，然后将得数乘以为 MaxConnections 属性指定的数字 50，得到总数 500 个连接。）

在 z/OS 平台上此属性不是必要的。z/OS 控制器与 WLM 共同动态地处理新连接。

缺省情况下，MaxConnections 设置为 -1。如果此属性设置为零或 -1，则到应用程序服务器的暂挂连接数没有限制。

Transport（每个 Server 可以有一个或多个该元素）

用于对特定 WebSphere Application Server 实例的读取和写入请求的传输。传输提供一些信息，需要这些信息来确定请求将发送至的应用程序服务器的位置。如果 Server 已将多个传输定义为使用相同协议，则将使用第一个传输。

可以将 Server 配置为具有一个非安全传输和一个使用 SSL 的传输。在此配置中，将执行匹配的入局请求协议来确定用来将请求发送到应用程序服务器的适当传输。

Hostname（每个 Transport 必须有且只能有一个该属性）

正在运行 WebSphere Application Server 实例的机器的主机名或 IP 地址。

Port（每个 Transport 必须有且只能有一个该属性）

WebSphere Application Server 实例进行侦听所使用的端口。

Protocol（每个 Transport 必须有且只能有一个该属性）

当通过此传输进行通信时要使用的协议 － HTTP 或 HTTPS。

Property（每个 Transport 可以有零个、一个或多个该元素）

当 Transport 的 Protocol 设置为 HTTPS 时，请使用此元素来提供各种初始化参数，如 password、keyring 和 stashfile。例如，包含这些元素的 plugin_cfg.xml 文件的一部分可能类似于以下内容：

<Transport Hostname="192.168.1.2" Port="9443" Protocol="HTTPS">
<Property Name="keyring" value="c:/WebSphere/AppServer/keys/keyring.kdb"/>
<Property Name="stashfile" value="c:/WebSphere/AppServer/keys/keyring.sth"/>
<Property Name="password" value="WebAS"/>

注： 使用 iKeyMan 查看 plugin-key.kdb 文件的缺省密码是 WebAS。

Name（每个 Property 必须有且只能有一个该属性）

正在定义的 Property 的名称。传输可识别的受支持名称为 keyring、stashfile 和 password。

注： password 是可以对 WebSphere HTTP for z/OS 插件指定的唯一名称。将忽略 keyring 和 stashfile（如果指定了它们）。

Value（每个 Property 必须有且只能有一个该属性）

正在定义的 Property 的值。

ServerIOTimeout

Server 元素的 ServerIOTimeout 属性使插件能够设置将请求发送至应用程序服务器以及从应用程序服务器读取响应时的超时值（以秒计）。如果未对 ServerIOTimeout 属性设置值，则插件在缺省情况下使用分块 I/O 来将请求写至应用程序服务器以及从应用程序服务器读取响应，直到 TCP 连接超时为止。例如，如果您指定：

<Server Name="server1" ServerIOTimeout=300>

在这种情况下，如果应用程序服务器停止对请求进行响应，则插件会等待 300 秒（5 分钟），然后使 TCP 连接超时。如果将 ServerIOTimeout 属性设置为合理的值，则插件能够较快地使连接超时，并在可能时将请求传送到另一个应用程序服务器。

在选择此属性的值时，请记住，应用程序服务器处理请求有时可能需要几分钟的时间。如果将 ServerIOTimeout 属性的值设置得太小，可能会导致插件将不正确的服务器错误响应发送到客户机。

ClusterAddress（每个 ServerCluster 可以有零个或一个该元素）

ClusterAddress 类似于 Server 元素，您可以在其中像对 Server 元素一样指定相同的属性和元素。差别在于，在一个 ServerCluster 中，您只能定义一个 ClusterAddress。当您因为在插件和应用程序服务器之间已具有某种类型的负载均衡器而不希望插件执行任何类型的负载均衡时，请使用 ClusterAddress。

重要： 如果您包括 ClusterAddress 标记，则您必须在该标记上包括 Name 属性。插件使用 Name 属性来使集群地址与正确的主机和端口相关联。如果您未指定 Name 属性，则插件给集群地址分配对使用相同主机和端口的服务器指定的名称。

<ClusterAddress Name="MyClusterAddr">
<Transport Hostname="192.168.1.2" Port="9080" Protocol="HTTP"/>
<Transport Hostname="192.168.1.2" Port="9443" Protocol="HTTPS">
</ClusterAddress>

如果接收到未建立亲缘关系的请求，则插件将它路由至集群地址（如果已定义）。如果已建立亲缘关系，则插件会完全绕过集群地址而将请求直接路由到克隆。如果没有为服务器集群定义集群地址，则插件会将负载均衡地分布到主服务器列表中的服务器上。

PrimaryServers（每个服务器集群可以有零个或一个该元素）

指定插件要将对此集群的请求路由至的服务器列表。如果未指定主服务器列表，则插件会将请求路由至为服务器集群定义的服务器。

BackupServers（每个服务器集群可以有零个或一个该元素）

指定在主服务器列表中指定的所有服务器都不可用时，应该将请求发送至的服务器列表。插件不会将负载均衡地分布在备份服务器上，但它会按顺序遍历该列表，直到列表中没有服务器，或直到成功发送请求并且从应用程序服务器接收到响应为止。

以下是 VirtualHost Group 元素和相关联的元素及属性的示例

<VirtualHostGroup Name="Hosts">
<VirtualHost Name="www.x.com"/>
<VirtualHost Name="www.x.com:443"/>
<VirtualHost Name="*:8080"/>
<VirtualHost Name="www.x.com:*"/>
<VirtualHost Name="*:*"/>
</VirtualHostGroup>

Name（每个 VirtualHostGroup 必须有且只能有一个该属性）

将用于此组虚拟主机的逻辑名或管理名。

VirtualHost（每个 VirtualHostGroup 可以有一个或多个该元素）

用于虚拟机器或实际机器的名称，用来确定入局请求是否应该由 WebSphere Application Server 进行处理。请使用此元素来指定 HTTP Host 头中将包含的主机名，需要由应用程序服务器处理的请求应该可以到达这些主机。您可以指定入局请求将具有的特定主机名和端口，也可以对主机名和／或端口指定星号（*）。

Name（每个 VirtualHost 必须有且只能有一个该属性）

应该在 HTTP Host 头中指定以便与此 VirtualHost 成功匹配的实际名称。

值是主机名或 IP 地址与端口的组合，用冒号隔开。

您可以将插件配置为根据请求的入局 HTTP Host 头和端口将请求路由至应用程序服务器。Name 属性指定这些组合的内容。

您可以使用通配符表示此属性。唯一可接受的解决方案是将一个星号（*）表示主机名，一个星号表示端口，或使用一个星号表示这两者。用一个星号表示这两者意味着任何请求都将与此规则匹配。如果定义中未指定端口，则使用缺省 HTTP端口 80。

以下是 UriGroup 元素和相关联的元素及属性的示例：

<UriGroup Name="Uris">
<Uri Name="/servlet/snoop"/>
<Uri Name="/webapp/*"/>
<Uri Name="*.jsp"/>
</UriGroup>

Name（每个 UriGroup 必须有且只能有一个该属性）

用于此组 URI 的逻辑名或管理名。

Uri（每个 UriGroup 可以有一个或多个该元素）

将由 WebSphere Application Server 服务的资源的虚拟路径。每个 URI 指定需要由应用程序服务器处理的入局 URI。您可以在这些定义中使用通配符。

Name（每个 Uri 必须有且只能有一个该属性）

应该在 HTTP 请求行中指定以便与此 URI 成功匹配的实际字符串。您可以在 URI 定义中使用通配符。您可以指定将由 WebSphere Application Server 处理的规则，如 *.jsp 或 /servlet/*。当您汇编应用程序时，如果您指定启用文件服务，则仅会为 Web 应用程序生成一个带有通配符的 URI，而不考虑任何显式 servlet 映射。如果您指定按类名服务 servlet，则将生成具有 <Uri Name="Web_application_URI/servlet/*"> 的 URI。

AffinityCookie（每个 Uri 可以有零个或一个该属性） (参考server的会话管理的cookie名称)

插件在尝试确定入站请求是否具有会话亲缘关系时应该使用的 cookie 的名称。缺省值为 JSESSIONID。

请参阅 CloneID 属性的描述以获取其他会话亲缘关系信息。

AffinityURLIdentifier（每个 Uri 可以有零个或一个该属性） (参考web容器定制属性SessionRewriteIdentifier)

插件在尝试确定入站请求是否具有在特定克隆的 URL 中指定的亲缘关系时应该使用的标识的名称。缺省值为 jsessionid。

请参阅 CloneID 属性的描述以获取其他会话亲缘关系信息。

路由定义是插件配置的中心元素。它指定插件将如何根据请求的某些特征来处理请求。路由定义包含其他主要元素：必需的 ServerCluster 以及 VirtualHostGroup 和／或 UriGroup。

通过使用在路由的 VirtualHostGroup 和 UriGroup 中定义的信息，插件确定是否应该将 Web 服务器的入局请求发送到此路由中定义的 ServerCluster。

以下是此元素的示例：

<Route VirtualHostGroup="Hosts" UriGroup="Uris" ServerCluster="servers/>

VirtualHostGroup（每个 Route 可以有零个或一个该属性）

在确定路由时应该使用的一组虚拟主机。将入局主机头和服务器端口进行比较以确定此请求是否应由应用程序服务器处理。

可以在路由定义中省略此属性。如果未提供此属性，则在确定路由的虚拟主机匹配部分期间，每个请求都将匹配。

UriGroup（每个 Route 可以有零个或一个该属性）

用于确定路由的一组 URI。将请求的入局 URI 和此组中定义的 URI 进行比较以确定此请求是否应由应用程序服务器处理。

可以在路由定义中省略此属性。如果未提供此属性，则在确定路由的 URI 匹配部分期间，每个请求都将匹配。

ServerCluster（每个 Route 必须有且只能有一个该属性）

会将与路由成功匹配的请求发送至的集群。

应该用来处理此请求的集群。如果 URI 和虚拟主机匹配对于此路由已成功，则请求将发送到此集群内定义的某个服务器。

以下是此元素的示例：

<RequestMetrics armEnabled="false"  loggingEnabled="true"
rmEnabled="false" traceLevel="PERF_DEBUG">