使用 wsadmin 脚本编制的管理作业类型

在灵活管理环境中,可以使用 wsadmin 工具来将管理作业提交至作业管理器。本主题提供有关管理作业、作业参数和样本命令语法的详细信息。

所有作业类型的常见参数

使用 submitJob 命令来提交管理作业。作业提交由以下信息组成:
必需参数
每个 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 指定重现时间间隔的计量单位。有效值包括 HOURSDAYSWEEKSMONTHSCONNECTONCE。缺省值为 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 命令多次,直到结果是 FAILEDREJECTEDSUCCEEDED 为止。

缺省情况下,作业会保持活动状态一天(24 小时)。

提交作业以收集库存

库存管理作业从目标收集库存数据。此库存数据包括可用作业类型以及每个目标的受管资源(例如应用程序和服务器)的状态。

如果目标是主机,那么库存数据包含有关主机的信息,例如操作系统名称、版本、Installation Manager、软件包组、软件包、概要文件以及其他资源。

如果您希望库存作业查找 Liberty 资源,那么必须为 WLP_WORKING_DIR、WLP_SHARED_DIR 或 WLP_ADDITIONAL_DIRS 定义变量。请参阅“为 Liberty 服务器设置变量”。

[IBM i]注: 集中式安装管理器无法发现 IBM i 平台上的应用程序客户机和插件的概要文件。

作业参数

无。

用法示例

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 文件)。

作业参数

表 3. collectFile 参数描述. 在至少指定源和目标参数的情况下运行 submitJob collectFile 命令。
参数 描述 类型
source 指定相关文件或目录的源位置。系统确定该文件位置相对于目标的 profile_root 目录。 String
destination 指定目标位置。值相对于名称为 profile_root/config/temp/JobManagerName/jobToken/targetName 的目录。 String
distributionProvider (可选)指定分发提供程序的名称。 String

用法示例

以下示例运行 collectFile 作业:
AdminTask.submitJob('[-jobType collectFile -targetList [Target1]
 -jobParams [[source logs][destination targetLocationOfFile]]]')

distributeFile

distributeFile 管理作业会将文件从作业管理器传输到作业的目标。系统会将该文件存储在为将使用该文件的后续作业准备的目标中。installApplication 和 updateApplication 管理作业引用您为 distributeFile 作业提供的目标(作为目标上应用程序内容的位置)。此外,可以使用此作业来分发脚本文件和基于属性的配置文件。

最初要从作业管理器分发的文件必须位于作业管理器概要文件的 /config/temp/JobManager 目录中。然后,系统会将该文件移到管理代理程序或 Deployment Manager 概要文件的 downloadedContent 目录中。目标参数相对于 downloadedContent 目录,并且可以是文件名或相对路径名。可以使用相对路径在 downloadedContent 目录下创建单独的子目录以组织所下载的文件。

避免故障 避免故障: 要在提交其他作业之前提交 distributeFile 作业,必须先将要分发的文件放在 JobManager 目录下。要手动创建 JobManager 目录,请完成以下步骤:
  1. 通过使用具有 *ALLOBJ 和 *SECADM 许可权的管理用户,使用命令提示符将目录切换至 profile_root/JobManagerName/config/temp
  2. 输入以下命令:mkdir JobManager
  3. 输入以下命令:chown -R QEJBSVR JobManager
  4. 将要分发的文件复制到 JobManager 目录。
  5. 从管理控制台中,提交 distributeFile 作业。
gotcha

作业参数

表 4. distributeFile 参数描述. 在至少指定源和目标参数的情况下运行 submitJob 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 参数指定的位置相同。

作业参数

表 5. removeFile 参数描述. 在至少指定一个位置参数的情况下运行 submitJob removeFile 命令。
参数 描述 类型
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 作业的状态结果取决于脚本的返回码。当返回码为零时,该作业标记为成功。当返回码为非零值时,该作业标记为失败。

作业参数

表 6. 作业参数描述. 在至少指定一个 scriptFileLocation 参数的情况下运行 submitJob 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 作业。

