生成 Web 服务器插件配置文件时使用的属性
Name | Type | Default | Description |
---|---|---|---|
pluginInstallRoot | string | /opt/IBM/WebSphere/Plugins | Web 服务器主机的文件系统上 Web 服务器插件安装位置 |
webserverName | string | webserver1 | 此配置将使用的 Web 服务器名称。用来生成插件日志文件位置(如果日志文件名或目录未显式指定此位置)。 |
webserverPort | int Min: -1 Max: 65535 | 80 | Web 服务器 HTTP 端口 |
webserverSecurePort | int Min: -1 Max: 65535 | 443 | Web 服务器 HTTPS 端口 |
sslKeyringLocation | string | ${pluginInstallRoot}/config/${webserverName}/plugin-key.kdb | Web 服务器主机上 SSL 密钥环文件的标准路径 |
sslStashfileLocation | string | ${pluginInstallRoot}/config/${webserverName}/plugin-key.sth | Web 服务器主机上的 SSL 隐藏文件的标准路径 |
sslCertlabel | string | 指定当 Web 容器从插件请求客户机证书时,该插件要使用的密钥环中的证书的标签。 | |
ipv6Preferred | 布尔型 | false | 当解析应用程序服务器主机名 {null} 或 {0},以在可能时首选地址类型时使用 |
httpEndpointRef | 对顶级 httpEndpoint 元素的引用(字符串)。 | defaultHttpEndpoint | 指定要包括在已生成 plugin-cfg.xml 文件中的 HTTP 端点的标识。该端点在集群中定义服务器。缺省值为“defaultHttpEndpoint”。 |
connectTimeout | 具有秒精度的时间段 | 5s | 标识应用程序服务器应保持与 Web 服务器的连接的最长时间。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 |
serverIOTimeout | 具有秒精度的时间段 | 900s | 标识 Web 服务器插件等待发送请求或从应用程序服务器接收响应的最长时间。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 |
wsServerIOTimeout | 具有秒精度的时间段 | 确定 Web 服务器插件等待发送请求或从应用程序服务器接收 websocket 响应的最长时间。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 | |
wsServerIdleTimeout | 具有秒精度的时间段 | 确定 Web 服务器插件等待终止空闲 websocket 连接的最长时间。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 | |
extendedHandshake | 布尔型 | false | 如果为 true,那么 Web 服务器插件使用扩展握手来确定应用程序服务器是否正在运行。 |
waitForContinue | 布尔型 | false | 如果为 false(缺省值),那么 Web 服务器插件使用具有消息体的 HTTP 请求来发送“Expect: 100-continue”头。如果设置为 true,那么 Web 服务器插件使用每个 HTTP 请求发送“Expect: 100-continue”头。如果 Web 服务器与应用程序服务器之间有防火墙,并且您对没有请求主体的请求重试很敏感,请考虑将此值设置为 true。 |
logFileName | 文件路径 | Web 服务器插件日志文件的标准路径。“目录”组成部分必须已存在。对于基于 Apache 的 Web 服务器,以管道字符开头的路径会解释为外部管道记录器。如果指定了此项,那么路径将覆盖 logDirLocation。 | |
logDirLocation | 目录路径 | ${pluginInstallRoot}/logs/${webserverName} | 不推荐使用:用于标识 http_plugin.log 文件所在的目录。请参阅“日志文件名”。 |
serverIOTimeoutRetry | int Min: -1 Max: 65535 | -1 | 限制在读/写超时之后请求重试的次数。缺省值为 {-1},将不应用其他限制,因此,将由集群中的可用服务器数来限制重试次数。值 {0} 指示没有重试。此值仅限用于服务器集群,而不适用于由于 HTTP 插件连接超时而引起的连接失败或超时,也不适用于 Web 套接字超时。 |
loadBalanceWeight | 整形 | 20 | 此值在运行时动态更改。每次为服务器分配请求时,都会降低该服务器的权重。所有服务器的所有权重降至小于或等于 0 的值时,Web 服务器插件会重新调整所有权重,使其大于 0。 |
serverRole |
| PRIMARY | 服务器角色将服务器标识为主服务器或备份服务器。主服务器可用时,Web 服务器插件将其用于负载均衡和故障转移。但是,如果主服务器都不可用,那么 Web 服务器插件仅使用备份服务器进行负载均衡和故障转移。 BACKUP 备份 PRIMARY 主要 |
ESIEnable | 布尔型 | true | ESIEnable 属性允许 Edge Side Include 处理对响应进行缓存。此属性允许在 Web 服务器插件配置文件中禁用 ESI。 |
ESIMaxCacheSize | 整形 | 1024 | ESIMaxCacheSize 为高速缓存的最大大小,缺省为 1MB。此属性允许在 Web 服务器插件配置文件中覆盖该值。 |
ESIInvalidationMonitor | 布尔型 | false | ESIInvalidationMonitor 指定 ESI 处理器是否应从应用程序服务器接收失效指令。此属性允许在 Web 服务器插件配置文件中覆盖该值。 |
ESIEnableToPassCookies | 布尔型 | false | ESIEnableToPassCookies 允许将会话 cookie 转发至 WebSphere Application Server。此属性允许在 Web 服务器插件配置文件中覆盖该值。 |
trustedProxyEnable | 布尔型 | 启用要使用的可信代理。指定了此属性时,此属性将覆盖 Web 服务器插件配置文件中的值。 | |
trustedProxyGroup | string | 可信代理的逗号分隔列表。指定了此属性时,此属性将覆盖 Web 服务器插件配置文件中的值。 |
指定要包括在已生成 plugin-cfg.xml 文件中的 HTTP 端点的标识。该端点在集群中定义服务器。缺省值为“defaultHttpEndpoint”。
Name | Type | Default | Description |
---|---|---|---|
onError |
| WARN | 启动端点失败时要执行的操作。 IGNORE 服务器在发生配置错误时将不会发出警告和错误消息。 WARN 服务器在发生配置错误时将发出警告和错误消息。 FAIL 服务器在第一次发生错误时将发出警告或错误消息,然后停止服务器。 |
enabled | 布尔型 | true | 切换端点的可用性。值为 true 时,分派器将激活此端点以处理 HTTP 请求。 |
host | string | localhost | 客户机用于请求资源的 IP 地址、带域名后缀的域名服务器 (DNS) 主机名,或仅 DNS 主机名。使用“*”可表示所有可用网络接口。 |
httpPort | int Min: -1 Max: 65535 | 用于客户机 HTTP 请求的端口。使用 -1 可禁用此端口。 | |
httpsPort | int Min: -1 Max: 65535 | 用于使用 SSL (https) 保护的客户机 HTTP 请求的端口。使用 -1 可禁用此端口。 | |
httpOptionsRef | 对顶级 httpOptions 元素的引用(字符串)。 | defaultHttpOptions | 端点的 HTTP 协议选项。 |
sslOptionsRef | 对顶级 sslOptions 元素的引用(字符串)。 | 端点的 SSL 协议选项。 | |
tcpOptionsRef | 对顶级 tcpOptions 元素的引用(字符串)。 | defaultTCPOptions | 端点的 TCP 协议选项。 |
accessLoggingRef | 对顶级 httpAccessLogging 元素的引用(字符串)。 | 端点的 HTTP 访问日志记录配置。 |
端点的 HTTP 协议选项。
Name | Type | Default | Description |
---|---|---|---|
keepAliveEnabled | 布尔型 | true | 启用持续连接(HTTP 保持活动)。如果为 true,那么连接将保持活动状态,以供多个顺序请求和响应重复使用。如果为 false,那么发送响应之后将关闭连接。 |
maxKeepAliveRequests | int Min: -1 | 100 | 启用持续连接时,单个 HTTP 连接上允许的最大持续请求数。值为 -1 时意味着不受限制。 |
persistTimeout | 具有秒精度的时间段 | 30s | 将允许套接字在各个请求之间保持空闲的时间量。仅当启用持续连接时,此设置才适用。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 |
readTimeout | 具有秒精度的时间段 | 60s | 发生第一次读取之后,用于等待读请求在套接字上完成的时间量。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 |
writeTimeout | 具有秒精度的时间段 | 60s | 响应数据的每个部分在套接字上等待传输的时间量。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 |
removeServerHeader | 布尔型 | false | 从 HTTP 头除去服务器实现信息,并同时禁用缺省 Liberty 概要文件欢迎页面。 |
NoCacheCookiesControl | 布尔型 | true | 允许使用者控制“设置 Cookie”头的存在是否会导致使用匹配的无高速缓存值更新“高速缓存控制”头。这还会添加“到期”头。 |
AutoDecompression | 布尔型 | true | 指定 HTTP 通道是否自动解压传入请求主体数据。 |
端点的 SSL 协议选项。
Name | Type | Default | Description |
---|---|---|---|
sessionTimeout | 具有秒精度的时间段 | 1d | 用于等待读或写请求在套接字上完成的时间量。特定于协议的超时将覆盖此值。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 |
suppressHandshakeErrors | 布尔型 | false | 禁用记录 SSL 握手错误。SSL 握手错误会在正常操作期间发生,但是当 SSL 行为异常时,这些消息将很有用。 |
sslRef | 对顶级 ssl 元素的引用(字符串)。 | 缺省 SSL 配置指令表。缺省值为 defaultSSLSettings。 | |
sslSessionTimeout | 具有毫秒精度的时间段 | 8640ms | SSL 通道建立的 SSL 会话的超时限制。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 |
端点的 TCP 协议选项。
Name | Type | Default | Description |
---|---|---|---|
inactivityTimeout | 具有毫秒精度的时间段 | 60s | 用于等待读或写请求在套接字上完成的时间量。特定于协议的超时将覆盖此值。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 |
soReuseAddr | 布尔型 | true | 允许立即重新绑定到没有任何处于活动状态的侦听器的端口。 |
addressIncludeList | string | 允许在此端点上进行入站连接的地址的逗号分隔列表。您可以指定 IPv4 或 IPv6 地址。IPv4 或 IPv6 地址中的所有值必须用数字或星号通配符表示。 | |
addressExcludeList | string | 不允许在此端点上进行入站连接的地址的逗号分隔列表。您可以指定 IPv4 或 IPv6 地址。IPv4 或 IPv6 地址中的所有值必须用数字或星号通配符表示。 | |
hostNameIncludeList | string | 允许在此端点上进行入站连接的主机名的逗号分隔列表。主机名是不区分大小写的,可以星号(用作通配符)开头。但是,不能在主机名中的任何其他位置使用星号。例如,*.abc.com 有效,但 *.abc.* 无效。 | |
hostNameExcludeList | string | 不允许在此端点上进行入站连接的主机名的逗号分隔列表。主机名是不区分大小写的,可以星号(用作通配符)开头。但是,不能在主机名中的任何其他位置使用星号。例如,*.abc.com 有效,但 *.abc.* 无效。 |
端点的 HTTP 访问日志记录配置。
Name | Type | Default | Description |
---|---|---|---|
enabled | 布尔型 | true | 启用访问日志记录。 |
filePath | 文件路径 | ${server.output.dir}/logs/http_access.log | 访问日志文件的目录路径和名称。指定目录路径时可以使用标准变量替换,如 ${server.output.dir}。 |
logFormat | string | %h %u %{t}W "%r" %s %b | 指定记录客户机访问信息时使用的日志格式。 |
maxFileSize | int Min: 0 | 20 | 回滚之前日志文件的最大大小,以兆字节计;值为 0 意味着无限制。 |
maxFiles | int Min: 0 | 2 | 除去最早的日志文件之前将保留的日志文件的最大数目;值为 0 意味着无限制。 |
将添加到生成的插件配置文件中 Config 元素的其他属性。IBM 支持人员可指定这些属性来修改 Web 服务器插件的行为。