使用本主题,通过 wsadmin 工具,在灵活管理环境中提交和跟踪管理作业。
开始之前
配置作业管理器和管理代理程序,并在该作业管理器中注册节点和 Deployment Manager 以设置灵活管理环境。可选择性地创建管理组以同时向多个节点提交一个作业。
关于此任务
在配置灵活管理环境后,您可以将作业提交到已在作业管理器中注册的节点,以及监视和管理这些节点的作业。您在作业管理器中的标识必须具有管理员角色权限或操作员角色权限,才能提交作业。您在作业管理器中的标识必须具有管理员角色权限或操作员角色权限,才能提交作业。当提交作业时,可以为在目标节点上进行认证和授权指定用户名和密码。如果未在作业参数中提供用户名和密码,那么将使用作业提交者在作业管理器上的凭证来进行认证和授权。
注: 当将作业提交至多个目标节点时,提交者的用户名和密码或凭证必须适用于所有作业目标。
过程
- 启动 wsadmin 工具。 浏览至 app_server_root/bin 目录,并使用以下命令将 wsadmin 工具连接至作业管理器进程:
wsadmin -profileName myJobManager -lang jython
- 将管理作业提交到作业管理器。
使用 submitJob 命令来提交管理作业。作业提交由以下信息组成:
- 作业类型
- 作业类型指定要执行的作业的类型。在灵活管理环境中存在许多作业,其中包括应用程序管理、配置和应用程序服务器运行时控制作业。
- 作业目标列表和目标组
- 作业目标列表和组指定运行作业的节点和节点组。
- 特定于作业的参数
- 大多数管理作业需要信息以及作业类型和目标,才能运行该作业。作业参数特定于每种作业类型。
注: 当将作业提交至多个目标节点时,提交者的用户名和密码或凭证必须适用于所有作业目标。
- 可选通用参数
- 除了特定于作业的参数之外,您还可以在作业提交中包含下列任何可选参数:
表 1. submitJob 可选通用参数描述. 使用参数名前面的短划线 (-) 来指定可选参数。参数 |
描述 |
类型 |
username |
指定在安全性处于已启用状态下用于提交作业的用户名。 |
字符串 |
password |
指定在安全性处于已启用状态下用于提交作业的用户名的密码。 |
字符串 |
description |
指定作业的描述。 |
字符串 |
activationDateTime |
使用格式 "2006-05-03T10:30:45-0000" 指定作业的激活日期和时间。activationDateTime 参数值的 "-0000" 部分代表时区。您可以指定 Z 作为格林威治标准时间 (GMT) 的缩写,例如 "2006-05-03T10:30:45Z"。如果未指定时区,那么系统会使用服务器的时区。 |
字符串 |
expirationDateTime |
使用格式 "2006-05-03T10:30:45-0000" 指定作业的截止日期。expirationDateTime 参数值的 "-0000" 部分表示时区。您可以指定 Z 作为格林威治标准时间 (GMT) 的缩写,例如 "2006-05-03T10:30:45Z"。如果未指定时区,那么系统会使用服务器的时区。 |
字符串 |
executionWindow |
指定作业的重现时间间隔。 |
字符串 |
executionWindowUnit |
指定 executionWindow 参数所设置值的重现时间间隔计量单位。指定 DAILY(以每天运行作业一次)、WEEKLY(以每周运行作业一次)、MONTHLY(以每月运行作业一次)、YEARLY(以每年运行作业一次)或 CONNECTION 以便每次节点连接并轮询作业时运行作业。 |
字符串 |
email |
指定系统将作业通知发送到的电子邮件地址。 |
字符串 |
以下示例会提交作业以启动应用程序服务器。以下命令示例会提交启动应用程序作业,并将返回的作业令牌设置为
MyStartJob 变量:
myStartJob = AdminTask.submitJob('-jobType startApplication -targetList [MyNode01] -jobParams
[applicationName myApplication] -email admin@company.com')
- 可选: 监视作业状态。
使用 getOverallJobStatus 命令来显示作业的状态,如以下示例所示:
AdminTask.getOverallJobStatus('[-jobTokenList [myStartJob]]')
如果未在上一步中设置 myStartJob 变量,请对 -jobTokenList 参数指定
submitJob 命令的返回值。
此命令会返回一个或多个相关作业的作业状态信息。系统会在总体作业状态中显示以下信息:
- STATE 属性指定作业的当前状态。
- TOTAL_RESULTS 属性指定作业总数。
- DISTRIBUTED 属性指定分布式作业数。
- ASYNC_IN_PROGRESS 属性指定正在执行中的异步作业数。
- SUCCEEDED 属性指定成功作业数。
- PARTIALLY_SUCCEEDED 属性指定部分成功作业数。例如,如果一个节点表示多个服务器,但是只成功完成了该节点上的某些服务器,那么此节点就处于“部分成功”状态。
- FAILED 属性指定失败作业数。
- REJECTED 属性指定已拒绝作业数。
- NOT_ATTEMPTED 属性指定系统尚未尝试的作业数。
下一步做什么
将其他管理作业提交到作业管理器,并监视现有作业。还可以调度将来的管理作业。