Web 服务器插件属性

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

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

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

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

注: 本主题引用了一个或多个应用程序服务器日志文件。作为另一种建议采用的方法,您可以在分布式系统和 IBM® i 系统上配置服务器以使用高性能可扩展日志记录 (HPEL) 记录和跟踪基础结构,而不使用 SystemOut.logSystemErr.logtrace.logactivity.log 文件。您还可以将 HPEL 与本机 z/OS® 日志记录设施结合使用。如果要使用 HPEL,那么可从服务器概要文件 bin 目录使用 LogViewer 命令行工具来访问所有日志和跟踪信息。有关使用 HPEL 的更多信息,请参阅有关使用 HPEL 对应用程序进行故障诊断的信息。

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

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

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

将值设置为 true 时,如果每个 ServerCluster 中至少有一个服务器能够解析主机名,那么插件忽略配置中的 DNS 故障并成功启动。如果无法解析服务器主机名,那么此配置接下来被标记为不可用。路由请求期间不会再尝试解析此主机名。如果发生 DNS 故障,那么系统会向插件日志文件写入一条消息,并且插件初始化进程会继续。

缺省情况下,此值为 false 时,DNS 故障会导致插件不初始化并且请求会失败。但是,Web 服务器会启动。

信息
数据类型 String
缺省 False

刷新配置时间间隔

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

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

信息
数据类型 整数
缺省 60 秒。

插件配置文件名

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

避免故障 避免故障: 此字段处于禁用状态并且无法更改,但将显示值以仅供参考。gotcha

如果期望使用其他位置,那么需要重新运行插件配置工具 (PCT) 以定义新位置,然后运行 WebSphere Application Server 机器上的安装进程所生成的新 configureWebserver 脚本。

如果在安装期间选择了 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 就可以自动将插件配置文件传播到远程机器。

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

信息
数据类型 String
缺省 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 服务器的密钥库目录。
信息
数据类型 String
缺省值

插件配置目录和文件名

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

避免故障 避免故障: 此字段处于禁用状态并且无法更改,但将显示值以仅供参考。gotcha

插件密钥库目录和文件名

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

避免故障 避免故障: 此字段处于禁用状态并且无法更改,但将显示值以仅供参考。gotcha

插件日志记录

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

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

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

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

信息
数据类型 String
缺省 plugins_root/logs/web_server_name/http_plugin.log

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

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

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

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

[AIX Solaris HP-UX Linux Windows][IBM i][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
信息
数据类型 String
缺省 错误

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



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=uwsv_plugin_props
文件名:uwsv_plugin_props.html