要点: 对于 Deployment Manager 或管理代理程序,profile_root/downloadedContent 目录必须存在,您才能提交此作业。如果此目录尚未存在,那么必须进行创建。

作业参数

表 7. installApplication 参数描述. 在至少指定一个 applicationName 参数的情况下运行 submitJob installApplication 命令。
参数 描述 类型
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 管理作业会启动目标上先前安装的应用程序。系统会将应用程序状态更改为活动或正在运行,在运行时装入应用程序以及打开应用程序以接收客户机请求。这是应用程序部署过程的最后一个步骤。

作业参数

表 8. startApplication 参数描述. 在指定 applicationName 参数的情况下运行 submitJob startApplication 命令。
参数 描述 类型
applicationName 指定要启动的应用程序的名称。 String

用法示例

AdminTask.submitJob('-jobType startApplication -targetList [Target1 Target2 Target3] 
 -jobParams [applicationName MyApp]')

stopApplication

stopApplication 管理作业会停止目标上的应用程序。系统会将应用程序状态更改为已停止,并且不再接收客户机请求。可以使用 startApplication 作业来重新启动应用程序。这是应用程序移除过程的第一步。

表 9. stopApplication 参数描述. 在指定 applicationName 参数的情况下运行 submitJob stopApplication 命令。
参数 描述 类型
applicationName 指定要停止的应用程序的名称。 String

用法示例

AdminTask.submitJob('-jobType stopApplication -targetList [Target1 Target2 Target3] 
 -jobParams [applicationName MyApp]')

updateApplication

updateApplication 管理作业会更新目标环境中的应用程序或应用程序元素。必须运行 distributeFile 作业并将可部署内容分发到目标,然后才能更新应用程序。

要点: 对于 Deployment Manager 或管理代理程序,profile_root/downloadedContent 目录必须存在,您才能提交此作业。如果此目录尚未存在,那么必须进行创建。

作业参数

表 10. updateApplication 参数描述. 在至少指定一个 applicationName 参数的情况下运行 submitJob updateApplication 命令。
参数 描述 类型
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 管理作业会从目标卸载应用程序。

作业参数

表 11. uninstallApplication 参数描述. 在指定 applicationName 参数的情况下运行 submitJob uninstallApplication 命令。
参数 描述 类型
applicationName 指定要移除的应用程序的名称。 String

用法示例

AdminTask.submitJob('-jobType uninstallApplication -targetList [Target1 Target2 Target3]
 -jobParams [applicationName MyApp]')

提交作业以管理服务器

系统管理员可以使用应用程序服务器配置作业来修改远程和本地应用程序服务器的配置。

createApplicationServer

createApplicationServer 管理作业会在目标环境中创建应用程序服务器。

作业参数

表 12. createApplicationServer 参数描述. 在至少指定 serverName 和 nodeName 参数的情况下运行 submitJob createApplicationServer 命令。
参数 描述 类型
serverName 指定要创建的应用程序服务器的名称。服务器名称在目标节点上必须唯一。 String
nodeName 目标为 WebSphere Application Server Network Deployment 单元时,您必须指定节点名以指示要在该单元中的哪个节点上创建服务器。您不必指定基本节点的节点名。 String
templateName (可选)指定服务器模板。 String
templateLocation (可选)指定模板的存储位置。使用系统定义的缺省位置,除非您需要指定模板位置。 String
genUniquePorts (可选)指定以便为服务器生成唯一的 HTTP 端口。缺省情况下,产品会生成唯一的端口号。 Boolean
[z/OS]specificShortName [z/OS]仅限于 z/OS 环境,可选择指定服务器的特定短名称。每个服务器都必须具有唯一的特定短名称。缺省情况下,产品指定唯一的特定短名称。值必须是 8 个字符或以下,且全部大写。 [z/OS]String
[z/OS]genericShortName [z/OS]仅限于 z/OS 环境,可选择指定服务器的通用短名称。集群的所有成员都共享相同的通用短名称。个别服务器必须具有唯一的通用短名称。缺省情况下,产品指定唯一的通用短名称。值必须是 8 个字符或以下,且全部大写。 [z/OS]String
[z/OS]bitMode [z/OS]仅限于 z/OS 环境,可选择指定服务器的位方式。有效值为 31 和 64 位。如果未提供值,那么产品会指定缺省位方式。 [z/OS]Integer

用法示例

AdminTask.submitJob('-jobType createApplicationServer -targetList
 [Node1 Node2 Node3] -jobParams [serverName AppServer01]')

deleteApplicationServer

deleteApplicationServer 管理作业会从目标环境中移除应用程序服务器。

作业参数

表 13. deleteApplicationServer 参数描述. 在指定 serverName 和 nodeName 参数的情况下运行 submitJob 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 单元中创建代理服务器。

作业参数

表 14. createProxyServer 参数描述. 在指定 serverName 和 nodeName 参数的情况下运行 submitJob createProxyServer 命令。
参数 描述 类型
serverName 指定要创建的代理服务器的名称。 String
nodeName 指定代理服务器所在的节点。 String

用法示例

AdminTask.submitJob('[-jobType createProxyServer -jobParams [[serverName 
 testServer1][nodeName testNode1]] ]')

deleteProxyServer

deleteProxyServer 会从作为由作业管理器管理的目标的 Deployment Manager 单元中删除代理服务器。

作业参数

表 15. deleteProxyServer 参数描述. 在指定 serverName 和 nodeName 参数的情况下运行 submitJob deleteProxyServer 命令。
参数 描述 类型
serverName 指定要删除的代理服务器的名称。 String
nodeName 指定代理服务器所在的节点。 String

用法示例

AdminTask.submitJob('[-jobType deleteProxyServer -jobParams [[serverName 
 testServer1][nodeName testNode1]] ]')

