使用 wsadmin 脚本编制的 AdminTask 对象的 JobManager节点命令组 (不推荐)

要通过 wsadmin 工具管理作业管理器设置，可以使用 Jython 脚本编制语言来实现。 使用 JobManagerNode 组中的命令和参数来向作业管理器注册没有包含管理代理程序的目标。

不推荐使用的功能: 不推荐使用作业管理器。 请使用 Urban Code Deploy 来安装产品、部署应用程序以及管理远程主机，而不要使用作业管理器。 要管理 WebSphere® Application Server 安装，您还可以使用切换概要文件。 请参阅 在产品安装之间切换概要文件。

使用命令名中具有 Target 的命令：cleanupTarget、queryTargets、getTargetProperties、modifyTargetProperties 和 getTargetKeys。 这些命令替换命令名中具有 ManagedNode 的不推荐命令。

不推荐使用的功能: JobManager节点命令组中的命令名称中包含 ManagedNode 并且在 WebSphere Application Server V 8.0 中不推荐使用的命令包括 cleanupManagedNode， queryManagedNodes， getManagedNodeProperties， modifyManagedNodeProperties和 getManagedNodeKeys。 请改用命令名中具有 Target 的命令。
使用下列命令来管理和查询受管节点、目标以及资源配置：

cleanupManagedNode（不推荐使用）

cleanupManagedNode 命令清除受管节点的注册信息。 如果系统从作业管理器中移除节点时发生故障，请使用此命令来显式清除作业管理器上的注册信息。 该命令不会移除该节点的作业历史记录。 正在运行的作业将继续运行，但不会为该节点启动新作业。

目标对象

无。

必需参数

-managedNodeName
指定相关节点的名称。 （字符串，必需）

返回值

该命令返回系统已清除的作业管理器的 UUID。

批处理方式示例用法

  • 使用 Jython 字符串：
    AdminTask.cleanupManagedNode('-managedNodeName Node1')
  • 使用 Jython 列表：
    AdminTask.cleanupManagedNode(['-managedNodeName', 'Node1'])

交互方式示例用法

  • 使用 Jython：
    AdminTask.cleanupManagedNode('-interactive')

cleanupTarget

cleanupTarget 命令清除目标的注册信息。 如果系统从作业管理器中移除目标时发生故障，请使用此命令来显式清除作业管理器上的注册信息。 该命令不会移除该目标的作业历史记录。 运行中的作业继续运行，但是不会为该目标启动新作业。

目标对象

无。

必需参数

-targetName
指定相关目标的名称。 （字符串，必需）

返回值

该命令返回系统已清除的作业管理器的 UUID。

批处理方式示例用法

  • 使用 Jython 字符串：
    AdminTask.cleanupTarget('-targetName Target1')
  • 使用 Jython 列表：
    AdminTask.cleanupTarget(['-targetName', 'Target1'])

交互方式示例用法

  • 使用 Jython：
    AdminTask.cleanupTarget('-interactive')

getContexts

getContexts 命令显示管理模型（包括节点和服务器）中的所有上下文。

目标对象

无。

必需参数

无。

返回值

该命令返回所有上下文路径的列表。

批处理方式示例用法

  • 使用 Jython 字符串：
    AdminTask.getContexts()
  • 使用 Jython 列表：
    AdminTask.getContexts()

交互方式示例用法

  • 使用 Jython：
    AdminTask.getContexts('-interactive')

getManagedNodeKeys（不推荐使用）

getManagedNodeKeys 命令显示要用来查询受管节点的关键字（包括 name、alias 和 uuid 这些关键字）。

目标对象

无。

可选参数

-managedNodeName
指定相关节点的名称。 （字符串，可选）

返回值

该命令返回关键字的列表。

批处理方式示例用法

  • 使用 Jython 字符串：
    AdminTask.getManagedNodeKeys('-managedNodeName Node1')
  • 使用 Jython 列表：
    AdminTask.getManagedNodeKeys(['-managedNodeName', 'Node1'])

