使用此页面来查看或更改 Web 服务器插件配置文件的设置。插件配置文件 plugin_cfg.xml 提供属性以建立 Web 服务器和应用程序服务器之间的通信。
要查看此管理控制台页面,请单击服务器 > 服务器类型 > Web 服务器 > web_server_name > 插件属性。
在配置选项卡上,您可以编辑字段。在运行时选项卡上,您可以查看只读信息。
运行时选项卡仅当此 Web 服务器已访问应用程序服务器上运行的应用程序且存在 http_plugin.log 文件时可用。
指定启动时插件是否忽略配置中的 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 服务器的插件配置文件,那么清除该复选框。
由于插件配置服务在后台运行,并且与管理控制台无关,所以管理控制台无法显示自动传播结果。
对于分布式平台,可以检查 Deployment Manager SystemOut.log 文件中的相关消息以验证自动传播是否成功完成。
对于 z/OS® 平台,可以检查 TSO JOB 日志中的相关消息以验证自动传播是否成功完成。
数据类型 | 字符串 |
缺省值 | 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 设置,因为它会负面地影响性能。
错误: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 设置,因为它会负面地影响性能。
错误:ws_config_parser:handleLogEnd:无法打开日志文件 '/opt/IBM/WebSphere/Plugin/logs/sunwebserver/http_plugin.log', OS
数据类型 | 字符串 |
缺省值 | 错误 |