createCluster

createCluster 管理作业创建集群。要在单元中创建集群,必须向作业管理器注册该单元的 Deployment Manager。

作业参数

表 16. createCluster 参数描述. 在至少指定 clusterConfig.clusterName 参数的情况下运行 submitJob createCluster 命令。
参数 描述 类型
clusterConfig.clusterName 指定服务器集群的名称。 String
clusterConfig.preferLocal (可选)为集群启用节点限定的路由选择优化。 String
clusterConfig.clusterType (可选)指定服务器集群的类型。 String
[z/OS]clusterConfig.shortName [z/OS](可选)指定服务器集群的短名称。 [z/OS]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。

作业参数

表 17. deleteCluster 参数描述. 在至少指定 clusterName 参数的情况下运行 submitJob deleteCluster 命令。
参数 描述 类型
clusterName 指定要删除的服务器集群的名称。 String
replicationDomain.deleteRepDomain (可选)用来指示当删除集群时要删除集群复制域。 String

用法示例

AdminTask.submitJob('[-jobType deleteCluster -targetList [DmgrManagedNodeName] 
 -jobParams [ [clusterName newCluster1] [replicationDomain.deleteRepDomain true] ]]')

createClusterMember

createClusterMember 管理作业会在单元中集群上创建集群成员。必须向作业管理器注册该单元的 Deployment Manager。

作业参数

表 18. createClusterMember 参数描述. 在至少指定 clusterName、memberConfig.memberNode 和 memberConfig.memberName 参数的情况下运行 submitJob createClusterMember 命令。
参数 描述 类型
clusterName 指定新集群成员所属的服务器集群的名称。 String
memberConfig.memberNode 指定新集群成员要保留在其中的节点的名称。 String
memberConfig.memberName 指定新集群成员的名称。 String
memberConfig.memberWeight (可选)指定新集群成员的权重。 String
memberConfig.memberUUID (可选)指定新集群成员的通用唯一标识 (UUID)。 String
memberConfig.genUniquePorts (可选)指定要为服务器中定义的 HTTP 传输方法生成唯一端口号。 String
memberConfig.replicatorEntry (可选)指定在集群复制域中创建此成员的复制程序条目。复制程序条目用于 HTTP 会话数据复制。 String
[z/OS]memberConfig.specificShortName [z/OS](可选)指定集群成员的短名称。 [z/OS]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。集群在联合节点上必须至少具有一个集群成员。

