
![[8.5.5.6 ou ultérieure]](../ng_v8556.gif)
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.
- 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.
$ export JVM_ARGS="-Djavax.net.ssl.trustStore=/path/to/server/keystore.jks"
$ batchManager submit ...
$ 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
$ 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
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. |
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é. |