交互方式示例用法

  • 使用 Jython：
    AdminTask.getManagedNodeKeys('-interactive')

getTargetKeys

getTargetKeys 命令显示要用来查询目标的关键字（包括 name、alias 和 uuid 这些关键字）。

目标对象

无。

可选参数

-targetName
指定相关目标的名称。 （字符串，可选）

返回值

该命令返回关键字的列表。

批处理方式示例用法

  • 使用 Jython 字符串：
    AdminTask.getTargetKeys('-targetName Target1')
  • 使用 Jython 列表：
    AdminTask.getTargetKeys(['-targetName', 'Target1'])

交互方式示例用法

  • 使用 Jython：
    AdminTask.getTargetKeys('-interactive')

getManagedNodeProperties（不推荐使用）

getManagedNodeProperties 命令显示一个或多个受管或非受管节点的属性。

目标对象

无。

可选参数

-managedNodeNameList
指定相关节点的名称列表。 (字符串 [] ，可选)

返回值

该命令为通过 -managedNodeNameList 参数指定的每个节点返回属性列表。

批处理方式示例用法

  • 使用 Jython 字符串：
    AdminTask.getManagedNodeProperties('-managedNodeNameList "[Node1 Node2]"')
  • 使用 Jython 列表：
    AdminTask.getManagedNodeProperties(['-managedNodeNameList', '[Node1 Node2]'])

交互方式示例用法

  • 使用 Jython：
    AdminTask.getManagedNodeProperties('-interactive')

getTargetProperties

getTargetProperties 命令显示一个或多个目标的属性。

目标对象

无。

可选参数

-targetNameList
指定相关目标的名称列表。 (字符串 [] ，可选)

返回值

该命令为通过 -targetNameList 参数指定的每个目标返回属性列表。

批处理方式示例用法

  • 使用 Jython 字符串：
    AdminTask.getTargetProperties('-targetNameList "[Target1 Target2]"')
  • 使用 Jython 列表：
    AdminTask.getTargetProperties(['-targetNameList', '[Target1 Target2]'])

交互方式示例用法

  • 使用 Jython：
    AdminTask.getTargetProperties('-interactive')

getManagedResourceProperties

getManagedResourceProperties 命令显示一个或多个受管资源的属性。 受管资源是节点上下文或服务器上下文中的实例。 例如，在服务器上下文中，可以具有受管资源 server1、server2 或 server3。

目标对象

无。

必需参数

-resourceIdList
为相关资源指定唯一标识列表。 （字符串，可选）

返回值

该命令为每个受管资源返回属性列表。

