[AIX Solaris HP-UX Linux Windows][z/OS]

在高可用性环境中生成插件配置

在高可用性环境中,可以配置 Web 服务器以生成插件配置。通过这样做可以确保该配置始终由单元中的一个过程生成,尽管其他过程可能不可用。

开始之前

  • 建立高可用性环境。有关更多信息,请阅读“设置高可用性环境”。
  • 使用高可用性 plugin-cfg 生成服务不会自动禁用随需应变路由器 (ODR) plugin-cfg 生成(如果已启用)。两种服务是独立的。同时启用两个服务会产生冗余;在启用高可用性 plugin-cfg 生成服务时,应禁用先前配置的任何 ODR plugin-cfg 生成。有关更多信息,请阅读“配置 ODR 以动态更新 Web 服务器插件配置”。
  • 如果对 Web 服务器启用 Intelligent Management,请勿使用为该 Web 服务器动态生成 plugin-cfg.xml 文件的选项。动态生成 plugin-cfg.xml 文件会覆盖 plugin-cfg.xml 文件中的 Intelligent Management 设置。

关于此任务

  • 为要生成的每个 plugin-cfg.xml 文件在单元级别定义一组定制属性。将定制属性格式化为 ODCPluginCfg<property>_<definitionID>=value,其中 <property> 是下列其中一个元素:
    • OdrList
    • OutputPath
    • UpdateScript
    • OdrClusterList
    • 已禁用
    <definitionID> 变量是所选配置的名称。因此,以同一 <definitionID> 变量结束的属性可定义高可用性插件配置生成服务中的单一生成定义。
注: 可与插件配置更改脚本文本框中的值使用相同的选项来设置 ODCPluginCfgUpdateScript_<definitionID> 值。有关更多信息,请阅读“配置 ODR 以动态更新 Web 服务器插件配置”。
  • 要根据需要生成 HAPluginCfgGeneration 定义,请完成下列步骤:
    1. 禁用自动生成。将单元定制属性 ODCPluginCfgDisabled_<definitionID> 设置为 true
    2. 要生成新插件,请运行以下命令:
      <WAS_HOME>/bin/wsadmin.sh -lang jython -f <WAS_HOME>/bin/manageODC.py generateHAPluginCfgs
      <generationDefinitionIDs> <nodeName> <serverName>
      其中:
      generationDefinitionIDs
      这是用逗号分隔的 HAPluginCfgGeneration 标识的列表,格式为 ODCPluginCfg_<definitionID>
      nodeName
      这是执行生成操作的节点的名称。
      serverName
      这是执行生成操作的进程名称。除了 XDAGENT 进程之外,任何 Intelligent Management 扩充进程都可以根据需要生成 HAPluginCfgs 配置。例如:
      <WAS_HOME>/bin/wsadmin.sh -lang jython -f <WAS_HOME>/bin/manageODC.py generateHAPluginCfgs
      ODCPluginCfg_1,ODCPluginCfg_2 dmgrNodeName dmgr
  • 要限制重新生成 HAPluginCfgGeneration 定义的频率,请将单元定制属性 ODCPluginCfgMinGenerationDelay 设置为表示两次生成操作之间的时间值(以分钟计)。例如:
    ODCPluginCfgMinGenerationDelay = 10
    最多可以每隔 10 分钟重新生成所配置的 HAPluginCfgGeneration 定义。如果生成器接收到通知要重新构建 pluginCfgs,那么它会延迟生成前 10 分钟写入的 pluginCfgs
  • 要限制重新生成 ODR 所生成的 plugin-cfg.xml 文件的频率,请将 JVM 属性 com.ibm.ws.odr.plugincfg.minGenerationDelay 设置为一个表示两次生成操作之间的时间值(以分钟计),然后循环使用 ODR。
  • 缺省情况下,所配置的静态运行时权重值用来将已停止的 ODR 进程包括在所生成的 plugin-cfg.xml 文件中。
  • 要根据当前的运行时权重值(始终为 0)将已停止的 ODR 进程包括在所生成的 plugin-cfg.xml 文件中,请配置下列设置:
    • 对于 HAPluginCfgGenerator,请将单元定制属性 ODCPluginCfgOdrIncludeStoppedStatic 设置为 false
    • 对于 ODR 所生成的 plugin-cfg.xml 文件,请将 JVM 属性 com.ibm.ws.odr.plugincfg.odrIncludeStoppedStatic 设置为 false,然后循环使用 ODR。

