Web 服务器插件属性

使用此页面来查看或更改 Web 服务器插件配置文件的设置。插件配置文件 plugin_cfg.xml 提供属性以建立 Web 服务器和应用程序服务器之间的通信。

要查看此管理控制台页面,请单击服务器 > 服务器类型 > Web 服务器 > web_server_name > 插件属性

配置选项卡上,您可以编辑字段。在运行时选项卡上,您可以查看只读信息。

运行时选项卡仅当此 Web 服务器已访问应用程序服务器上运行的应用程序且存在 http_plugin.log 文件时可用。

“配置”选项卡

忽略 Web 服务器启动期间的 DNS 故障

指定启动时插件是否忽略配置中的 DNS 故障。

此字段与 plugin-cfg.xml 文件中的 IgnoreDNSFailures 元素相对应。

当设置为 true 时,如果每个 ServerCluster 中至少有一个服务器能够解析主机名,那么插件忽略配置中的 DNS 故障并成功启动。任何主机名无法解析的服务器在配置期间标记为不可用。稍后在路由请求期间不会尝试解析该主机名。如果发生 DNS 故障,那么日志消息将被写入插件日志文件,并继续插件初始化而不会导致无法启动 Web 服务器。指定了 false 时,DNS 故障导致 Web 服务器不启动。

数据类型 字符串
缺省值 false
刷新配置时间间隔

指定插件应该检查配置文件以查看是否发生更新或更改的时间间隔(以秒计)。插件检查文件自上次装入插件配置以来,是否有任何修改。

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

数据类型 整型
缺省值 60 秒。
插件配置文件名

指定插件的配置文件的文件名。缺省情况下,应用程序服务器生成 plugin-cfg.xml 文件。配置文件识别 Web 服务器的应用程序、应用程序服务器、集群和 HTTP 端口。Web 服务器使用该文件访问不同应用程序服务器上部署的应用程序。

您可以更改插件配置文件的名称。然而,如果确实更改了文件名,那么也必须将 Web 服务器配置更改为指向新的插件配置文件。

如果在安装期间选择了 Web 服务器插件,那么可能的话,安装程序配置 Web 服务器以标识 plugin-cfg.xml 文件的位置。缺省情况下,插件配置文件安装在 plugins_root/config/web_server_name 目录中。

安装程序将伪指令添加到 Web 服务器配置,该配置指定 plugin-cfg.xml 文件的位置。

对于远程 Web 服务器,必须从本地目录复制文件,应用程序服务器在该目录安装到远程机器。这已知为传播插件配置文件。如果正在使用 IBM® HTTP Server V6.1 或更高版本作为 Web 服务器,并且有有效的 HTTP 传输机制来传播文件,WebSphere® Application Server 就可以自动将插件配置文件传播到远程机器。

可以单击查看以显示当前插件配置文件的副本。

数据类型 字符串
缺省值 plugin-cfg.xml
自动生成插件配置文件
要将插件配置文件自动生成到远程 Web 服务器:
  • 必须选取此字段。
  • 必须启用插件配置服务
启用插件配置服务后,在以下情况下将自动生成 Web 服务器的插件配置文件:
  • WebSphere Application Server 管理员定义新的 Web 服务器。
  • 应用程序被部署到 Application Server 上。
  • 卸载应用程序。
  • 更新和保存虚拟主机定义。

缺省情况下,此字段已被选中。如果要手动生成此 Web 服务器的插件配置文件,那么清除该复选框。

[AIX Solaris HP-UX Linux Windows] 重要: 生成插件配置文件时,它的虚拟主机列表中未包含 admin_host。信息中心中的“允许 Web 服务器访问管理控制台”一文描述了如何将 admin_host 添加到虚拟主机列表中。
自动传播插件配置文件
指定是否要让应用程序服务器将已更改的插件配置文件副本自动传播到 Web 服务器:
  • 必须选取此字段。
  • 必须启用插件配置服务
  • 在 Network Deployment 环境中,WebSphere Application Server 的 Node Agent 必须在与已更改的插件配置文件相关联的 Web 服务器所在的节点上。
缺省情况下,此字段已被选中。
注: 仅当远程 Web 服务器是 IBMHTTP Server V6.1 或更高版本的 Web 服务器并且它的管理服务器正在运行时,才能自动地将插件配置文件传播到该 Web 服务器。

由于插件配置服务在后台运行,并且与管理控制台无关,所以管理控制台无法显示自动传播结果。

[AIX Solaris HP-UX Linux Windows] 对于分布式平台,可以检查 Deployment Manager SystemOut.log 文件中的相关消息以验证自动传播是否成功完成。

[z/OS] 对于 z/OS® 平台,可以检查 TSO JOB 日志中的相关消息以验证自动传播是否成功完成。

