使用 wsadmin 脚本编制的管理作业类型
在灵活管理环境中,可以使用 wsadmin 工具来将管理作业提交至作业管理器。本主题提供有关管理作业、作业参数和样本命令语法的详细信息。
在灵活管理环境中,可以配置管理代理程序和作业管理器,以将作业提交至配置中的多个目标或目标组。然后,可以将管理作业提交至受管环境中的队列作业。每个管理作业都具有对应的作业类型,它定义用于提交该作业的必需参数。可以使用 AdministrativeJobs 命令组中的命令来将管理作业提交至作业管理器。
可以提交管理作业以管理应用程序。
所有作业类型的常见参数
- 必需参数
- 每个 submitJob 命令均至少需要 jobType 参数。许多 submitJob 命令也需要 targetList 或 jobParams 参数:
表 1. submitJob 必需参数描述. 以其必需参数运行 submitJob 命令。 参数 描述 类型 jobType 指定要执行的作业的类型。灵活管理环境中存在许多作业类型,其中包括应用程序管理、产品维护、配置和应用程序服务器运行时控制作业。 String targetList 指定要在其中运行作业的一个或多个受管目标。 String jobParams 指定配置信息及作业类型和目标才能运行作业。作业参数特定于每种作业类型。 String - 可选通用参数
- 除了特定于作业的参数之外,您还可以在作业提交中包含下列任何可选参数:
表 2. submitJob 可选通用参数描述. 以其必需参数及适合于您情况的可选参数运行 submitJob 命令。 参数 描述 类型 group 指定在其中运行作业的受管目标组的名称。 String username 指定运行作业时要在目标处使用的用户名。如果未指定用户名和密码,但是启用了安全性,那么会使用作业管理器上的用户标识。 String password 指定运行作业时要在目标处使用的用户名的密码。如果未指定用户名和密码,但是启用了安全性,那么会使用作业管理器上的用户标识。 String privateKeyFile 指定运行作业时要在目标处使用的标准专用密钥文件。指定密钥库的完整路径。 String passphrase 指定运行作业时要在目标处使用的标准口令。如果密钥库需要口令,请指定口令。 String useSudo 指定以启用替代用户来在目标主机上执行命令。缺省情况下不使用 sudo。sudo 选项仅在 AIX、HP-UX、Linux 和 Solaris 操作系统上受支持。 启用 useSudo 以在运行作业前更改用户,然后根据需要指定替代用户的用户名和密码。sudo 意味着“替代用户执行”。如果目标主机不需要密码,请让这些密码字段保留为空白。以下选择组合是有效的:
- 启用 useSudo,而且不对 sudoUsername 和 sudoPassword 指定值。这些选项使用 /etc/sudoers 文件中设置的缺省用户并使用连接用户的密码。
- 启用 useSudo,对 sudoUsername 指定值,但不对 sudoPassword 指定值。这些选项使用指定的用户并使用连接用户的密码。
- 启用 useSudo,对 sudoUsername 指定值,并且对 sudoPassword 指定值。这些选项使用指定的用户和 sudo 密码。
Boolean sudoUsername 指定替代用户的用户名。有关何时对 sudoUsername 指定值的信息,请参阅 useSudo 描述。 String sudoPassword 指定替代用户的密码。有关何时对 sudoPassword 指定值的信息,请参阅 useSudo 描述。 String 描述 指定作业的描述。 String activationDateTime 以格式 2006-05-03T10:30:45-0000 指定激活作业的日期和时间。activationDateTime 参数值的 -0000 部分代表 RFC 822 格式。您可以指定 Z 作为格林威治标准时间 (GMT) 的捷径,例如 2006-05-03T10:30:45Z。如果未指定时间区域,那么系统会使用作业管理器的时间区域。 String expirationDateTime 以格式 2006-05-03T10:30:45-0000 指定作业的到期日期。activationDateTime 参数值的 -0000 部分代表 RFC 822 格式。您可以指定 Z 作为格林威治标准时间 (GMT) 的捷径,例如 2006-05-03T10:30:45Z。如果未指定时间区域,那么系统会使用作业管理器的时间区域。 String executionWindow 为作业指定重现时间间隔(如果有的话)。 String executionWindowUnit 指定重现时间间隔的计量单位。有效值包括 HOURS、DAYS、WEEKS、MONTHS、CONNECT 和 ONCE。缺省值为 HOURS。 String email 指定系统将作业通知发送到的电子邮件地址。 String
从作业管理器概要文件的 bin 目录输入 wsadmin 命令。此主题显示了使用 Jython 脚本语言编写的示例。
用法示例:
AdminTask.submitJob('-jobType installApplication -targetList [Target1 Target2 Target3]
-jobParams [applicationName MyApp] -email admin@company.com ')
交互方式示例用法:
AdminTask.submitJob('-interactive')
作业结果示例用法:
运行 submitJob 命令会返回作业标记(例如 124231200726586682)。有关作业标记的信息,请运行 getJobTargetStatus 命令:
AdminTask.getJobTargetStatus('[-jobToken 124231200726586682]')
- NOT_ATTEMPTED 值指定系统未尝试完成该作业。
- DISTRIBUTED 值指定目标的代理程序已接收到作业,但是该作业未完成。
- ASYNC_IN_PROGRESS 值指定目标正在运行作业,而且并发地运行其他作业。
- FAILED 值指定该作业失败。
- REJECTED 值指定目标拒绝了作业,例如,原因是目标不支持作业类型。
- SUCCEEDED 值指定该作业已成功完成。
- PARTIALLY_SUCCEEDED 值指定该作业已部分完成。例如,当目标表示多个服务器,但是该目标上仅某些服务器成功完成该作业时,可出现部分成功。
作业状态结果通常是从 DISTRIBUTED 进展到 ASYNC_IN_PROGRESS,再进展到 SUCCEEDED。可能需要运行 getJobTargetStatus 命令多次,直到结果是 FAILED、REJECTED 或 SUCCEEDED 为止。
缺省情况下,作业会保持活动状态一天(24 小时)。
提交作业以收集库存
库存管理作业从目标收集库存数据。此库存数据包括可用作业类型以及每个目标的受管资源(例如应用程序和服务器)的状态。
如果目标是主机,那么库存数据包含有关主机的信息,例如操作系统名称、版本、Installation Manager、软件包组、软件包、概要文件以及其他资源。
如果您希望库存作业查找 Liberty 资源,那么必须为 WLP_WORKING_DIR、WLP_SHARED_DIR 或 WLP_ADDITIONAL_DIRS 定义变量。请参阅“为 Liberty 服务器设置变量”。
![[IBM i]](../images/iseries.gif)
作业参数
无。用法示例
AdminTask.submitJob('-jobType inventory -targetList [Target1 Target2 Target3]')
提交作业以收集目标状态
状态管理作业从目标收集状态数据。如果只想刷新每个目标的受管资源(例如应用程序和服务器)上的数据,请使用此作业,取代库存作业。
如果 Liberty 服务器是目标,那么此作业仅更新 Liberty 服务器资源的服务器状态。它不会发现新的服务器资源,也不会移除已删除的服务器资源。要发现新的服务器资源,请改为提交库存作业。
作业参数
无。用法示例
AdminTask.submitJob('-jobType status -targetList [Target1 Target2 Target3]')
提交作业以管理文件
可以使用文件管理作业来收集、分发和移除文件。例如,可以提交 collectFile 作业以将文件传输到作业管理器。distributeFile 作业会将文件从作业管理器传输到作业的目标。removeFile 作业不会移除先前已分发到目标的文件:
可以将文件管理作业与远程主机目标一起使用。使用 distributeFile 将文件发送到远程主机,使用 collectFile 从远程主机收集文件,以及使用 removeFile 从远程主机删除文件。
collectFile
collectFile 管理作业收集目标文件并将它传输到作业管理器。如果源位置是目录而不是文件,那么作业会递归地压缩目录内容并传输产生的压缩文件(zip 文件)。
作业参数
参数 | 描述 | 类型 |
---|---|---|
source | 指定相关文件或目录的源位置。系统确定该文件位置相对于目标的 profile_root 目录。 | String |
destination | 指定目标位置。值相对于名称为 profile_root/config/temp/JobManagerName/jobToken/targetName 的目录。 | String |
distributionProvider | (可选)指定分发提供程序的名称。 | String |
用法示例
AdminTask.submitJob('[-jobType collectFile -targetList [Target1]
-jobParams [[source logs][destination targetLocationOfFile]]]')
distributeFile
distributeFile 管理作业会将文件从作业管理器传输到作业的目标。系统会将该文件存储在为将使用该文件的后续作业准备的目标中。installApplication 和 updateApplication 管理作业引用您为 distributeFile 作业提供的目标(作为目标上应用程序内容的位置)。此外,可以使用此作业来分发脚本文件和基于属性的配置文件。
最初要从作业管理器分发的文件必须位于作业管理器概要文件的 /config/temp/JobManager 目录中。然后,系统会将该文件移到管理代理程序或 Deployment Manager 概要文件的 downloadedContent 目录中。目标参数相对于 downloadedContent 目录,并且可以是文件名或相对路径名。可以使用相对路径在 downloadedContent 目录下创建单独的子目录以组织所下载的文件。

- 通过使用具有 *ALLOBJ 和 *SECADM 许可权的管理用户,使用命令提示符将目录切换至 profile_root/JobManagerName/config/temp。
- 输入以下命令:mkdir JobManager
- 输入以下命令:chown -R QEJBSVR JobManager
- 将要分发的文件复制到 JobManager 目录。
- 从管理控制台中,提交 distributeFile 作业。
作业参数
参数 | 描述 | 类型 |
---|---|---|
source | 指定要分发的内容的源位置。 | String |
destination | 指定目标上系统用于保存内容的目标位置。 | String |
distributionProvider | (可选)指定分发提供程序的名称。 | String |
用法示例
AdminTask.submitJob('-jobType distributeFile -targetList [Target1 Target2 Target3]
-jobParams [[source file:/MyApp.ear][destination MyApp.ear]]')
removeFile
removeFile 管理作业会移除先前已分发到目标的文件。location 参数相对于 downloadedContent 目录,它对应的位置应该与当分发该文件时为 destination 参数指定的位置相同。
作业参数
参数 | 描述 | 类型 |
---|---|---|
location | 指定要从目标移除的文件的位置。使用来自 distributeFile 作业的目标值。 | String |
distributionProvider | (可选)指定分发提供程序的名称。 | String |
用法示例
AdminTask.submitJob('-jobType removeFile -targetList [Target1 Target2 Target3]
-jobParams [location MyApp.ear]')
提交运行 wsadmin 脚本的作业
可提交作业以在由作业管理器管理的目标上运行 wsadmin 脚本。受管目标可以是 Deployment Manager 或未联合的应用程序服务器。在对受管目标运行 wsadmin 脚本之前,请通过使用 distributeFile 作业来将 wsadmin 脚本以及任何脚本概要文件从作业管理器传输到该受管目标。请记住当分发文件时指定的任何目标值。然后,使用以下作业来运行 wsadmin 脚本。对 scriptFileLocation 参数使用目标值。如果指定了概要文件目标值,那么可以选择性地对 profileLocation 参数使用概要文件目标值。
runWsadminScript 作业的状态结果取决于脚本的返回码。当返回码为零时,该作业标记为成功。当返回码为非零值时,该作业标记为失败。
作业参数
参数 | 描述 | 类型 |
---|---|---|
scriptFileLocation | 指定要在受管目标上运行的脚本文件的位置。该位置是当将该文件分发到目标时给定的目标。 | String |
profileLocation | (可选)指定要与 wsadmin 脚本一起运行的概要文件脚本的位置。此参数对应于 wsadmin 的 -profile 参数。该位置是当将该文件分发到目标时指定的目标。 | String |
scriptParameters | (可选)指定要对 wsadmin 脚本提供的参数。 | String |
用法示例
AdminTask.submitJob('[-jobType runWsadminScript -targetList [DmgrManagedNodeName]
-jobParams [ [scriptFileLocation myScript.py] [profileLocation scriptProfile.py]
[scriptParameters [param1 param2]] ]]')
对于处理命令参数(例如 argv[] 命令参数)的多个“关键字/值”对的 wsadmin 脚本,请使用 scriptParameters 来指定关键字和值:
AdminTask.submitJob('[-jobType runWsadminScript -targetList [myNode01]
-jobParams [ [scriptFileLocation myScript.py] [scriptParameters [-keyword1 value1 -keyword2 value2]] ]]')
提交作业以管理应用程序
可以使用应用程序管理作业来对应用程序服务器分发、安装、更新、移除和控制应用程序。例如,可以提交 distributeFile、installApplication 和 startApplication 作业来在环境中部署应用程序。要从环境中移除应用程序,请提交 stopApplication、uninstallApplication 和 removeFile 作业。使用下列应用程序管理作业来管理应用程序配置:
installApplication
installApplication 管理作业会将应用程序或应用程序元素安装和绑定到目标环境中。必须运行 distributeFile 作业并将可部署内容分发到目标,然后才能安装应用程序。
installApplication 作业不会提供一种方法来给出绑定信息或其他部署属性。如果需要该功能,那么可以使用 runWsadminScript 或 configureProperties 作业。
作业参数
参数 | 描述 | 类型 |
---|---|---|
applicationName | 指定用来标识要安装的应用程序的应用程序名称。通常,这是企业应用程序的基本文件名(例如,对于 MyApp.ear,为 MyApp),但您可以选择任何名称。 | String |
appLocation | (可选)指定要安装的应用程序文件的位置。缺省情况下,installApplication
作业会将 .ear 文件格式表示法追加至应用程序名称,并且在缺省目标位置中搜索该应用程序。 因此,如果对 applicationName 指定 MyApp,那么缺省情况下 appLocation 是受管目标的 downloadedContent/MyApp.ear。如果对 appLocation 指定值,请使用分发应用程序时指定的目标值。 |
String |
serverName | (可选)指定系统安装应用程序的服务器的名称。 | String |
nodeName | (可选)指定感兴趣的节点,用于标识 WebSphere Application Server Network Deployment 单元中的服务器。 | String |
clusterName | (可选)指定安装应用程序的集群的名称。 | String |
用法示例
AdminTask.submitJob('-jobType installApplication -targetList [Target1 Target2 Target3]
-jobParams [[applicationName MyApp]]')
或:
AdminTask.submitJob('-jobType installApplication -targetList [Target1 Target2 Target3]
-jobParams [[applicationName MyApp][appLocation MyApp.ear][clusterName TestCluster]]')
startApplication
startApplication 管理作业会启动目标上先前安装的应用程序。系统会将应用程序状态更改为活动或正在运行,在运行时装入应用程序以及打开应用程序以接收客户机请求。这是应用程序部署过程的最后一个步骤。
作业参数
参数 | 描述 | 类型 |
---|---|---|
applicationName | 指定要启动的应用程序的名称。 | String |
用法示例
AdminTask.submitJob('-jobType startApplication -targetList [Target1 Target2 Target3]
-jobParams [applicationName MyApp]')
stopApplication
stopApplication 管理作业会停止目标上的应用程序。系统会将应用程序状态更改为已停止,并且不再接收客户机请求。可以使用 startApplication 作业来重新启动应用程序。这是应用程序移除过程的第一步。
参数 | 描述 | 类型 |
---|---|---|
applicationName | 指定要停止的应用程序的名称。 | String |
用法示例
AdminTask.submitJob('-jobType stopApplication -targetList [Target1 Target2 Target3]
-jobParams [applicationName MyApp]')
updateApplication
updateApplication 管理作业会更新目标环境中的应用程序或应用程序元素。必须运行 distributeFile 作业并将可部署内容分发到目标,然后才能更新应用程序。
作业参数
参数 | 描述 | 类型 |
---|---|---|
applicationName | 指定用来标识要更新的应用程序的应用程序名称。通常,这是企业应用程序的基本文件名(例如,对于 MyApp.ear,为 MyApp),但您可以选择任何名称。 | String |
appLocation | (可选)指定要安装的应用程序文件的位置。缺省情况下,updateApplication
作业会将 .ear 文件格式表示法追加至应用程序名称,并且在缺省目标位置中搜索该应用程序。 因此,如果对 applicationName 指定 MyApp,那么缺省情况下 appLocation 是受管目标的 downloadedContent/MyApp.ear。如果对 appLocation 指定值,请使用分发应用程序时指定的目标值。 |
String |
serverName | (可选)指定系统更新应用程序的服务器的名称。 | String |
nodeName | (可选)指定感兴趣的节点,用于标识 WebSphere Application Server Network Deployment 单元中的服务器。 | String |
clusterName | (可选)指定更新应用程序的集群的名称。 | String |
用法示例
AdminTask.submitJob('-jobType updateApplication -targetList [Target1 Target2 Target3]
-jobParams [[applicationName MyApp]]')
或:
AdminTask.submitJob('-jobType updateApplication -targetList [Target1 Target2 Target3]
-jobParams [[applicationName MyApp][appLocation MyApp.ear][clusterName TestCluster]]')
uninstallApplication
uninstallApplication 管理作业会从目标卸载应用程序。
作业参数
参数 | 描述 | 类型 |
---|---|---|
applicationName | 指定要移除的应用程序的名称。 | String |
用法示例
AdminTask.submitJob('-jobType uninstallApplication -targetList [Target1 Target2 Target3]
-jobParams [applicationName MyApp]')
提交作业以管理服务器
系统管理员可以使用应用程序服务器配置作业来修改远程和本地应用程序服务器的配置。
createApplicationServer
createApplicationServer 管理作业会在目标环境中创建应用程序服务器。
作业参数
参数 | 描述 | 类型 |
---|---|---|
serverName | 指定要创建的应用程序服务器的名称。服务器名称在目标节点上必须唯一。 | String |
nodeName | 目标为 WebSphere Application Server Network Deployment 单元时,您必须指定节点名以指示要在该单元中的哪个节点上创建服务器。您不必指定基本节点的节点名。 | String |
templateName | (可选)指定服务器模板。 | String |
templateLocation | (可选)指定模板的存储位置。使用系统定义的缺省位置,除非您需要指定模板位置。 | String |
genUniquePorts | (可选)指定以便为服务器生成唯一的 HTTP 端口。缺省情况下,产品会生成唯一的端口号。 | Boolean |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
用法示例
AdminTask.submitJob('-jobType createApplicationServer -targetList
[Node1 Node2 Node3] -jobParams [serverName AppServer01]')
deleteApplicationServer
deleteApplicationServer 管理作业会从目标环境中移除应用程序服务器。
作业参数
参数 | 描述 | 类型 |
---|---|---|
serverName | 指定要删除的应用程序服务器的名称。 | String |
nodeName | 目标为 WebSphere Application Server Network Deployment 单元时,您必须指定节点名以指示要从该单元的哪个节点中删除服务器。您不必指定基本节点的节点名。 | String |
用法示例
AdminTask.submitJob('-jobType deleteApplicationServer -targetList
[Node1 Node2 Node3] -jobParams [serverName AppServer01]')
createProxyServer
createProxyServer 管理作业在作为由作业管理器管理的目标的 Deployment Manager 单元中创建代理服务器。
作业参数
参数 | 描述 | 类型 |
---|---|---|
serverName | 指定要创建的代理服务器的名称。 | String |
nodeName | 指定代理服务器所在的节点。 | String |
用法示例
AdminTask.submitJob('[-jobType createProxyServer -jobParams [[serverName
testServer1][nodeName testNode1]] ]')
deleteProxyServer
deleteProxyServer 会从作为由作业管理器管理的目标的 Deployment Manager 单元中删除代理服务器。
作业参数
参数 | 描述 | 类型 |
---|---|---|
serverName | 指定要删除的代理服务器的名称。 | String |
nodeName | 指定代理服务器所在的节点。 | String |
用法示例
AdminTask.submitJob('[-jobType deleteProxyServer -jobParams [[serverName
testServer1][nodeName testNode1]] ]')
createCluster
createCluster 管理作业创建集群。要在单元中创建集群,必须向作业管理器注册该单元的 Deployment Manager。
作业参数
参数 | 描述 | 类型 |
---|---|---|
clusterConfig.clusterName | 指定服务器集群的名称。 | String |
clusterConfig.preferLocal | (可选)为集群启用节点限定的路由选择优化。 | String |
clusterConfig.clusterType | (可选)指定服务器集群的类型。 | String |
![]() |
![]() |
![]() |
replicationDomain.createDomain | (可选)创建复制域并将名称设为新集群的名称。 | String |
convertServer.serverNode | (可选)指定要转换为集群的第一个成员的现有服务器的节点名称。 | String |
convertServer.serverName | (可选)指定要转换为集群的第一个成员的现有服务器的名称。 | String |
convertServer.memberWeight | (可选)指定新集群成员的权重值。 | String |
convertServer.nodeGroup | (可选)指定所有集群成员节点必须所属的节点组的名称。 | String |
convertServer.replicatorEntry | (可选)指定在集群复制域中创建此成员的复制程序条目。复制程序条目用于 HTTP 会话数据复制。 | String |
用法示例
AdminTask.submitJob('[-jobType createCluster -targetList [DmgrManagedNodeName]
-jobParams [clusterConfig.clusterName newCluster1]]')
如果在 createCluster 命令上指定其他参数,请在参数的 -jobParams 列表中使用格式 [stepName.parameterName parameterValue]。
AdminTask.submitJob('[-jobType createCluster -targetList [DmgrManagedNodeName]
-jobParams [ [clusterConfig.clusterName newCluster1] [clusterConfig.clusterType PROXY_SERVER] ]]')
deleteCluster
deleteCluster 管理作业删除集群。要在单元中删除集群,必须向作业管理器注册该单元的 Deployment Manager。
作业参数
参数 | 描述 | 类型 |
---|---|---|
clusterName | 指定要删除的服务器集群的名称。 | String |
replicationDomain.deleteRepDomain | (可选)用来指示当删除集群时要删除集群复制域。 | String |
用法示例
AdminTask.submitJob('[-jobType deleteCluster -targetList [DmgrManagedNodeName]
-jobParams [ [clusterName newCluster1] [replicationDomain.deleteRepDomain true] ]]')
createClusterMember
createClusterMember 管理作业会在单元中集群上创建集群成员。必须向作业管理器注册该单元的 Deployment Manager。
作业参数
参数 | 描述 | 类型 |
---|---|---|
clusterName | 指定新集群成员所属的服务器集群的名称。 | String |
memberConfig.memberNode | 指定新集群成员要保留在其中的节点的名称。 | String |
memberConfig.memberName | 指定新集群成员的名称。 | String |
memberConfig.memberWeight | (可选)指定新集群成员的权重。 | String |
memberConfig.memberUUID | (可选)指定新集群成员的通用唯一标识 (UUID)。 | String |
memberConfig.genUniquePorts | (可选)指定要为服务器中定义的 HTTP 传输方法生成唯一端口号。 | String |
memberConfig.replicatorEntry | (可选)指定在集群复制域中创建此成员的复制程序条目。复制程序条目用于 HTTP 会话数据复制。 | String |
![]() |
![]() |
![]() |
firstMember.templateName | (可选)指定要用作新集群成员的模型的应用程序服务器模板的名称。 | String |
firstMember.templateServerNode | (可选)指定要用作新集群成员的模板的现有服务器的节点名称。 | String |
firstMember.templateServerName | (可选)指定要用作新集群成员的模型的服务器的名称。 | String |
firstMember.nodeGroup | (可选)指定所有集群成员节点必须所属的节点组的名称。 | String |
firstMember.coreGroup | (可选)指定所有集群成员必须所属的核心组的名称。 | String |
用法示例
AdminTask.submitJob('[-jobType createClusterMember
-targetList [DmgrManagedNodeName]
-jobParams [ [memberConfig.memberName newCluster1mem1]
[memberConfig.memberNode FederatedNode] [clusterName newCluster1] ]]')
deleteClusterMember
deleteClusterMember 管理作业会从单元中集群上删除集群成员。必须向作业管理器注册该单元的 Deployment Manager。集群在联合节点上必须至少具有一个集群成员。
作业参数
参数 | 描述 | 类型 |
---|---|---|
clusterName | 指定要删除的集群成员所属的服务器集群的名称。 | String |
memberNode | 指定集群成员保留在其中的节点的名称。 | String |
memberName | 指定要删除的集群成员的服务器名称。 | String |
replicatorEntry.deleteEntry | (可选)指定从集群的复制域中删除具有此集群成员的服务器名称的复制程序条目。 | String |
用法示例
AdminTask.submitJob('[-jobType deleteClusterMember -targetList
[DmgrManagedNodeName] -jobParams [ [memberName newCluster1mem1]
[memberNode FederatedNode] [clusterName newCluster1] ]]')
configureProperties
configureProperties 管理作业将属性文件应用于应用程序服务器配置。此作业使用 AdminTask 对象的 PropertiesBasedConfiguration 命令组中的 applyConfigProperties 命令来配置目标的属性。
作业参数
参数 | 描述 | 类型 |
---|---|---|
propertiesFileLocation | 指定要应用于目标应用程序服务器的属性文件的位置。 为此参数指定的路径是 profile_root/downloadedContent 目录中针对 Deployment Manager 的相对路径。在启动 configureProperties 管理作业之前,如果此目录尚未存在,那么必须进行创建。 |
String |
variableMapLocation | (可选)指定要随属性文件包括的变量映射文件的位置。 | String |
用法示例
AdminTask.submitJob('-jobType configureProperties -targetList
[Target1 Target2 Target3] -jobParams [propertiesFileLocation myProperties.props]')
提交作业以管理服务器运行时
系统管理员可以使用应用程序服务器运行时控制作业来启动和停止应用程序服务器。
startServer
startServer 管理作业会启动相关应用程序服务器并对其进行初始化。
作业参数
参数 | 描述 | 类型 |
---|---|---|
serverName | 指定要启动的应用程序服务器。 | String |
nodeName | 如果作业目标为 Deployment Manager 节点,请指定服务器所在的联合节点的名称。 | String |
用法示例
AdminTask.submitJob('-jobType startServer -targetList [Target1 Target2 Target3]
-jobParams [serverName AppServer01]')
stopServer
stopServer 管理作业会停止相关应用程序服务器。使用 startServer 作业来重新启动应用程序服务器。
作业参数
参数 | 描述 | 类型 |
---|---|---|
serverName | 指定要停止的应用程序服务器。 | String |
nodeName | 如果作业目标为 Deployment Manager 节点,请指定服务器所在的联合节点的名称。 | String |
用法示例
AdminTask.submitJob('-jobType stopServer -targetList [Target1 Target2 Target3]
-jobParams [serverName AppServer01]')
startCluster
startCluster 管理作业启动集群。要在单元中启动集群,必须向作业管理器注册该单元的 Deployment Manager。
作业参数
参数 | 描述 | 类型 |
---|---|---|
clusterName | 指定要启动的集群的名称。 | String |
rippleStart | (可选)指定是否在波动启动中启动集群。缺省值为 false。 | String |
用法示例
以下示例启动集群:
AdminTask.submitJob('[-jobType startCluster -targetList [DmgrManagedNodeName]
-jobParams [clusterName newCluster1]]')
以下示例波动启动集群:
AdminTask.submitJob('[-jobType createCluster -targetList [DmgrManagedNodeName]
-jobParams [ [clusterName newCluster1] [rippleStart true] ]]')
stopCluster
stopCluster 管理作业停止集群。要在单元中停止集群,必须向作业管理器注册该单元的 Deployment Manager。
作业参数
参数 | 描述 | 类型 |
---|---|---|
clusterName | 指定要停止的集群的名称。 | String |
用法示例
AdminTask.submitJob('[-jobType stopCluster -targetList [DmgrManagedNodeName]
-jobParams [clusterName newCluster1]]')
提交作业以运行命令
系统管理员可以使用作业管理器的 runCommand 作业在远程主机上运行命令。该命令可以是命令行实用程序(例如 app_server_root/bin 目录中的 startServer)、wsadmin 命令或操作系统命令。
作业参数
参数 | 描述 | 类型 |
---|---|---|
command | 指定要运行的命令的名称。 | String |
workingDir | 指定远程主机上命令文件的位置。缺省值为远程主机上的 app_server_root 目录。 | String |
用法示例
![[Linux]](../images/linux.gif)
AdminTask.submitJob('-jobType runCommand -targetList Target1
-username user1 -password ******* -jobParams [[command ./versionInfo.sh]]')
![[Windows]](../images/windows.gif)
AdminTask.submitJob('-jobType runCommand -targetList Target1
-username user1 -password ******* -jobParams [[command versionInfo.bat]]')
![[Linux]](../images/linux.gif)
AdminTask.submitJob('-jobType runCommand -targetList Target1
-username user1 -password *******
-jobParams [[command "./java -version"][workingDir /opt/IBM/WebSphere/AppServer/java/bin]]')
![[Windows]](../images/windows.gif)
AdminTask.submitJob('-jobType runCommand -targetList Target1
-username user1 -password *******
-jobParams [[command "java -version"][workingDir C:/WAS_v800/IBM/WebSphere/AppServer/java/bin]]')
提交作业以管理概要文件
系统管理员可以使用作业管理器的 manageprofiles 作业来创建、扩充或删除 WebSphere Application Server 概要文件。此作业运行 manageprofiles 管理命令。
作业参数
参数 | 描述 | 类型 |
---|---|---|
wasHome | 指定 WebSphere Application Server 安装的位置。这是远程主机上的 app_server_root 路径。 | String |
responseFile | 指定位于作业管理器上的 manageprofiles 响应文件的位置。 | String |
username | 指定运行作业时要在目标处使用的用户名。如果未指定用户名和密码,但是启用了安全性,那么会使用作业管理器上的用户标识。 | String |
password | 指定运行作业时要在目标处使用的用户名的密码。如果未指定用户名和密码,但是启用了安全性,那么会使用作业管理器上的用户标识。 | String |
用法示例
AdminTask.submitJob('-jobType manageprofiles -targetList Target1 -username user1 -password *******
-jobParams [[wasHome /WAS80GA][responseFile /temp/mp1.txt]]')
提交 Installation Manager 作业
系统管理员可以使用 Installation Manager 作业来安装 Installation Manager 实例、通过存储库更新 Installation Manager、管理 Installation Manager 产品以及安装 WebSphere Application Server 产品。

installIM
installIM 管理作业通过将安装工具箱从作业管理器发送到主机来安装 Installation Manager 的新实例。
作业参数
参数 | 描述 | 类型 |
---|---|---|
kitPath | 指定 Installation Manager 包的位置。如果未指定此参数,那么作业会在缺省位置中查找最新的 IM 安装工具箱。 | String |
dataPath | 指定 Installation Manager 数据的位置。 | String |
installPath | 指定目标主机上要安装 Installation Manager 的位置。只有在当前单元中同一个主机上存在多个安装位置时,才指定此参数。 | String |
skipPrereqCheck | 如果设为 true,那么可选择指定安装 Installation Manager 时不执行任何先决条件检查,并指定禁止执行 Installation Manager 磁盘空间检查。 缺省值为 false。除非指定 true 值,否则执行先决条件和磁盘空间检查。 |
Boolean |
acceptLicense | 必须设为 true(如果未指定此参数,那么此作业将失败)。 | Boolean |
用法示例
AdminTask.submitJob('-jobType installIM -targetList [Host1 Host2 Host3]
-jobParams [acceptLicense TRUE] [kitPath /IM/agent.installer.zip] -username user1 -password pw')
如果未指定 IBM Installation Manager 安装工具箱路径,那么 installIM 作业会在作业管理器上的安装工具箱存储库中搜索适合于目标平台的最新 IBM Installation Manager 安装工具箱。缺省情况下,安装工具箱存储库为 app_server_root/IMKits。可以从作业管理器更改位置。请单击 ,然后将 Installation Manager 安装套件位置更改为另一个位置。
updateIM
updateIM 管理作业使用存储库来更新现有 Installation Manager,而不是从作业管理器发送安装工具箱。此 updateIM 命令需要 Installation Manager V1.4 或更高版本。
作业参数
参数 | 描述 | 类型 |
---|---|---|
repository | 指定用来更新 Installation Manager 的存储库的位置。路径可以用于作业管理器计算机上的本地文件,也可以是指向远程文件的 URL。 | String |
installPath | 指定 Installation Manager 安装的位置。 | String |
keyringFile | 如果在响应文件中指定的产品存储库需要登录,那么指定要使用的密钥环文件的位置。如果存储库不需要登录,那么不指定此参数。 | String |
keyringPassword | (可选)指定密钥环文件的密码。如果密钥环文件不需要密码,那么不指定此参数。 | String |
acceptLicense | 必须设为 true(如果未指定此参数,那么此作业将失败)。 | Boolean |
用法示例
AdminTask.submitJob('-jobType updateIM -targetList [Host1]
-jobParams [acceptLicense TRUE][ [repository /IM/repository] [installPath /IM] ]')
manageOfferings
在 Installation Manager 中,manageOfferings 管理作业可以安装、更新、修改、回滚或卸载产品。提交使用 Installation Manager 响应文件及可选的密钥环文件的作业,以使用远程存储库来管理密钥环。

路径必须以盘符开头。
路径必须以 / 开头。
作业参数
参数 | 描述 | 类型 |
---|---|---|
responseFile | 指定用来更新、修改、回滚或卸载 Installation Manager 产品的响应文件的位置。路径可以用于作业管理器计算机上的本地文件,也可以是指向远程文件的 URL。 | String |
IMPath | 指定 Installation Manager 安装的位置。如果未指定此参数,那么作业会尝试发现并使用目标主机上缺省 Installation Manager 的路径。如果找不到任何 Installation Manager 或者找到了多个 Installation Manager,那么作业会失败。在这种情况下,submitJob manageOfferings 命令必须指定 Installation Manager 路径。 | String |
keyringFile | 指定在响应文件中所指定产品存储库需要登录的情况下要使用的密钥环文件的位置。如果响应文件不需要登录,那么不指定此参数。 | String |
keyringPassword | (可选)指定密钥环文件的密码。如果密钥环文件不需要密码,那么不指定此参数。 | String |
用法示例
AdminTask.submitJob('-jobType manageOfferings -targetList [Host1 Host2 Host3]
-jobParams [responseFile /IM/agent.installer.zip] -username user1 -password pw')
findIMDataLocation
findIMDataLocation 管理作业可以添加或搜索 Installation Manager 数据位置。
- 验证其他 IM 数据位置字段中所指定的数据位置,以及作业在执行搜索(如果搜索系统操作设为 true)期间找到的数据位置
- 将有效的数据位置附加到现有的数据位置列表以供将来使用
- 移除重复的数据位置
- 运行库存作业
作业参数
参数 | 描述 | 类型 |
---|---|---|
targetList | 指定作业的目标系统的位置。 | String |
searchSystem | 指定 CIM 在整个目标系统中搜索 Installation Manager 数据位置。 | String |
dataLocations | 指定可用 Installation Manager 数据的位置。该作业仅列出管理控制台上注册的当前目标用户可以使用的 Installation Manager 数据位置。 | String |
用法示例
AdminTask.submitJob ('[-jobType findDataLocation -targetList targetList -jobParams [[searchSystem true]
[datalocations path_to_data_locations_separated_by_semicolon] ]]')
提交 Liberty 作业
可以提交作业以安装和卸载 Liberty 资源,以及启动和停止 Liberty 服务器。Liberty 服务器是一个可以快速启动的动态应用程序服务器,您可以通过编辑 XML 配置文件来轻松地添加功能以及进行管理。
- 在 server.env 文件中将 JAVA_HOME 属性设置为 JDK 或 JRE 位置。运行命令以启动或停止服务器之前,作业会在目标环境上读取并设置 JAVA_HOME 属性。但是,如果手动启动或停止服务器,那么 Liberty 服务器命令不使用此属性。
server.env 文件必须为 EBCDIC 编码。
在用户 .bashrc 文件中将 JAVA_HOME 属性设置为 JDK 或 JRE 位置。
将 JDK 或 JRE 路径附加到 PATH 环境变量。
将 JAVA_HOME 属性设置为 JDK 或 JRE 位置,作为系统环境变量。
将 JDK 或 JRE 路径附加到 PATH 系统变量。
如果未在 server.env 或用户环境中指定 JAVA_HOME,那么作业管理器会在用户搜索路径中查找 JDK 或 JRE。
installLibertyProfileResources
installLibertyProfileResources 作业会将 Liberty 映像中的资源解压缩到相对于根目录的目标目录。在运行此作业之前,必须存在下列情况:
- 必须向作业管理器注册主机。
- 映像是一个压缩文件(zip 文件),必须以满足作业管理器规则的目录结构包含 Liberty 资源。请参阅“将 Liberty 资源打包”。
- 必须定义目标主机上要安装资源的根目录。至少将 WLP_WORKING_DIR 变量设为目标主机上的有效目录。要将资源安装到目标主机上的共享目录,必须将 WLP_SHARED_DIR 变量设为有效的目录。请参阅“为 Liberty 服务器设置变量”。
部署资源期间,产品会将变量替换应用到每个 Liberty 服务器中的 bootstrap.properties 文件。
server.env 文件必须为 EBCDIC 编码。
- 在主机上使用 unzip 实用程序。
- 在主机上使用 jar 实用程序,包括库存作业所找到的软件开发包 (SDK) 中的 jar 实用程序。
使用执行作业期间复制到远程主机的 unzip 实用程序(如果管理员未明确地将其禁用)。完成作业后,会删除 unzip 实用程序。
- 在作业管理器上解压缩 zip 文件,并将文件逐个复制到目标主机。只有在 Liberty 服务器映像位于作业管理器上时,此方法才适用。
如果资源实例已存在于目标目录中,那么作业会失败,而不安装资源。
作业参数
参数 | 描述 | 类型 |
---|---|---|
image | 如果提供 Liberty 映像的压缩文件位于作业管理器主机上,那么指定压缩文件的完整路径名;例如:![]() ![]() ![]() ![]()
![]()
|
String |
url | 如果提供 Liberty 资源的压缩文件并不位于作业管理器主机上,那么指定压缩文件的 URL 路径。统一资源定位符 (URL) 的支持模式名称包含 http、https、ftp 和 file。 限制: 目标主机必须具有 wget 实用程序,才能指定除 file 之外的 URL 协议。选择目标主机上的 wget 实用程序支持的 http、https 或 ftp 远程下载协议。如果 wget 实用程序不支持所选协议,那么该作业无法安装这些资源。
例如,对资源文件 my_liberty_server.zip 指定下列其中一个 URL。 如果 Liberty 服务器资源位于 HTTP 或 HTTPS 服务器上:
如果资源位于 FTP 服务器上:
如果资源位于目标主机上,那么 URL 可以使用文件模式来描述压缩文件的路径和名称: ![]() ![]() ![]() ![]()
![]()
如果 URL 受密码保护,那么您还必须对 urluser 和 urlpassword 指定值。 |
String |
share | 指定是否要将 Liberty 资源安装到共享目录。如果设为 true,那么资源会安装到 WLP_SHARED_DIR 变量所定义的位置。如果未定义 WLP_SHARED_DIR 变量或者未指定有效目录,那么产品会返回错误并且不会从映像中解压缩资源。 如果设为 false(缺省值),那么作业会将资源安装到 WLP_WORKING_DIR 变量所定义的位置。 |
Boolean |
urluser | 指定 URL 的用户名。如果指定的 URL 是受密码保护的 URL,那么必须指定用户名。否则,请不要为 urluser 提供值。 | String |
urlpassword | 指定密码以使 urluser 能访问 URL。如果指定的 URL 是受密码保护的 URL,那么必须指定密码。否则,请不要为 urlpassword 提供值。 | String |
用法示例
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
-description installLibertyProfileResources
-jobParams [ [image /tmp/liberty/wlpwithjava.zip] [share FALSE] ]]')
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
-description installLibertyProfileResources
-jobParams [ [url file://c:/LibertyWorking/LibertyWorkingwjava.zip] [share FALSE] ]]')
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
-description installLibertyProfileResources
-jobParams [ [urlpassword ftp_pwd] [url ftp://www.mycompany.com/projects/liberty/image-0111003.zip]
[share FALSE] [urluser ftp_user] ]]')
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
-description installLibertyProfileResources
-jobParams [ [urlpassword http_pwd] [url http://www.mycompany.com/projects/liberty/image-0111003.zip]
[share FALSE] [urluser http_user] ]]')
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
-description installLibertyProfileResources
-jobParams [ [urlpassword http_pwd] [url https://www.mycompany.com/projects/liberty/image-0111003.zip]
[share TRUE] [urluser http_user] ]]')
uninstallLibertyProfileResources
uninstallLibertyProfileResources 作业会移除作业管理器管理的资源。库存作业已找到先前由 installLibertyProfileResources 作业(或者通过解压缩 Liberty 映像来进行手动安装之后)安装到主机上目标目录中的资源。
- 命令指定多种资源类型进行移除。
- 资源名称解析为多个同名资源。
- 资源不存在于作业管理器可以访问和搜索的目录中。

作业参数
参数 | 描述 | 类型 |
---|---|---|
projectName | 指定要移除的项目的名称或资源标识。产品会在所有服务器中搜索项目。对于每个正在运行的已确定服务器,产品会在尝试移除资源之前停止服务器。 | String |
runtimeName | 指定要移除的 Liberty 运行时的名称或资源标识。产品会在所有服务器中搜索运行时。对于每个正在运行的已确定服务器,产品会在尝试移除资源之前停止服务器。 | String |
sdkName | 指定要移除的软件开发包 (SDK) 的名称或资源标识。 | String |
serverName | 指定要移除的服务器的名称或资源标识。如果服务器正在运行,那么产品会在移除资源之前停止服务器。 | String |
applicationBinaryName | 指定要移除的应用程序二进制文件的名称或资源标识。 | String |
forceDelete | (可选)指定是否要删除资源,而不论是否检测到资源状态。缺省值为 false,不删除资源。如果值为 true,那么会删除服务器资源,即使无法检测到服务器资源的状态,或者无法停止服务器也是如此。如果无法检测到服务器的状态,那么除非指定此 forceDelete 选项,否则 uninstallLibertyProfileResources 作业会失败。 | Boolean |
用法示例
以下示例会移除作业管理器管理的 DefaultWebApplication.war 应用程序二进制文件:
AdminTask.submitJob('[-jobType uninstallLibertyProfileResources -targetList [host_name]
-description uninstallLibertyProfileResources
-jobParams [ [applicationBinaryName DefaultWebApplication.war] ]]')
startLibertyProfileServer
startLibertyProfileServer 作业会启动一个或多个 Liberty 服务器资源。服务器资源的状态会从 Stopped 切换至 Started。
- 在 server.env 文件中将 JAVA_HOME 属性设置为 JDK 或 JRE 位置。运行命令以启动服务器之前,作业会在目标环境上读取并设置 JAVA_HOME 属性。但是,如果手动启动服务器,那么 Liberty 服务器命令不使用此属性。
server.env 文件必须为 EBCDIC 编码。
在用户 .bashrc 文件中将 JAVA_HOME 属性设置为 JDK 或 JRE 位置。
将 JDK 或 JRE 路径附加到 PATH 环境变量。
将 JAVA_HOME 属性设置为 JDK 或 JRE 位置,作为系统环境变量。
将 JDK 或 JRE 路径附加到 PATH 系统变量。
作业参数
参数 | 描述 | 类型 |
---|---|---|
startResource | 指定要启动的 Liberty 服务器资源的路径名称。 | String |
用法示例
以下示例会启动 Liberty 服务器资源 server1:
AdminTask.submitJob('-jobType startLibertyProfileServer -targetList host_name
-description startLibertyProfileServer
-jobParams [[startResource runtime/wlp/liberty_server/server1 ]]')
stopLibertyProfileServer
stopLibertyProfileServer 作业会停止一个或多个正在运行的 Liberty 服务器资源。服务器资源的状态会从 Started 切换至 Stopped。
Liberty 服务器需要 Java Development Kit (JDK) 或 Java 运行时环境 (JRE) 才能运行此作业。确保已在目标上设置 JDK 或 JRE 位置。有关设置 JDK 或 JRE 位置的信息,请参阅startLibertyProfileServer。
作业参数
参数 | 描述 | 类型 |
---|---|---|
stopResource | 指定要停止的 Liberty 服务器资源的路径名称。 | String |
用法示例
以下示例会停止 Liberty 服务器资源:
AdminTask.submitJob('-jobType stopLibertyProfileServer -targetList host_name
-description stopLibertyProfileServer
-jobParams [[stopResource project/proj1/runtime/wlp/liberty_server/defaultServer]]')
generateMergedPluginConfigForLibertyProfileServers
generateMergedPluginConfigForLibertyProfileServers 作业会通过在目标主机上合并针对 Liberty 服务器生成的所有 plugin-cfg.xml 文件,创建单个 plugin-cfg.xml 文件。
对于此作业,可以在多个目标主机上指定一个 Liberty 服务器。找到 Liberty 服务器后,会在该服务器上生成 plugin-cfg.xml 文件,然后将该文件复制回作业管理器。为所有目标 Liberty 服务器生成所有 plugin-cfg.xml 文件后,会将这些文件合并为一个 plugin-cfg.xml 文件。此合并的文件会放入作业管理器目录 app_server_root/profiles/job_manager_profile/config/temp/JobManager/job_ID/_mergedPluginDir/。
<featureManager>
<feature>localConnector-1.0</feature>
<feature>restConnector-1.0</feature>
...
</featureManager>
如果使用 HTTP/REST 连接器,那么在提交作业时必须指定 JMX 连接的用户名和密码。- 目标 Liberty 服务器未在运行。
- 没有为目标 Liberty 服务器配置任何 JMX 连接器。
- 命令没有为 JMX 连接指定有效的凭证。
作业参数
参数 | 描述 | 类型 |
---|---|---|
serverName | 指定要在目标主机上为其生成 plugin-cfg.xml 文件的服务器的名称或资源标识。Liberty 服务器必须正在目标主机上运行。 | String |
jmxuser | 指定 JMX 连接的用户名。如果要将 HTTP/REST 连接器用于 JMX 连接,请指定此参数。 | String |
jmxpassword | 指定 JMX 连接的密码。如果要将 HTTP/REST 连接器用于 JMX 连接,请指定此参数。 | String |
用法示例
以下示例会在目标主机(host1 和 host2)上为 Liberty 服务器 defaultServer 生成合并的 plugin-cfg.xml 文件:
AdminTask.submitJob('[-jobType generateMergedPluginConfigForLibertyProfileServers
-targetList [host1 host2] -description generateMergedPluginConfigForLibertyProfileServers
-jobParams [[jmxpassword ********][serverName runtime/wlp/liberty_server/defaultServer][jmxuser c]]]')