批处理方式示例用法

  • 使用 Jython 字符串：
    AdminTask.getManagedResourceProperties('-resourceIdList AppSrv01-BASE-b83dc35c-69d4-40af-af60-127de7002cfb
/nodes/myNode/servers/server1')
  • 使用 Jython 列表：
    AdminTask.getManagedResourceProperties('-resourceIdList', 'AppSrv01-BASE-b83dc35c-69d4-40af-af60-127de7002cfb
/nodes/myNode/servers/server1')

交互方式示例用法

  • 使用 Jython：
    AdminTask.getManagedResourceProperties('-interactive')

getManagedResourcePropertyKeys

getManagedResourcePropertyKeys 命令显示特定类型的受管资源的属性关键字。

目标对象

无。

必需参数

-resourceType
指定相关受管资源的类型。 （字符串，必需）

返回值

该命令为特定资源类型返回受管资源关键字的列表。

批处理方式示例用法

  • 使用 Jython 字符串：
    AdminTask.getManagedResourcePropertyKeys('-resourceType server')
  • 使用 Jython 列表：
    AdminTask.getManagedResourcePropertyKeys('-resourceType', 'server')

交互方式示例用法

  • 使用 Jython：
    AdminTask.getManagedResourcePropertyKeys('-interactive')

getManagedResourceTypes

getManagedResourceTypes 命令显示每个受管资源类型。

目标对象

无。

必需参数

无。

返回值

该命令返回受管资源类型的列表。

批处理方式示例用法

  • 使用 Jython 字符串：
    AdminTask.getManagedResourceTypes()
  • 使用 Jython 列表：
    AdminTask.getManagedResourceTypes()

交互方式示例用法

  • 使用 Jython：
    AdminTask.getManagedResourceTypes('-interactive')

modifyManagedNodeProperties（不推荐使用）

modifyManagedNodeProperties 命令替换受管节点配置中的属性。 如果受管节点具有管理代理程序，那么该命令仅修改 alias 属性。 如果受管节点不具有管理代理程序，那么该命令会替换所有属性。

目标对象

无。

必需参数

-managedNodeName
指定相关节点的名称。 （字符串，必需）
-managedNodeProps
指定要为相关节点修改的“名称/值”属性对。 （属性，必需）

可选参数

-replace
指定是否要替换现有属性。 指定 true 以替换现有属性。 指定 false 以合并这些属性。 缺省值为 false。 （布尔值，可选）

返回值

此命令不会返回输出。

批处理方式示例用法

  • 使用 Jython 字符串：
    AdminTask.modifyManagedNodeProperties('-managedNodeName Node1 -managedNodeProps "[alias myNewAlias]"')
  • 使用 Jython 列表：
    AdminTask.modifyManagedNodeProperties('-managedNodeName', 'Node1', '-managedNodeProps', '[alias myNewAlias]')

交互方式示例用法

  • 使用 Jython：
    AdminTask.modifyManagedNodeProperties('-interactive')

modifyTargetProperties

modifyTargetProperties 命令替换目标配置中的属性。 如果目标具有管理代理程序，那么该命令仅修改 alias 属性。 如果目标不具有管理代理程序，那么该命令会替换所有属性。

目标对象

无。

必需参数

-targetName
指定相关目标的名称。 （字符串，必需）
-targetProps
指定要为相关目标修改的“名称/值”属性对。 （属性，必需）

可选参数

-replace
指定是否要替换现有属性。 指定 true 以替换现有属性。 指定 false 以合并这些属性。 缺省值为 false。 （布尔值，可选）

返回值

此命令不会返回输出。

批处理方式示例用法

  • 使用 Jython 字符串：
    AdminTask.modifyTargetProperties('-targetName Target1 -targetProps "[alias myNewAlias]"')
  • 使用 Jython 列表：
    AdminTask.modifyTargetProperties('-targetName', 'Target1', '-targetProps', '[alias myNewAlias]')

交互方式示例用法

  • 使用 Jython：
    AdminTask.modifyTargetProperties('-interactive')

queryManagedNodes（不推荐使用）

queryManagedNodes 命令根据查询表达式搜索受管节点。 如果未指定查询表达式，那么该命令返回所有受管节点。

目标对象

无。

必需参数

-maxReturn
指定要返回的最大受管节点数。 （整数，必需）

可选参数

-query
指定由一个或多个以空格分隔的查询表达式组成的查询。 如果未指定此参数，那么该命令返回所有受管节点。 （字符串，可选）
请根据下列准则来构造查询：
  • 每个查询表达式都由 key、operator 和 value 这些元素组成。
  • 支持以下运算符：
    表 1。 queryManaged节点-查询运算符。 在查询中使用运算符。
    字符 值
    = 等于。 使用 = NULL指定该值为空。
    != 不等于。 使用 != NULL 指定该值不为空
    > 大于
    < 小于
    >= 大于等于
    <= 小于或等于
  • 可以指定某个值或用逗号分隔的多个值。
  • 可使用模式匹配来指定值。
-validate
指定是否验证搜索查询。 （布尔值，可选）

返回值

该命令返回查询找到的匹配项数。 其次，该命令返回符合搜索查询条件的受管节点列表。

批处理方式示例用法

  • 使用 Jython 字符串：
    AdminTask.queryManagedNodes('-maxReturn 20 -query "managedNodeName=Node1" -validate true')
  • 使用 Jython 列表：
    AdminTask.queryManagedNodes(['-maxReturn', '20', '-query', 'managedNodeName=Node1', '-validate', 'true'])

交互方式示例用法

  • 使用 Jython：
    AdminTask.queryManagedNodes('-interactive')

queryTargets

queryTargets 命令根据查询表达式搜索目标。 如果未指定查询表达式，那么该命令返回所有目标。

目标对象

无。

必需参数

-maxReturn
指定要返回的最大目标数目。 （整数，必需）

可选参数

-query
指定由一个或多个以空格分隔的查询表达式组成的查询。 如果未指定此参数，那么该命令返回所有目标。 （字符串，可选）
请根据下列准则来构造查询：
  • 每个查询表达式都由 key、operator 和 value 这些元素组成。
  • 支持以下运算符：
    表 2。 queryTargets -query 运算符。 在查询中使用运算符。
    字符 值
    = 等于。 使用 = NULL指定该值为空。
    != 不等于。 使用 != NULL 指定该值不为空
    > 大于
    < 小于
    >= 大于等于
    <= 小于或等于
  • 可以指定某个值或用逗号分隔的多个值。
  • 可使用模式匹配来指定值。
-validate
指定是否验证搜索查询。 （布尔值，可选）

返回值

该命令返回查询找到的匹配项数。 其次，该命令返回符合搜索查询条件的目标列表。

批处理方式示例用法

  • 使用 Jython 字符串：
    AdminTask.queryTargets('-maxReturn 20 -query "targetName=target1" -validate true')
  • 使用 Jython 列表：
    AdminTask.queryTargets(['-maxReturn', '20', '-query', 'targetName=target1', '-validate', 'true'])

交互方式示例用法

  • 使用 Jython：
    AdminTask.queryTargets('-interactive')

queryManagedResources

queryManagedResources 命令根据查询表达式为特定受管节点查询受管资源。

目标对象

无。

必需参数

-maxReturn
指定要返回的最大受管资源数。 （整数，必需）

可选参数

-query
指定由一个或多个以空格分隔的查询表达式组成的查询。 如果未指定此参数，那么该命令返回所有受管节点。 （字符串，可选）
请根据下列准则来构造查询：
  • 每个查询表达式都由 key、operator 和 value 这些元素组成。
  • 支持以下运算符：
    表 3。 queryManagedResources -query 运算符。 在查询中使用运算符。
    字符 值
    = 等于。 使用 = NULL指定该值为空。
    != 不等于。 使用 != NULL 指定该值不为空
    > 大于
    < 小于
    >= 大于等于
    <= 小于或等于
  • 可以指定某个值或用逗号分隔的多个值。
  • 可使用模式匹配来指定值。
-validate
指定是否验证搜索查询。 （布尔值，可选）

返回值

该命令返回查询找到的匹配项数。 其次，该命令返回符合搜索查询条件的受管节点的 UUID 列表。

批处理方式示例用法

  • 使用 Jython 字符串：
    AdminTask.queryManagedResources('-maxReturn 20 -query "alias=managedNode1"')
  • 使用 Jython 列表：
    AdminTask.queryManagedResources('-maxReturn', '20', '-query', '"alias=managedNode1"')

交互方式示例用法

  • 使用 Jython：
    AdminTask.queryManagedResources('-interactive')

registerHost

registerHost 命令向作业管理器定义远程主机目标。 使用 registerHost 命令可执行以下操作:

  • 向作业管理器注册远程主机目标。 与 WebSphere Application Server 概要文件以及在 Deployment Manager 或管理代理程序上使用 registerWithJobManager 命令注册的目标不同，远程主机目标不需要安装任何 WebSphere Application Server 产品。 除了操作系统，此主机没有其他软件需求。
  • 收集远程主机的清单。 成功完成 registerHost 命令之后，即可使用有关受管资源和作业类型的信息。

可以像使用通过 registerWithJobManager 来注册的目标一样使用远程主机目标，但适用于远程主机目标的作业类型会有所不同。

目标对象

无。

必需参数

-host
指定要向作业管理器注册的远程计算机的名称。 （字符串，必需）
-hostProps
指定主机的属性。 可以定义想要的任何属性。 表中定义的属性会影响命令的行为。 （字符串，必需）
表 4。 registerHost -hostProps 定义的属性。 您可以为 registerHost 命令指定一个或多个已定义的属性，也可以为该命令指定未定义的属性。
属性名 属性描述
osType 操作系统类型。 指定 osType 以使此命令能够更快完成。 此可选属性确定与主机连接的方式。 有效值为：
  • aix
  • hpux
  • os400
  • linux
  • solaris
  • Windows
  • os390
用户名 具有登录主机权限的用户。 此属性是必需的。
密码 给定用户名的密码。 必须指定 password 或 privateKeyFile 的值。 如果主机不需要密码，那么可指定空字符串值 ""。
privateKeyFile 专用密钥文件的路径。 如果未指定 password 值，那么必须指定 privateKeyFile 的值。
口令 privateKeyFile 的口令（如果必要）。
saveSecurity 指定是否使用主机存储安全性属性（username、password、privateKeyFile 和 passphrase）并将这些属性用作提交作业的缺省值。 如果此属性的值给定为 true，那么会使用主机存储这些安全性属性，并且会在后续向此主机提交作业时使用这些属性。

可选参数

-imDataLocations
输入 Installation Manager 数据位置的标准路径。 可以输入用分号分隔的多个路径。 如果目标上有非缺省 Installation Manager 数据位置，那么此属性很有用。 例如，如果安装 Installation Manager 时指定了数据位置，那么 CIM 的清单作业可能找不到非缺省数据位置。 因此，注册主机时可能需要指定其他数据位置。 如果指定了无效的数据位置，那么该数据位置将不会予以保存。 如果清单作业可以检测到指定的数据位置，那么该数据位置将不会予以保存。 您也可以使用“查找数据位置”作业来搜索系统上的数据位置。 “查找数据位置”作业会自动更新此属性。 例如：
AdminTask.registerHost('[-host hostname -hostProps [ [imDataLocations datalocation1; datalocation2] 
[password ****] [saveSecurity true] [username username] ]]')
可以使用 registerHost 命令来指定 Liberty 变量的路径；例如：
AdminTask.registerHost('-host hostname -hostProps [ [username admin][password password][saveSecurity true]
 [WLP_WORKING_DIR C:/working][WLP_SHARED_DIR C:/shared][WLP_ADDITIONAL_DIRS C:/addl] ]')

返回值

该命令会返回远程主机的清单。

批处理方式示例用法

  • 使用 Jython 字符串：
    AdminTask.registerHost('-host myHost.acme.com -hostProps [ [osType linux][username root]
 [privateKeyFile /root/.ssh/id_dsa] [passphrase myPassphrase] [saveSecurity true] ]')
  • 使用 Jython 列表：
    AdminTask.registerHost('-host', 'myHost.acme.com', '-hostProps', '[ [osType linux] [username root]
 [privateKeyFile /root/.ssh/id_dsa] [passphrase myPassphrase] [saveSecurity true]' ]')

交互方式示例用法

  • 使用 Jython：
    AdminTask.registerHost('-interactive')

unregisterHost

unregisterHost 命令会将远程主机从作业管理器移除。 使用 unregisterHost 命令从作业管理器注销远程主机目标。 注销主机后，作业管理器无法在目标上运行作业。

目标对象

无。

必需参数

-host
指定要从作业管理器注销的远程计算机的名称。 （字符串，必需）

可选参数

无

返回值

无

批处理方式示例用法

  • 使用 Jython 字符串：
    AdminTask.unregisterHost('-host myHost.acme.com')
  • 使用 Jython 列表：
    AdminTask.unregisterHost('-host', 'myHost.acme.com')

交互方式示例用法

  • 使用 Jython：
    AdminTask.unregisterHost('-interactive')