插件密钥库文件名
指定一个数据库文件的标准目录路径和文件名,该数据库文件包含 Web 服务器插件用于 HTTPS 请求的安全密钥环。此文件在与此 Web 服务器插件相关联的 Web 服务器上。在指定数据库文件的标准目录路径和文件名之后,可以:
  • 单击管理密钥和证书以更新此文件。
  • 单击复制到 Web 服务器密钥库目录以将此文件的副本添加到 Web 服务器的密钥库目录。
数据类型 字符串
缺省值 None
插件配置目录和文件名

指定 Web 服务器插件配置文件的 Web 服务器副本的标准路径。此路径是该文件的名称及其运行 Web 服务器的机器上的位置。

插件密钥库目录和文件名

指定包含安全密钥环的数据库文件的 Web 服务器副本标准路径。此路径是该文件的名称及其运行 Web 服务器的机器上的位置。

插件日志记录

指定 http_plugin.log 文件的位置和名称。也指定日志中消息的作用域。

日志描述由插件写的日志消息的位置和级别。如果配置文件中未指定日志,那么在一些情况下,日志消息将被写到 Web 服务器错误日志中。

在分布式平台上,如果该日志文件不存在,那么将要创建它。如果该日志文件已经存在,将以追加方式打开它,并且将保留先前的插件日志消息。

日志文件名 - 到日志文件的标准路径,插件将错误消息写入该日志文件。

数据类型 字符串
缺省值 plugins_root/logs/web_server_name/http_plugin.log

指定 http_plugin.log 文件的文件路径。

日志级别 - 插件应该写入日志的日志消息的详细信息级别。您可以为此属性指定下列某个值:
  • 跟踪。此请求过程中的全部步骤都详细记录。
  • 统计信息。记录了为每个请求选择的服务器和其他与请求处理相关的负载均衡信息。
  • 警告。所有来自异常请求处理的警告和错误消息被记录。
  • 错误。仅记录来自异常请求处理导致的错误消息。
  • 调试。记录处理请求时执行的所有关键步骤。
  • 详细信息。记录关于请求和响应的所有信息。

如果未指定日志级别,那么使用缺省值 Error

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

[AIX Solaris HP-UX Linux Windows] [iSeries] [z/OS] 重要: 如果 Web 服务器和 Web 服务器插件在 AIX®、HP-UX、Linux® 或 Solaris 系统上运行,并且在 plugin-cfg.xml 中更改了日志级别,那么此更改不会动态地生效。必须重新启动 Web 服务器才能使更改生效。例如,在 Solaris 上,如果未重新启动 Web 服务器,那么下列错误消息将出现在 Plugin_Home/logs/http_plugin.log 文件中:
错误:ws_config_parser:handleLogEnd:无法打开日志文件
'/opt/IBM/WebSphere/Plugin/logs/sunwebserver/http_plugin.log', OS
数据类型 字符串
缺省值 错误

“运行时”选项卡

插件日志记录

指定 http_plugin.log 文件的位置和名称。也指定日志中消息的作用域。

日志描述由插件写的日志消息的位置和级别。如果配置文件中未指定日志,那么在一些情况下,日志消息将被写到 Web 服务器错误日志中。

在分布式平台上,如果该日志文件不存在,那么将要创建它。如果该日志文件已经存在,将以追加方式打开它,并且将保留先前的插件日志消息。

日志文件名 - 到日志文件的标准路径,插件将错误消息写入该日志文件。

数据类型 字符串
缺省值 plugins_root/logs/web_server_name/http_plugin.log

指定 http_plugin.log 文件的文件路径。

日志级别 - 插件应该写入日志的日志消息的详细信息级别。您可以为此属性指定下列某个值:
  • 跟踪。此请求过程中的全部步骤都详细记录。
  • 统计信息。记录了为每个请求选择的服务器和其他与请求处理相关的负载均衡信息。
  • 警告。所有来自异常请求处理的警告和错误消息被记录。
  • 错误。仅记录来自异常请求处理导致的错误消息。
  • 调试。记录处理请求时执行的所有关键步骤。
  • 详细信息。记录关于请求和响应的所有信息。

如果未指定日志级别,那么使用缺省值 Error

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

[AIX Solaris HP-UX Linux Windows] [iSeries] [z/OS] 重要: 如果 Web 服务器和 Web 服务器插件在 AIX®、HP-UX、Linux® 或 Solaris 系统上运行,并且在 plugin-cfg.xml 中更改了日志级别,那么此更改不会动态地生效。必须重新启动 Web 服务器才能使更改生效。例如,在 Solaris 上,如果未重新启动 Web 服务器,那么下列错误消息将出现在 Plugin_Home/logs/http_plugin.log 文件中:
错误:ws_config_parser:handleLogEnd:无法打开日志文件
'/opt/IBM/WebSphere/Plugin/logs/sunwebserver/http_plugin.log', OS
数据类型 字符串
缺省值 错误



标有(在线)的链接要求访问因特网。

相关任务
相关参考
Web 服务器插件请求和响应优化属性
Web 服务器插件高速缓存属性
Web 服务器插件请求路由属性


文件名: uwsv_plugin_props.html