Web 服务器插件 (pluginConfiguration)

生成 Web 服务器插件配置文件时使用的属性

属性名称 数据类型 缺省值 描述
connectTimeout 精度为秒的时间段 5s 标识应用程序服务器应保持与 Web 服务器的连接的最长时间。 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
extendedHandshake 布尔型 False 如果为 true,那么 Web 服务器插件使用扩展握手来确定应用程序服务器是否正在运行。
httpEndpointRef 对顶级 httpEndpoint 元素的引用(字符串)。 defaultHttpEndpoint 指定要包括在已生成 plugin-cfg.xml 文件中的 HTTP 端点的标识。该端点在集群中定义服务器。缺省值为“defaultHttpEndpoint”。
ipv6Preferred 布尔型 False 在解析应用程序服务器主机名 {null} 或 {0} 时使用,以尽可能优先使用地址的类型
logDirLocation 目录路径   不推荐:指示 http_plugin.log 文件所在的目录。请参阅“日志文件名”。
logFileName 文件路径 ${pluginInstallRoot}/logs/${webserverName}/http_plugin.log Web 服务器插件日志文件的标准路径。目录成分必须已存在。对于基于 Apache 的 Web 服务器,以竖线字符开头的路径将解释为外部管道记录器。如果指定了此项,那么路径将覆盖 logDirLocation。
pluginInstallRoot 字符串 /opt/IBM/WebSphere/Plugins Web 服务器主机的文件系统中的 Web 服务器插件安装位置
serverIOTimeout 精度为秒的时间段 900s 标识 Web 服务器插件等待发送请求或从应用程序服务器接收响应的最长时间。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
serverIOTimeoutRetry 整型

最小值:-1

最大值:65535

-1 限制读取或写入超时之后的请求重试次数。缺省值 {-1} 表示无其他限制,因此重试次数由集群中的可用服务器数目限制。{0} 值表示不应重试。此值的作用域限定于服务器集群,而不会应用于因为 HTTP 插件连接超时或 Web 套接字超时而发生的连接故障或超时。
sslCertlabel 字符串   指定密钥环中证书的标签,当 Web 容器从插件请求客户机证书时,将使用此标签。
sslKeyringLocation 字符串 ${pluginInstallRoot}/config/${webserverName}/plugin-key.kdb Web 服务器主机上 SSL 密钥环文件的标准路径
sslStashfileLocation 字符串 ${pluginInstallRoot}/config/${webserverName}/plugin-key.sth Web 服务器主机上 SSL 存储文件的标准路径
waitForContinue 布尔型 False 如果为 false(缺省值),那么 Web 服务器插件使用具有消息体的 HTTP 请求来发送“Expect: 100-continue”头。如果设置为 true,那么 Web 服务器插件使用每个 HTTP 请求发送“Expect: 100-continue”头。如果 Web 服务器与应用程序服务器之间有防火墙,并且您对没有请求主体的请求重试很敏感,请考虑将此值设置为 true。
webserverName 字符串 webserver1 将使用此配置的 Web 服务器的名称。用于生成插件日志文件位置(如果未由日志文件名或目录明确指定)。
webserverPort 整型

最小值:-1

最大值:65535

80 Web 服务器 HTTP 端口
webserverSecurePort 整型

最小值:-1

最大值:65535

443 Web 服务器 HTTPS 端口
wsServerIOTimeout 精度为秒的时间段   确定 Web 服务器插件等待发送请求或从应用程序服务器接收 websocket 响应的最长时间。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
wsServerIdleTimeout 精度为秒的时间段   确定 Web 服务器插件等待终止空闲 websocket 连接的最长时间。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
httpEndpoint
描述:指定要包括在已生成 plugin-cfg.xml 文件中的 HTTP 端点的标识。该端点在集群中定义服务器。缺省值为“defaultHttpEndpoint”。
必需:False
数据类型:
属性名称 数据类型 缺省值 描述
accessLoggingRef 对顶级 httpAccessLogging 元素的引用(字符串)。   端点的 HTTP 访问日志记录配置。
enabled 布尔型 true 切换端点的可用性。值为 true 时,分派器将激活此端点以处理 HTTP 请求。
主机 字符串 localhost 客户机用于请求资源的 IP 地址、带域名后缀的域名服务器 (DNS) 主机名,或仅 DNS 主机名。可使用“*”来表示所有可用网络接口。
httpOptionsRef 对顶级 httpOptions 元素的引用(字符串)。 defaultHttpOptions 端点的 HTTP 协议选项。
httpPort 整型

