Référentiel Liberty[8.5.5.6 ou ultérieure]

Utilitaire client de ligne de commande batchManager

L'utilitaire client de ligne de commande batchManager fournit une interface de ligne de commande pour la gestion des travaux qui s'exécutent sur le profil Liberty.

L'utilitaire client de ligne de commande batchManager interagit avec le gestionnaire par lots sur l'API REST du gestionnaire par lots.  Pour utiliser l'utilitaire client de ligne de commande batchManager, le gestionnaire par lots doit s'exécuter sur votre serveur de profil Liberty. Utilisez la fonction de gestion par lots pour installer et activer le gestionnaire par lots du profil Liberty.

Configuration SSL

L'utilitaire client de ligne de commande batchManager communique avec le gestionnaire par lots sur une connexion SSL. Pour faciliter la communication SSL avec un gestionnaire par lots qui s'exécute sur un serveur de profil Liberty, l'utilitaire doit pouvoir vérifier le certificat SSL du serveur de profil Liberty.

Si le certificat SSL est signé par une autorité de certification connue, l'utilitaire peut vérifier le certificat. Aucune configuration supplémentaire n'est nécessaire.

Si le certificat SSL n'est pas signé par une autorité de certification, vous devez configurer l'utilitaire afin qu'il fasse confiance au certificat SSL du serveur en effectuant l'une des actions ci-après.
  • Indiquez l'option --trustSslCertificates, qui configure l'utilitaire afin qu'il fasse confiance à tous les certificats SSL.
  • Incluez le certificat SSL du serveur dans le magasin de clés de confiance de l'utilitaire.

Si vous choisissez d'indiquer l'option --trustSslCertificates, l'utilitaire fait confiance à tous les certificats SSL qu'il reçoit et aucune configuration supplémentaire n'est nécessaire.

Si vous choisissez l'option d'inclure le certificat SSL du serveur dans le magasin de clés de confiance de l'utilitaire, vous devez aussi configurer l'utilitaire afin qu'il puisse trouver son magasin de clés de confiance. L'utilitaire est un principal Java autonome. Pour configurer SSL, vous devez utiliser des propriétés système telles que javax.net.ssl.truststore.

 Si le gestionnaire par lots s'exécute sur la même machine que l'utilitaire, vous pouvez pointer sur l'utilitaire directement au niveau du magasin de clés du serveur :
   $ export JVM_ARGS="-Djavax.net.ssl.trustStore=/path/to/server/keystore.jks"
   $ batchManager submit ...
Avertissement : Les arguments JVM, comme les propriétés -D, sont transmis à l'utilité client de ligne de commande batchManager par la variable d'environnement JVM-ARGS.
Si vous ne pouvez pas utiliser le magasin de clés du serveur directement, vous devez exporter le certificat serveur depuis le magasin de clés du serveur et l'importer dans le magasin de clés de confiance du client.  Utilisez l'utilitaire de clé JDK pour exporter et importer des certificats.  Dans l'exemple ci-après, le certificat serveur est stocké dans le fichier de clés [server-dir]/resources/security/key.jks sous l'alias default, et le mot de passe est 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
Avertissement : La commande import crée le fichier truststore.jks si celui-ici n'existe pas.
    $ export JVM_ARGS="-Djavax.net.ssl.trustStore=/path/to/truststore.jks"
    $ batchManager submit ...

Commandes et utilisation

L'utilitaire client de ligne de commande batchManager fournit des commandes pour soumettre, arrêter, redémarrer et vérifier l'état des travaux.

Pour une utilisation générale de l'utilitaire :

$ batchManager [command] [options]

Pour afficher la liste des commandes disponibles :

$ batchManager help

Pour afficher la description et les options d'une commande spécifique :

$ batchManager help [command]

L'exemple suivant illustre comment soumettre un travail et attendre son achèvement :

  $ batchManager submit \
        --batchManager=<host>:<port>
        --user=[données d'identification pour la connexion dans le gestionnaire par lots]
        --password=[données d'identification pour la connexion dans le gestionnaire par lots]
        --applicationName=[nom d'application utilisé lors de la création du package de l'application par lots]
        --jobXMLName=[nom de base du fichier XML du travail dans le répertoire batch-jobs de l'application]
        --wait

Codes retour

L'utilitaire client de ligne de commande batchManager produit les codes retour suivants :
Code Description
0 La tâche s'est terminée normalement.
20 Un argument obligatoire n'a pas été spécifié.
21 Un argument non reconnu a été spécifié.
22 Un argument non valide a été spécifié.
255 Une erreur inattendue est survenue.
Remarque : Si vous indiquez l'argument --wait, l'utilitaire produit les codes retour suivants concernant l'état du travail que vous attendez.
Code Description
33 Le travail s'est arrêté.
34 Le travail n'a pas abouti.
35 Le travail a abouti.
36 Le travail a été abandonné.

Icône indiquant le type de rubrique Rubrique de concept

Dispositions pour les centres de documentation | Commentaires


Icône d'horodatage Dernière mise à jour: Wednesday, 2 September 2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=cwlp_jbatch_commandlineutil
Nom du fichier : cwlp_jbatch_commandlineutil.html