使用作业管理器为 Liberty 服务器生成合并的插件配置

可以提交为 Liberty 概要文件服务器生成合并的插件配置作业来创建单个合并的 plugin-cfg.xml 文件,该文件用于指示 Web 服务器插件将请求重定向到位于多个主机上的多个应用程序服务器。首先,该作业会在每个目标主机上生成特定于服务器的 plugin-cfg.xml 文件。然后,该作业会将作业管理器主机上特定于服务器的 plugin-cfg.xml 文件合并为一个 plugin-cfg.xml 文件。

开始之前

在目标主机上启动作业管理器和 Liberty服务器。

如果需要为 Liberty 服务器的单个实例生成 Web 服务器插件配置,请参阅有关使用 Web 服务器插件来配置 Liberty 的 Liberty 文档。

您在作业管理器中的标识必须具有管理员角色权限或操作员角色权限,才能提交作业。

向作业管理器注册目标主机时,可以保存操作系统安全性信息。将作业提交到一个或多个目标(尚未针对其保存安全性信息)时,必须指定授权的操作系统用户名,以及该用户名的密码或公用-专用密钥信息。安全凭证必须对所有作业目标有效。

此作业需要通往目标主机上 Liberty服务器的 Java™ 管理扩展 (JMX) 连接。要配置 Liberty服务器以支持 JMX 连接,请将本地连接器功能部件或 HTTP/REST 连接器功能部件添加到其 server.xml 文件。以下示例显示了 server.xml 文件的功能部件管理器元素中的本地连接器功能部件和 HTTP/REST 连接器功能部件:
<featureManager>
  <feature>localConnector-1.0</feature>
  <feature>restConnector-1.0</feature>
  ...
</featureManager>
提交作业时,如果一个或多个 Liberty服务器仅包含 HTTP/REST 连接器功能部件,那么必须指定 Liberty服务器管理员的用户名和密码。建立与服务器的 JMX 连接时,作业管理器会使用这些凭证。如果所有服务器都包含本地连接器功能部件,那么不需要指定用户名和密码。

有关定义服务器管理员的更多信息,请参阅“映射 Liberty 的管理员角色”。

Liberty 服务器需要 Java Development Kit (JDK) 或 Java 运行时环境 (JRE) 才能运行此作业。通过完成下列其中一个操作来设置 JDK 或 JRE 位置:
  • server.env 文件中将 JAVA_HOME 属性设置为 JDK 或 JRE 位置。在运行命令以便为 Liberty 服务器生成 plugin-cfg.xml 文件之前,作业会读取 JAVA_HOME 属性并在目标环境中设置该属性。
  • [AIX][HP-UX][Linux][Solaris][z/OS]在用户 .bashrc 文件中将 JAVA_HOME 属性设置为 JDK 或 JRE 位置。
  • [AIX][HP-UX][Linux][Solaris][z/OS]将 JDK 或 JRE 路径附加到 PATH 环境变量。
  • [Windows]将 JAVA_HOME 属性设置为 JDK 或 JRE 位置,作为系统环境变量。
  • [Windows]将 JDK 或 JRE 路径附加到 PATH 系统变量。

关于此任务

可以使用作业管理器或 Deployment Manager 的管理控制台来生成单个合并的 plugin-cfg.xml 文件,该文件用于指示 Web 服务器插件将请求重定向到位于多个主机上的多个 Liberty服务器。从控制台中,选择为 Liberty 服务器生成合并的插件配置作业,指定服务器和作业选项,复审摘要,然后提交作业。

这些步骤描述如何使用作业管理器控制台或 Deployment Manager 控制台来运行为 Liberty 概要文件服务器生成合并的插件配置作业。可以在 AdministrativeJobs 命令组中运行 generateMergedPluginConfigForLibertyProfileServers 作业脚本,而不是使用控制台。请参阅“管理作业类型”主题。