最小值:-1

最大值:65535

  用于客户机 HTTP 请求的端口。使用 -1 来禁用此端口。
httpsPort 整型

最小值:-1

最大值:65535

  用于通过 SSL (https) 来保护的客户机 HTTP 请求的端口。使用 -1 来禁用此端口。
onError
  • IGNORE
  • FAIL
  • WARN
WARN 启动端点失败后要执行的操作。
IGNORE
服务器在引发配置错误时将不会发出任何警告和错误消息。
FAIL
服务器在第一次发生错误时将发出警告或错误消息,然后停止服务器。
WARN
服务器在引发配置错误时将发出警告和错误消息。
sslOptionsRef 对顶级 sslOptions 元素的引用(字符串)。   端点的 SSL 协议选项。
tcpOptionsRef 对顶级 tcpOptions 元素的引用(字符串)。 defaultTCPOptions 端点的 TCP 协议选项。
httpEndpoint > accessLogging
描述:端点的 HTTP 访问日志记录配置。
必需:False
数据类型:
属性名称 数据类型 缺省值 描述
enabled 布尔型 true 启用访问日志记录。
filePath 文件路径 ${server.output.dir}/logs/http_access.log 访问日志文件的目录路径和名称。指定目录路径时可以使用标准变量替换,如 ${server.output.dir}。
logFormat 字符串 %h %u %{t}W "%r" %s %b 指定在日志记录客户机访问信息时所使用的日志格式。
maxFileSize 整型

最小值:0

20 回滚之前日志文件的最大大小,以兆字节计;值为 0 时意味着无限制。
maxFiles 整型

最小值:0

2 移除最旧的日志文件之前将保留的最大日志文件数;值为 0 时意味着无限制。
httpEndpoint > httpOptions
描述:端点的 HTTP 协议选项。
必需:False
数据类型:
属性名称 数据类型 缺省值 描述
keepAliveEnabled 布尔型 true 启用持续连接(HTTP 保持活动)。如果为 true,那么连接将保持活动状态,以供多个顺序请求和响应复用。如果为 false,那么发送响应之后会关闭连接。
maxKeepAliveRequests 整型

最小值:-1

100 启用持续连接时,单个 HTTP 连接上可接受的最大持续请求数。值为 -1 时意味着不受限制。
persistTimeout 精度为秒的时间段 30s 将允许套接字在两个请求之间保持空闲的时间量。仅当启用持续连接时,此设置才适用。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
readTimeout 精度为秒的时间段 60s 发生第一次读取之后,用于等待读请求在套接字上完成的时间量。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
removeServerHeader 布尔型 False 从 HTTP 头中移除服务器实现信息,并且还要禁用缺省 Liberty 概要文件欢迎页面。
writeTimeout 精度为秒的时间段 60s 响应数据的每个部分在套接字上等待传输的时间量。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
httpEndpoint > sslOptions
描述:端点的 SSL 协议选项。
必需:False
数据类型:
属性名称 数据类型 缺省值 描述
sessionTimeout 精度为秒的时间段 1d 用于等待读或写请求在套接字上完成的时间量。特定于协议的超时将覆盖此值。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
sslRef 对顶级 ssl 元素的引用(字符串)。   缺省 SSL 配置指令表。缺省值为 defaultSSLSettings。
suppressHandshakeErrors 布尔型 False 禁止记录 SSL 握手错误。正常操作期间可能会发生 SSL 握手错误,但是如果 SSL 行为异常,那么这些消息很有用。
httpEndpoint > tcpOptions
描述:端点的 TCP 协议选项。
必需:False
数据类型:
属性名称 数据类型 缺省值 描述
inactivityTimeout 具有毫秒精度的时间段 60s 用于等待读或写请求在套接字上完成的时间量。特定于协议的超时将覆盖此值。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,将 500 毫秒指定为 500ms。可以将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
soReuseAddr 布尔型 true 允许立即重新绑定到没有任何处于活动状态的侦听器的端口。

用于指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: Friday, 16 September 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=rwlp_config_pluginConfiguration
文件名:rwlp_config_pluginConfiguration.html