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 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 Liberty. Utilisez la fonction de gestion par lots pour installer et activer le gestionnaire par lots 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 Liberty, l'utilitaire doit pouvoir vérifier le certificat SSL du serveur 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=[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 et jobPropertiesFile
jobParametersFile=filePath1,filePath2,filePath3
jobPropertiesFile=filePath1,filePath2,filePath3
A titre d'exemple, --jobParametersFile=<filepath1> substitue --jobParametersFile=<filepath1>,<filepath2> dans le fichiers de propriétés de
contrôle.
Le paramètre obtenu est --jobParametersFile=<filepath1>. 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é. |