作业参数

表 19. deleteClusterMember 参数描述. 在至少指定 clusterName、memberNode 和 memberName 参数的情况下运行 submitJob deleteClusterMember 命令。
参数 描述 类型
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 命令来配置目标的属性。

作业参数

表 20. configureProperties 参数描述. 在至少指定 propertiesFileLocation 参数的情况下运行 submitJob configureProperties 命令。
参数 描述 类型
propertiesFileLocation 指定要应用于目标应用程序服务器的属性文件的位置。

为此参数指定的路径是 profile_root/downloadedContent 目录中针对 Deployment Manager 的相对路径。在启动 configureProperties 管理作业之前,如果此目录尚未存在,那么必须进行创建。

String
variableMapLocation (可选)指定要随属性文件包括的变量映射文件的位置。 String

用法示例

AdminTask.submitJob('-jobType configureProperties -targetList 
 [Target1 Target2 Target3] -jobParams [propertiesFileLocation myProperties.props]')

提交作业以管理服务器运行时

系统管理员可以使用应用程序服务器运行时控制作业来启动和停止应用程序服务器。

startServer

startServer 管理作业会启动相关应用程序服务器并对其进行初始化。

作业参数

表 21. startServer 参数描述. 在至少指定 serverName 参数的情况下运行 submitJob startServer 命令。
参数 描述 类型
serverName 指定要启动的应用程序服务器。 String
nodeName 如果作业目标为 Deployment Manager 节点,请指定服务器所在的联合节点的名称。 String

用法示例

AdminTask.submitJob('-jobType startServer -targetList [Target1 Target2 Target3] 
 -jobParams [serverName AppServer01]')

stopServer

stopServer 管理作业会停止相关应用程序服务器。使用 startServer 作业来重新启动应用程序服务器。

作业参数

表 22. stopServer 参数描述. 在至少指定 serverName 参数的情况下运行 submitJob stopServer 命令。
参数 描述 类型
serverName 指定要停止的应用程序服务器。 String
nodeName 如果作业目标为 Deployment Manager 节点,请指定服务器所在的联合节点的名称。 String

用法示例

AdminTask.submitJob('-jobType stopServer -targetList [Target1 Target2 Target3] 
 -jobParams [serverName AppServer01]')

startCluster

startCluster 管理作业启动集群。要在单元中启动集群,必须向作业管理器注册该单元的 Deployment Manager。

作业参数

表 23. startCluster 参数描述. 在至少指定 clusterName 参数的情况下运行 submitJob startCluster 命令。
参数 描述 类型
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。

作业参数

表 24. stopCluster 参数描述. 在指定 clusterName 参数的情况下运行 submitJob stopCluster 命令。
参数 描述 类型
clusterName 指定要停止的集群的名称。 String

用法示例

AdminTask.submitJob('[-jobType stopCluster -targetList [DmgrManagedNodeName] 
 -jobParams [clusterName newCluster1]]')

提交作业以运行命令

系统管理员可以使用作业管理器的 runCommand 作业在远程主机上运行命令。该命令可以是命令行实用程序(例如 app_server_root/bin 目录中的 startServer)、wsadmin 命令或操作系统命令。

作业参数

表 25. runCommand 参数描述. 在至少指定 command 参数的情况下运行 submitJob runCommand 命令。
参数 描述 类型
command 指定要运行的命令的名称。 String
workingDir 指定远程主机上命令文件的位置。缺省值为远程主机上的 app_server_root 目录。 String

用法示例

[Linux]
AdminTask.submitJob('-jobType runCommand -targetList Target1
 -username user1 -password ******* -jobParams [[command ./versionInfo.sh]]')
[Windows]
AdminTask.submitJob('-jobType runCommand -targetList Target1
 -username user1 -password ******* -jobParams [[command versionInfo.bat]]')
[Linux]
AdminTask.submitJob('-jobType runCommand -targetList Target1
 -username user1 -password *******
 -jobParams [[command "./java -version"][workingDir /opt/IBM/WebSphere/AppServer/java/bin]]')
[Windows]
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 管理命令。

作业参数

表 26. manageprofiles 参数描述. 在至少指定 wasHome 和 responseFile 参数的情况下运行 submitJob 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 产品。

支持的配置 支持的配置: 需要 IBM Installation Manager 1.4.3 或更高版本。sptcfg

installIM

installIM 管理作业通过将安装工具箱从作业管理器发送到主机来安装 Installation Manager 的新实例。

作业参数

表 27. installIM 参数描述. 在至少指定 kitPath 参数的情况下运行 submitJob installIM 命令。
参数 描述 类型
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 安装套件,然后将 Installation Manager 安装套件位置更改为另一个位置。

updateIM

updateIM 管理作业使用存储库来更新现有 Installation Manager,而不是从作业管理器发送安装工具箱。此 updateIM 命令需要 Installation Manager V1.4 或更高版本。

作业参数

表 28. updateIM 参数描述. 在至少指定 repository 和 installPath 参数的情况下运行 submitJob updateIM 命令。
参数 描述 类型
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 响应文件及可选的密钥环文件的作业,以使用远程存储库来管理密钥环。

避免故障 避免故障: 缺省情况下,此作业将指定的数据位置强制设置为绝对路径。
  • [Windows]路径必须以盘符开头。
  • [AIX][HP-UX][IBM i][Linux][Solaris][z/OS]路径必须以 / 开头。
要移除此限制,请将以下 Java 属性设置为 true:com.ibm.ws.admin.cimjm.disableDataLocationAbsolutePathCheck=truegotcha

作业参数

表 29. manageOfferings 参数描述. 在至少指定 responseFile 参数的情况下运行 submitJob manageOfferings 命令。
参数 描述 类型
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 数据位置。

如果路径包含分号 (;),请使用双引号 (") 将路径引起来。例如:"/opt/my,path";/opt/data1。作业可以检测到 Installation Manager 注册表中所记录的数据位置。在 Unix 平台上,非管理安装的缺省注册表位于 userhome/etc/.ibm/registry。管理安装的缺省注册表位于 /etc/.ibm/registry。不需要添加缺省注册表中记录的数据位置。作业会执行下列步骤:
  • 验证其他 IM 数据位置字段中所指定的数据位置,以及作业在执行搜索(如果搜索系统操作设为 true)期间找到的数据位置
  • 将有效的数据位置附加到现有的数据位置列表以供将来使用
  • 移除重复的数据位置
  • 运行库存作业
作业完成时,目标的库存是最新的。

作业参数

表 30. findIMDataLocation 参数描述. 在至少指定 responseFile 参数的情况下运行 submitJob findIMDataLocation 命令。可以同时指定 searchSystem 和 dataLocations 参数。
参数 描述 类型
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 配置文件来轻松地添加功能以及进行管理。

Liberty 安装需要 Java Development Kit (JDK) 或 Java 运行时环境 (JRE) 才能运行用于启动或停止服务器的作业。通过完成下列其中一个操作来设置 JDK 或 JRE 位置:
  • server.env 文件中将 JAVA_HOME 属性设置为 JDK 或 JRE 位置。运行命令以启动或停止服务器之前,作业会在目标环境上读取并设置 JAVA_HOME 属性。但是,如果手动启动或停止服务器,那么 Liberty 服务器命令不使用此属性。

    [z/OS]server.env 文件必须为 EBCDIC 编码。

  • [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 系统变量。

如果未在 server.env 或用户环境中指定 JAVA_HOME,那么作业管理器会在用户搜索路径中查找 JDK 或 JRE。

installLibertyProfileResources

installLibertyProfileResources 作业会将 Liberty 映像中的资源解压缩到相对于根目录的目标目录。在运行此作业之前,必须存在下列情况:

  • 必须向作业管理器注册主机。
  • 映像是一个压缩文件(zip 文件),必须以满足作业管理器规则的目录结构包含 Liberty 资源。请参阅“将 Liberty 资源打包”。
  • 必须定义目标主机上要安装资源的根目录。至少将 WLP_WORKING_DIR 变量设为目标主机上的有效目录。要将资源安装到目标主机上的共享目录,必须将 WLP_SHARED_DIR 变量设为有效的目录。请参阅“为 Liberty 服务器设置变量”。

部署资源期间,产品会将变量替换应用到每个 Liberty 服务器中的 bootstrap.properties 文件。

[z/OS]server.env 文件必须为 EBCDIC 编码。

作业会按以下顺序尝试下列方法,在目标主机上解压缩映像:
  • 在主机上使用 unzip 实用程序。
  • 在主机上使用 jar 实用程序,包括库存作业所找到的软件开发包 (SDK) 中的 jar 实用程序。
  • [Windows]使用执行作业期间复制到远程主机的 unzip 实用程序(如果管理员未明确地将其禁用)。完成作业后,会删除 unzip 实用程序。
  • 在作业管理器上解压缩 zip 文件,并将文件逐个复制到目标主机。只有在 Liberty 服务器映像位于作业管理器上时,此方法才适用。

如果资源实例已存在于目标目录中,那么作业会失败,而不安装资源。

作业参数

表 31. installLibertyProfileResources 参数描述. 在至少指定 image 或 url 参数的情况下运行 submitJob installLibertyProfileResources 命令。
参数 描述 类型
image 如果提供 Liberty 映像的压缩文件位于作业管理器主机上,那么指定压缩文件的完整路径名;例如:
[AIX][HP-UX][Linux][Solaris]
/resources/my_liberty_server.zip
[Windows]
c:/resources/my_liberty_server.zip
String
url 如果提供 Liberty 资源的压缩文件并不位于作业管理器主机上,那么指定压缩文件的 URL 路径。统一资源定位符 (URL) 的支持模式名称包含 httphttpsftpfile
限制: 目标主机必须具有 wget 实用程序,才能指定除 file 之外的 URL 协议。选择目标主机上的 wget 实用程序支持的 httphttpsftp 远程下载协议。如果 wget 实用程序不支持所选协议,那么该作业无法安装这些资源。

例如,对资源文件 my_liberty_server.zip 指定下列其中一个 URL。

如果 Liberty 服务器资源位于 HTTP 或 HTTPS 服务器上:

http://www.mycompany.com/resources/my_liberty_server.zip

https://www.mycompany.com/resources/my_liberty_server.zip

如果资源位于 FTP 服务器上:

ftp://www.mycompany.com/resources/my_liberty_server.zip

如果资源位于目标主机上,那么 URL 可以使用文件模式来描述压缩文件的路径和名称:

[AIX][HP-UX][Linux][Solaris]
file:///resources/my_liberty_server.zip
[Windows]
file://c:/resources/my_liberty_server.zip

如果 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

用法示例

以下示例在作业管理器所在的同一主机上具有映像,并且安装到 WLP_WORKING_DIR:
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
 -description installLibertyProfileResources
 -jobParams [ [image /tmp/liberty/wlpwithjava.zip] [share FALSE] ]]')
以下示例在目标主机上具有映像,对映像指定 file URL,并且安装到 WLP_WORKING_DIR:
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
 -description installLibertyProfileResources
 -jobParams [ [url file://c:/LibertyWorking/LibertyWorkingwjava.zip] [share FALSE] ]]')
以下示例在受密码保护的远程 ftp 服务器上具有映像,并且安装到 WLP_WORKING_DIR:
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] ]]')
以下示例在受密码保护的远程 http 服务器上具有映像,并且安装到 WLP_WORKING_DIR:
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] ]]')
以下示例在受密码保护的远程 https 服务器上具有映像,并且安装到 WLP_SHARED_DIR:
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 映像来进行手动安装之后)安装到主机上目标目录中的资源。

如果存在下列任一情况,那么产品会返回错误,并且不移除资源:
  • 命令指定多种资源类型进行移除。
  • 资源名称解析为多个同名资源。
  • 资源不存在于作业管理器可以访问和搜索的目录中。
避免故障 避免故障: 如果作业失败,那么可能会删除某些文件。资源可能处于已损坏状态。如果手动更改资源文件来修正问题,那么请在更改文件之后运行库存作业以更新库存。gotcha

作业参数

表 32. uninstallLibertyProfileResources 参数描述. 在仅指定一个用于确定所要移除资源的参数的情况下运行 submitJob uninstallLibertyProfileResources 命令。
参数 描述 类型
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

Liberty 服务器需要 Java Development Kit (JDK) 或 Java 运行时环境 (JRE) 才能运行此作业。通过完成下列其中一个操作来设置 JDK 或 JRE 位置:
  • server.env 文件中将 JAVA_HOME 属性设置为 JDK 或 JRE 位置。运行命令以启动服务器之前,作业会在目标环境上读取并设置 JAVA_HOME 属性。但是,如果手动启动服务器,那么 Liberty 服务器命令不使用此属性。

    [z/OS]server.env 文件必须为 EBCDIC 编码。

  • [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 系统变量。

作业参数

表 33. startLibertyProfileServer 参数描述. 在指定 startResource 参数的情况下运行 submitJob startLibertyProfileServer 命令。
参数 描述 类型
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

作业参数

表 34. stopLibertyProfileServer 参数描述. 在指定 stopResource 参数的情况下运行 submitJob stopLibertyProfileServer 命令。
参数 描述 类型
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/

此作业需要通往目标主机上 Liberty 服务器的 Java 管理扩展 (JMX) 连接。可以使用本地连接器或 HTTP/REST 连接器来配置 JMX 连接。在 Liberty 服务器的 server.xml 文件中指定连接器功能部件名称。以下示例显示了 server.xml 文件中本地连接器和 HTTP/REST 连接器的功能部件名称:
<featureManager>
  <feature>localConnector-1.0</feature>
  <feature>restConnector-1.0</feature>
  ...
</featureManager>
如果使用 HTTP/REST 连接器,那么在提交作业时必须指定 JMX 连接的用户名和密码。
作业会停止,而且当存在下列任一情况时,产品会返回错误:
  • 目标 Liberty 服务器未在运行。
  • 没有为目标 Liberty 服务器配置任何 JMX 连接器。
  • 命令没有为 JMX 连接指定有效的凭证。

作业参数

表 35. generateMergedPluginConfigForLibertyProfileServers 参数描述. 在指定 serverName 和 connection 参数的情况下运行 submitJob generateMergedPluginConfigForLibertyProfileServers 命令。
参数 描述 类型
serverName 指定要在目标主机上为其生成 plugin-cfg.xml 文件的服务器的名称或资源标识。Liberty 服务器必须正在目标主机上运行。 String
jmxuser 指定 JMX 连接的用户名。如果要将 HTTP/REST 连接器用于 JMX 连接,请指定此参数。 String
jmxpassword 指定 JMX 连接的密码。如果要将 HTTP/REST 连接器用于 JMX 连接,请指定此参数。 String

用法示例

以下示例会在目标主机(host1host2)上为 Liberty 服务器 defaultServer 生成合并的 plugin-cfg.xml 文件:

AdminTask.submitJob('[-jobType generateMergedPluginConfigForLibertyProfileServers
 -targetList [host1 host2] -description generateMergedPluginConfigForLibertyProfileServers
 -jobParams [[jmxpassword ********][serverName runtime/wlp/liberty_server/defaultServer][jmxuser c]]]') 

指示主题类型的图标 参考主题



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