batchManager 命令行客户机实用程序

batchManager 命令行客户机实用程序提供命令行界面以管理在 Liberty 上运行的批处理作业。

batchManager 命令行客户机实用程序通过批处理管理器的 REST API 与批处理管理器交互。要使用 batchManager 命令行客户机实用程序,批处理管理器必须正在 Liberty 服务器上运行。使用 Batch Management 功能部件安装并启用 Liberty 批处理管理器。

SSL 配置

batchManager 命令行客户机实用程序通过 SSL 连接与批处理管理器通信。为方便与正在 Liberty 服务器上运行的批处理管理器进行 SSL 通信,该实用程序必须能够验证 Liberty 服务器的 SSL 证书。

如果 SSL 证书由知名认证中心 (CA) 签署,那么该实用程序可让 CA 验证该证书。不必进行更多配置。

如果 SSL 证书并非由 CA 签署,那么您必须执行下列其中一个操作来配置该实用程序以信任服务器的 SSL 证书。
  • 指定选项 --trustSslCertificates,这会将该实用程序配置为信任所有 SSL 证书。
  • 将服务器的 SSL 证书包含在实用程序的信任库中。

如果选择指定选项 --trustSslCertificates,那么该实用程序信任它接收的所有 SSL 证书,并且不必进行更多配置。

如果选择要将服务器的 SSL 证书包含在实用程序的信任库中的选项,那么还必须配置该实用程序以便该实用程序可找到其信任库。该实用程序是独立 Java main。通过使用 javax.net.ssl.truststore 之类的系统属性配置 SSL。

 如果批处理管理器与该实用程序在同一机器上运行,那么可让该实用程序直接指向服务器密钥库:
   $ export JVM_ARGS="-Djavax.net.ssl.trustStore=/path/to/server/keystore.jks"
   $ batchManager submit ...
注意: -D 属性之类的 JVM 自变量通过 JVM-ARGS 环境变量传递至 batchManager 命令行客户机实用程序。
如果无法直接使用服务器密钥库,那么必须从服务器密钥库导出服务器证书,然后将其导入至客户机信任库。使用 JDK 密钥工具实用程序导出和导入证书。在以下示例中,服务器证书存储在 [server-dir]/resources/security/key.jks 密钥库文件中的 default 别名下,密码为 Liberty
    $ keytool -export -alias default -file server.crt -keystore [server-dir]/resources/security/key.jks -storepass Liberty
    $ keytool -import -alias server_crt -file server.crt -keystore /path/to/truststore.jks -storepass passw0rd
注意: import 命令创建 truststore.jks 文件(如果该文件不存在)。
    $ export JVM_ARGS="-Djavax.net.ssl.trustStore=/path/to/truststore.jks"
    $ batchManager submit ...

命令和用法

batchManager 命令行客户机实用程序提供用于提交、停止、重新启动作业和检查作业状态的命令。

以通用方式使用实用程序:

$ batchManager [command] [options]

查看可用命令列表:

$ batchManager help

查看特定命令的描述和选项:

$ batchManager help [command]

以下示例说明如何提交作业并等待其完成:

  $ batchManager submit \
        --batchManager=<host>:<port>
        --user=[credentials for logging into the batch manager]
        --password=[credentials for logging into the batch manager]
        --applicationName=[application name used when packaging the batch app]
        --jobXMLName=[job XML file basename in the app's batch-jobs dir]
        --wait

jobParametersFile 和 jobPropertiesFile

使用 batchManager 客户机实用程序来提交批处理作业时,jobParametersFilejobPropertiesFile 支持使用多个文件(以逗号分隔)。在这个以逗号分隔的列表中,出现顺序较后的文件优先于列表中首先出现的文件。以下示例说明以逗号分隔的列表的正确用法。
jobParametersFile=filePath1,filePath2,filePath3
jobPropertiesFile=filePath1,filePath2,filePath3
例如,--jobParametersFile=<filepath1> 将覆盖控制属性文件中的 --jobParametersFile=<filepath1>,<filepath2>。生成的参数为 --jobParametersFile=<filepath1>

返回码

batchManager 命令行客户机实用程序输出以下返回码:
代码 描述
0 任务正常完成。
20 未指定必需的自变量。
21 指定了无法识别的自变量。
22 指定了无效自变量值。
255 发生未知错误。
注: 如果您指定 --wait 自变量,那么该实用程序输出以下返回码以指示您正在等待的作业的状态。
代码 描述
33 该作业已停止。
34 该作业未成功完成。
35 该作业已成功完成。
36 该作业已被放弃。

用于指示主题类型的图标 概念主题



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