创建或更新全局 Web 服务器插件配置文件

如果单元中的所有应用程序服务器使用同一台 Web 服务器将动态内容(例如 Servlet)请求从 Web 应用程序路由到应用程序服务器,那么可以为该单元创建全局 Web 服务器插件配置文件。生成的 plugin-cfg.xml 文件在 profile_root/config/cells 目录中。

开始之前

不推荐使用的功能部件 不推荐使用的功能部件: 不推荐使用以拓扑为中心的配置(也称为全局配置)。而是使用以应用程序为中心的配置,此配置更为灵活,且可为诸如智能管理的动态功能提供支持。有关更多信息,请参阅实现 Web 服务器插件depfeat
避免故障 避免故障: 不推荐使用以拓扑为中心或全局插件配置。而是按实现 Web 服务器插件中所述使用以应用程序为中心的配置。针对任何以拓扑为中心的现有配置,可以使用管理控制台或运行 GenPluginCfg 命令,更新单元中所有集群的全局 plugin-cfg.xml 文件。 然而,在更新全局 plugin-cfg.xml 文件之前,必须删除 config/cells/plugin-cfg.xml 文件。如果未删除 config/cells/plugin-cfg.xml 文件,那么只会将新属性及其值添加到全局 plugin-cfg.xml 文件。不会将对现有插件属性值的任何更新添加到全局 plugin-cfg.xml 文件。gotcha

关于此任务

每当执行下列其中一个操作时,都必须更新全局 Web 服务器插件配置文件:
  • 更改该单元包含的应用程序服务器、集群、虚拟主机或 Web 容器传输的配置设置。
  • 对该单元添加新的应用程序服务器、集群、虚拟主机或 Web 容器传输。

要更新全局 Web 服务器插件的配置设置,可以使用管理控制台中的“更新全局 Web 服务器插件配置”页面,也可以发出以下命令:

%was_profile_home%/config/cells/GenPluginCfg.sh|bat

这两种重新生成全局 Web 服务器插件配置的方法都将创建 ASCII 格式的 plugin-cfg.xml 文件。

要使用管理控制台中的“更新全局 Web 服务器插件配置”页面:

过程

  1. 单击环境 > 更新全局 Web 服务器插件配置
  2. 单击确定以更新 plugin-cfg.xml 文件。
  3. 可选: 如果要查看或下载此文件的当前版本,请单击查看或下载当前 Web 服务器插件配置文件
    如果要执行下列操作,那么可以选择此选项:
    • 在更新此文件前查看它的当前版本。
    • 在更新此文件后查看。
    • 将此文件的副本下载到远程机器。

结果

重新生成配置的操作可能要花上一点时间才能完成。完成后,管理单元中的所有对象都将使用 Web 服务器可访问的最新设置。当 Application Server 与 Web 服务器在同一台物理机器(节点)上时,重新生成插件的操作大约需要 30 到 60 秒才能完成,而无论该操作是人工触发还是自动执行。在其他情况下,此操作需要更长的时间。

由于延迟确定了新插件配置生效的速度,所以它十分重要。假设为某个 Servlet 添加了新的服务路径,然后重新生成插件配置。重新生成操作需要 40 秒才能完成,此后,用户应该能够通过新的服务路径来访问该 Servlet。

对于 HTTP 插件,延迟长度由 plugin-cfg.xml 文件中 Config 元素的“刷新时间间隔”属性确定。插件以此时间间隔轮询磁盘或文件系统以了解配置是否已更改。缺省时间间隔为 60 秒。要重新生成插件配置,需要两倍的刷新时间间隔。

对于需要频繁地在管理控制台中更改设置的开发环境,建议将刷新时间间隔设置为 3 到 5 秒。

在生产环境中,需要设置较长的刷新时间间隔(也许长达 30 分钟),这取决于更改频率。

下一步做什么

在对插件配置所做的更改生效之前,可能需要停止单元中的应用程序服务器,然后再次启动应用程序服务器。

如果正在远程机器上运行 Web 服务器,请单击查看或下载当前 Web 服务器插件配置文件plugin-cfg.xml 文件副本下载到该机器上。

当安装了 Deployment Manager 的机器对于产品安装位置来说是远程机器时,必须实现下列其中一种解决方案,以便 plugin-cfg.xml 文件在重新生成插件和进行完全同步后保留应用程序服务器目录结构,而不是采用 Deployment Manager 的目录结构。

  • 命令行
    [AIX Solaris HP-UX Linux Windows][IBM i]在命令提示符处,输入以下命令以更改安装了 Deployment Manager 的机器上的 DeploymentManager/bin 目录和类型。此命令将创建或更新 plugin-cfg.xml 文件,并将 plugin-cfg.xml 文件中的所有目录更改为 app_server_root 目录。
    GenPluginCfg -destination.root <app_server_root>
    [z/OS]在命令提示符处,输入以下命令以更改安装了 Deployment Manager 的机器上的 DeploymentManager/bin 目录和类型。此命令将创建或更新 plugin-cfg.xml 文件,并将 plugin-cfg.xml 文件中的所有目录更改为 WAS_HOME/AppServer 目录。
    GenPluginCfg.sh -destination.root WAS_HOME/AppServer

    例如,从 DeploymentManager/bin 目录中发出以下命令。

    [AIX Solaris HP-UX Linux Windows][IBM i]
    GenPluginCfg -destination.root "E:\WebSphere\AppServer"
    [z/OS]
    GenPluginCfg -destination.root "/WebSphere/V5R0M0/AppServer"
  • plugin-cfg.xml 文件

    编辑 plugin-cfg.xml 文件,以指向日志文件、密钥环和隐藏文件的正确目录结构。

    执行完全同步,以便将 plugin-cfg.xml 文件复制到所有节点。可以使用脚本或管理控制台来使单元中的节点同步。

    Deployment Manager 的 plugin-cfg.xml 文件可以指向应用程序服务器目录,而不会发生任何冲突。


指示主题类型的图标 任务主题



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