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 行为异常,那么这些消息很有用。
参考主题