
![[8.5.5.6 或更新版本]](../ng_v8556.gif)
batchManager 指令行用戶端公用程式
batchManager 指令行用戶端公用程式提供指令行介面,來管理在 Liberty 設定檔上執行的批次工作。
batchManager 指令行用戶端公用程式會透過批次管理器的 REST API,與批次管理程式互動。如果要使用 batchManager 指令行用戶端公用程式,批次管理程式必須正在 Liberty 設定檔伺服器上執行。請使用批次管理特性,來安裝並啟用 Liberty 設定檔批次管理程式。
SSL 配置
batchManager 指令行用戶端公用程式會透過 SSL 連線,與批次管理程式互動。為了方便與正在 Liberty 設定檔伺服器上執行的批次管理程式進行 SSL 通訊,公用程式必須能夠驗證 Liberty 設定檔伺服器的 SSL 憑證。
如果 SSL 憑證由已知的憑證管理中心 (CA) 簽署,公用程式可讓 CA 驗證該憑證。不必進行進一步的配置。
如果 SSL 憑證不是由 CA 簽署,您必須執行下列其中一個動作,將公用程式配置成信任伺服器的 SSL 憑證。
- 指定 --trustSslCertificates 選項,這會將公用程式配置成信任所有 SSL 憑證。
- 將伺服器的 SSL 憑證包含在公用程式的信任儲存庫中。
如果您選擇指定 --trustSslCertificates 選項,公用程式會信任它所接收的所有 SSL 憑證,且不需進行進一步的配置。
如果您選擇的選項是將伺服器的 SSL 憑證包含在公用程式的信任儲存庫中,您還必須配置公用程式,讓它可以找到其信任儲存庫。此公用程式是獨立式 Java 主要程式。您將使用 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 keytool 公用程式來匯出和匯入憑證。在下列範例中,伺服器憑證儲存在 [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 [指令] [選項]
查看可用的指令清單:
$ batchManager help
查看特定指令的說明和選項:
$ batchManager help [指令]
下列範例說明如何提交工作,並等待其完成:
$ batchManager submit \
--batchManager=<host>:<port>
--user=[用來登入批次管理程式的認證]
--password=[用來登入批次管理程式的認證]
--applicationName=[包裝批次應用程式時所用的應用程式名稱]
--jobXMLName=[應用程式 batch-jobs 目錄中的工作 XML 檔基本名稱]
--wait
回覆碼
batchManager 指令行用戶端公用程式所輸出的回覆碼如下:
代碼 | 說明 |
---|---|
0 | 作業正常完成。 |
20 | 未指定必要引數。 |
21 | 指定的引數無法辨識。 |
22 | 指定的引數值無效。 |
255 | 發生不明錯誤。 |
註: 如果您指定 --wait 引數,公用程式會輸出下列回覆碼,指出您正在等待之工作的狀態。
代碼 | 說明 |
---|---|
33 | 工作已停止。 |
34 | 工作未順利完成。 |
35 | 工作已順利完成。 |
36 | 工作已被放棄。 |