过程

  1. 在管理控制台的导航树中,单击作业 > 提交
  2. 选择作业以便为多个 Liberty服务器生成合并的 Web 服务器插件配置文件。
    1. 从列表中选择为 Liberty 概要文件服务器生成合并的插件配置作业类型。
    2. (可选)指定作业的描述。
    3. 单击下一步
  3. 选择作业目标。
    1. 从列表中选择目标组,或者选择目标名称

      在目标组列表中,将仅显示对所选作业类型有效的目标组。

    2. 如果已选择目标名称,请指定目标名称并单击添加,或者单击查找并在“查找目标”页面上指定所选目标。
    3. 如果在向作业管理器注册目标主机时未选择保存安全认证信息,请指定用于访问目标主机的操作系统用户名和密码或公用-专用密钥信息。安全凭证必须对所有作业目标有效。
    4. 单击下一步
  4. 为 Liberty 概要文件服务器生成合并的插件配置作业指定参数。
    1. 对于服务器,请指定服务器的资源名称或标准资源标识,或者用于确定一个或多个服务器的模式。

      如果一个服务器名称解析为多个同名服务器,那么产品会返回错误,并且不生成 plugin-cfg.xml 文件。

      例如,假定您想要为服务器指定 defaultServer。可指定下列其中一个值以确定服务器资源:

      资源名称
      defaultServer
      标准资源标识
      runtime/wlp/liberty_server/defaultServer
      资源名称模式
      *Server
      标准资源标识模式
      runtime/wlp/liberty_server/*

      要查看目标上现有 Liberty服务器的名称,请在“指定作业参数”页面上单击查找。在“查找目标资源”页面上,单击查找以查找所有目标主机上都存在的 Liberty服务器标识。选择要为其生成合并的 Web 服务器插件配置的服务器资源标识。

    2. 如果一个或多个服务器仅包含 HTTP/REST 连接器 (restConnector) 功能部件,那么对用户名指定 Liberty服务器管理员的用户名。建立与服务器的 JMX 连接时,作业管理器会使用此值。
    3. 如果一个或多个服务器仅包含 HTTP/REST 连接器 (restConnector) 功能部件,那么对密码指定 Liberty服务器管理员的密码。建立与服务器的 JMX 连接时,作业管理器会使用此值。
    4. 单击下一步
  5. 安排作业时间表。

    指定的时间和日期相对于作业管理器。

    1. (可选)指定当作业完成时发送通知的一个或多个电子邮件地址。

      如果指定了多个电子邮件地址,请使用逗号进行分隔。

    2. 选择作业何时可提交。
    3. 选择作业到期时间。
    4. (可选)指定作业的重现时间间隔、此时间间隔的起始日期和时间以及此时间间隔的结束日期和时间。
    5. 单击下一步
  6. 复审摘要并单击完成以提交作业。

结果

会在每个目标主机上生成特定于服务器的 plugin-cfg.xml 文件。然后,作业管理器会在作业管理器主机上将这些文件合并为单个合并的 plugin-cfg.xml 文件。

下一步做什么

在“作业状态”页面上,单击为 Liberty 概要文件服务器生成合并的插件配置作业的标识并查看作业状态。单击状态刷新图标 指定作业状态的刷新视图图标 以刷新所显示的状态。

如果作业成功,那么产品会将合并的 plugin-cfg.xml 文件写入 app_server_root/profiles/job_manager_profile/config/temp/JobManager/job_ID/_mergedPluginDir/ 目录。

如果作业不成功,那么作业会停止,而且当存在下列任何情况时,产品会返回错误:
  • 目标 Liberty 服务器未运行。
  • 没有为目标 Liberty服务器配置任何 JMX 连接器。
  • 作业属性未指定有效的服务器管理员凭证;需要有效的服务器管理员凭证,才能建立与仅包含 HTTP/REST (restConnector) 功能部件的目标 Liberty服务器的 JMX 连接。
查看运行作业时产生的任何错误消息,更正错误情况,然后再次提交作业。

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



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