过程

  1. 在管理控制台中,单击系统管理 > 单元 > 定制属性 > 新建
  2. 定义下列定制属性:
    ODCPluginCfgOdrList_<definitionID>=cell1:node1:odr1,cell2:node2:*,[cell1:node3:odr3],[cell1:node4:odr4]
    此属性指定您要在 plugin-cfg.xml 文件中包括的 ODR。对于每个路径段,可将 (*) 符号用作有效的通配符。可将 odr1odr2 标记为主服务器。可将 odr3odr4 标记为备份服务器。
    ODCPluginCfgOutputPath_<definitionID>=/path/file_name.txt
    此属性指定 plugin-cfg.xml 文件生成后放置该文件的位置。因为您可以在单元中的任何节点上生成插件配置,所以必须确保每个节点上都存在输出目录。
    ODCPluginCfgUpdateScript_<definitionID>=/path/script <parameter1> <parameter2>
    此属性定义到您的脚本的绝对路径和要传递到定义脚本的参数。每次生成 plugin-cfg.xml 时都将调用定义的脚本。
    ODCPluginCfgOdrClusterList_<definitionID>=cell1:cluster1,cell1:cluster2,cell1:*,[cell1:cluster3],[cell1:cluster4]
    此属性指定您要在 plugin-cfg.xml 文件中包括的 ODR 的集群。对于每个路径段,可将 (*) 符号用作有效的通配符。可将 cluster1cluster2 标记为主服务器。可将 cluster3cluster4 标记为备份服务器。
    ODCPluginCfgDisabled_<definitionID>
    此属性可在没有禁用特定配置的所有属性的情况下禁用该配置的生成。缺省值是 false
    ODCPluginCfgOdrSessionIdCookie_<definitionID>
    在使用 ODR 单元亲缘关系时,定义用于维护 IBM® HTTP Server/ODR 亲缘关系的 cookie 的名称。
    ODCPluginCfgIHSConfigProperties_<definitionID>
    此属性可用于替换配置 JVM 属性(正如在非 HA plugin-cfg.xml 生成中那样)以设置特定于 IBM HTTP Server 的配置属性。此属性的值是以逗号分隔的 ATTRIBUTE_NAME=value 对的列表,其中,ATTRIBUTE_NAMEplugin-cfg.xml 中表示的属性的名称。

    例如,如果使用配置名称 1,那么将创建具有值 TrustedProxyEnable=true,LogLevel=INFO,CloneSeparatorChange=true,ServerIOTimeout=60的名为 ODCPluginCfgIHSConfigProperties_1 的单元属性,以设置生成的 plugin-cfg.xml 中包含的 TrustedProxyEnableLogeLevelCloneSeparatorChangeServerIOTimeout 属性。

    ODCPluginCfgTrustedProxyList_<definitionID>=trustedproxy1,trustedproxy2
    此属性用于指定您要在 plugin-cfg.xml 文件中包括的可信代理。
    有关有效属性名称和值的列表,请参阅“控制 plugin-cfg.xml 文件的生成”。
设置下列单元定制属性以生成不在 ODR 集群中的 ODR 集合的插件配置。注意,所有以 _1 结束的属性将捆绑在一起成为一个单一的配置。
表 1. 用于生成不在某个集群中的 ODR 的插件配置的定制属性。
属性名 属性值 描述

ODCPluginCfgOdrList_1

myCell:*:*

生成将路由到 myCell 单元中所有 ODR 的插件配置。

ODCPluginCfgOutputPath_1

/tmp/plugin-cfg1.xml

将生成的插件配置写入到 /tmp/plugin-cfg1.xml 文件中。

ODCPluginCfgUpdateScript_1

/root/bin/pluginCfgUpdate1

每次更新 /tmp/plugin-cfg1.xml 文件时,都将调用指向该脚本的路径。

设置下列定制属性以生成名为 myCell/myOdrCluster 的 ODR 的集群的插件配置。注意,所有以 _2 结束的属性将捆绑在一起成为一个单一的配置。
表 2. 用于生成 myCell/myOdrCluster 的插件配置的定制属性
属性名 属性值 描述

ODCPluginCfgOdrClusterList_2

myCell:myOdrCluster

生成将路由到 myCell 单元中 myOdrCluster 集群的所有 ODR 的插件配置。

ODCPluginCfgOutputPath_2

/tmp/plugin-cfg2.xml

将生成的插件配置写入到 /tmp/plugin-cfg2.xml 文件中。

ODCPluginCfgUpdateScript_2

/root/bin/pluginCfgUpdate2

指向每次更新 /tmp/plugin-cfg2.xml 文件时运行的脚本的路径。

ODCPluginCfgOdrIncludeStopped_2

true 或 false

包括或排除停止的 ODR。

下一步做什么

因为可在单元中的任何节点上生成 plugin-cfg.xml 文件,所以您可以确定在其中运行生成服务的特定位置。

在管理控制台中,单击运行时操作 > 组件稳定性 > 核心组件。验证 HAPluginCfgGenerator 是否显示在该表中。


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



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