Liberty-Repository[8.5.5.6 oder höher]

Befehlszeilenbasiertes Clientdienstprogramm "batchManager"

Das befehlszeilenbasierte Clientdienstprogramm "batchManager" stellt eine Befehlszeilenschnittstelle für die Verwaltung Ihrer Stapeljobs bereit, die im Liberty-Profil ausgeführt werden.

Das befehlszeilenbasierte Clientdienstprogramm "batchManager" interagiert mit dem Stapelmanager über die REST-API des Stapelmanagers. Um "batchManager" verwenden zu können, muss der Stapelmanager auf Ihrem Liberty Profile-Server ausgeführt werden. Verwenden Sie die Funktion für Stapelverwaltung, um den Liberty Profile-Stapelmanager zu installieren und zu aktivieren.

SSL-Konfiguration

Das befehlszeilenbasierte Clientdienstprogramm "batchManager" kommuniziert mit dem Stapelmanager über eine SSL-Verbindung. Um die SSL-Kommunikation mit einem Stapelmanager, der auf einem Liberty Profile-Server ausgeführt wird, zu vereinfachen, muss das Dienstprogramm das SSL-Zertifikat des Liberty Profile-Servers überprüfen können.

Wenn das SSL-Zertifikat von einer anerkannten Zertifizierungsstelle (CA, Certificate Authority) signiert wurde, kann das Dienstprogramm das Zertifikat der Zertifizierungsstelle überprüfen. Eine weitere Konfiguration ist nicht erforderlich.

Wenn das SSL-Zertifikat nicht von einer CA signiert wurde, müssen Sie das Dienstprogramm so konfigurieren, dass es das SSL-Zertifikat des Servers anerkennt, indem Sie eine der folgenden Aktionen ausführen:
  • Geben Sie die Option --trustSslCertificates an, mit der das Dienstprogramm so konfiguriert wird, dass es alle SSL-Zertifikate anerkennt.
  • Nehmen Sie das SSL-Zertifikat des Servers in den Truststore des Dienstprogramms auf.

Wenn Sie die Option --trustSslCertificates angeben, erkennt das Dienstprogramm alle SSL-Zertifikate an, die es empfängt. Es ist keine weitere Konfiguration notwendig.

Wenn Sie die Option auswählen, mit der das SSL-Zertifikat des Servers in den Truststore des Dienstprogramms aufgenommen wird, müssen Sie das Dienstprogramm konfigurieren, damit es den zugehörigen Truststore finden kann. Das Dienstprogramm ist eine eigenständige Java-Funktion des Typs "main". Sie konfigurieren SSL mit Systemeigenschaften wie javax.net.ssl.truststore.

 Wenn der Stapelmanager auf derselben Maschine ausgeführt wird wie das Dienstprogramm, können Sie mit dem Dienstprogramm direkt auf den Server-Keystore verweisen:
   $ export JVM_ARGS="-Djavax.net.ssl.trustStore=/path/to/server/keystore.jks"
   $ batchManager submit ...
Achtung: JVM-Argumente, wie z. B. Eigenschaften des Typs -D, werden an das befehlszeilenbasierte Clientdienstprogramm "batchManager" mit der Umgebungsvariablen JVM-ARGS übergeben.
Wenn Sie den Server-Keystore nicht direkt verwenden können, müssen Sie das Serverzertifikat aus dem Server-Keystore exportieren und in den Truststore des Clients importieren. Verwenden Sie das JDK-Dienstprogramm "keytool" für den Export und Import von Zertifikaten. Im folgenden Beispiel wird das Serverzertifikat in der Keystoredatei [server-dir]/resources/security/key.jks unter dem Alias default gespeichert und das Kennwort ist 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
Achtung: Der Befehl import erstellt die Datei truststore.jks, wenn sie nicht vorhanden ist.
    $ export JVM_ARGS="-Djavax.net.ssl.trustStore=/path/to/truststore.jks"
    $ batchManager submit ...

Befehle und Syntax

Das befehlszeilenbasierte Clientdienstprogramm "batchManager" stellt Befehle bereit, mit denen Sie Jobs übergeben, stoppen, erneut starten und den Status von Jobs überprüfen können.

Die allgemeine Syntax des Dienstprogramms lautet wie folgt:

$ batchManager [Befehl] [Optionen]

Geben Sie den folgenden Befehl ein, um eine Liste der verfügbaren Befehle anzuzeigen:

$ batchManager help

Geben Sie den folgenden Befehl ein, um die Beschreibung und Optionen für einen bestimmten Befehl anzuzeigen:

$ batchManager help [Befehl]

Das folgende Beispiel veranschaulicht die Übergabe eines Jobs und das Warten auf den Abschluss des Jobs:

  $ batchManager submit \
        --batchManager=<Host>:<Port>
        --user=[Berechtigungsnachweise für die Anmeldung beim Stapelmanager]
        --password=[Berechtigungsnachweise für die Anmeldung beim Stapelmanager]
        --applicationName=[Anwendungsname, der beim Packen der Stapelanwendung verwendet wird]
        --jobXMLName=[XML-Basisdateiname des Jobs im Anwendungsverzeichnis für Stapeljobs]
        --wait

Rückgabecodes

Das befehlszeilenbasierte Clientdienstprogramm "batchManager" gibt die folgenden Rückkehrcodes aus:
Code Beschreibung
0 Die Task wird normal beendet.
20 Ein erforderliches Argument wurde nicht angegeben.
21 Es wurde ein nicht erkanntes Argument angegeben.
22 Es wurde ein ungültiges Argument angegeben.
255 Es ist ein unbekannter Fehler aufgetreten.
Anmerkung: Wenn Sie das Argument --wait angeben, gibt das Dienstprogramm die folgenden Rückkehrcodes zum Status des Jobs aus, auf den Sie warten.
Code Beschreibung
33 Der Job wurde gestoppt.
34 Der Job wurde nicht erfolgreich ausgeführt.
35 Der Job wurde erfolgreich ausgeführt.
36 Der Job wurde abgebrochen.

Symbol das den Typ des Artikels anzeigt. Konzeptartikel

Nutzungsbedingungen für Information Center | Feedback


Symbol für Zeitmarke Letzte Aktualisierung: 25.08.2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=cwlp_jbatch_commandlineutil
Dateiname: cwlp_jbatch_commandlineutil.html