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
Par exemple, --jobParametersFile=<filepath1> prévaudrait sur
--jobParametersFile=<filepath1>,<filepath2> dans le fichier de propriétés de contrôle.
Le paramètre résultant serait --jobParametersFile=<filepath1>.![[17.0.0.3 and later]](../ng_v17003plus.gif)
Propriétés de contrôle et paramètres de travail
Pour générer un ensemble unique de paramètres de travail, le programme commence avec un ensemble vide et charge continuellement des propriétés de différentes sources. Le programme fusionne ensuite les propriétés en un ensemble unique. Après avoir lu et chargé toutes les sources, le programme transmet l'ensemble unique de propriétés à la soumission de travaux en tant que paramètres de travail.
Cet ensemble de propriétés est généré en fusionnant dans cet ordre. Lorsque la même propriété avec la même clé est chargée et définie plusieurs fois, la valeur la plus récente remplace la valeur antérieure. Les dernières étapes de cette séquence ont une priorité plus élevée que les étapes antérieures.
- Si le paramètre --jobParametersFile n'est pas inclus en tant que paramètre de ligne de commande, les actions suivantes se produisent par ordre de priorité croissante :
- Les contenus des fichiers référencés par la propriété de contrôle --jobParametersFile sont chargés et fusionnés. Cette propriété de contrôle peut apparaître dans un seul fichier de propriétés de contrôle ou dans plusieurs fichiers si la propriété a été remplacée.
- Les propriétés de contrôle des paramètres de travail sont chargées et fusionnées. Ces propriétés sont structurées sous la forme --jobParameter=key=value à l'intérieur du fichier de propriétés de contrôle.
- Les paramètres de travail de la ligne de commande sont chargés et fusionnés.
- Si le paramètre --jobParametersFile n'est pas inclus en tant que paramètre de ligne de commande, les actions suivantes se produisent par ordre de priorité croissante :
- Les contenus des fichiers référencés par la propriété de contrôle --jobParametersFile sont chargés et fusionnés. Cette propriété de contrôle peut apparaître dans un seul fichier de propriétés de contrôle ou dans plusieurs fichiers si la propriété a été remplacée.
- Les propriétés de contrôle des paramètres de travail sont chargées et fusionnées. Ces propriétés sont structurées sous la forme --jobParameter=key=value à l'intérieur du fichier de propriétés de contrôle.
- Les paramètres de travail de la ligne de commande sont chargés et fusionnés.
Cette structure se produit car le paramètre --controlPropertiesFile a une priorité inférieure aux arguments de la ligne de commande. Le niveau avec lequel vous spécifiez le paramètre --jobParametersFile détermine le niveau de priorité de ces fichiers.
Alors qu'il lit et charge chaque fichier dans la séquence, le programme réduit les propriétés --jobParametersFile et --jobPropertiesFile trouvées en une seule propriété. Chaque propriété est un alias de l'autre. Le remplacement d'un argument de ligne de commande ou des propriétés de contrôle par l'un de ces alias remplace une instance de l'un des deux apparaissant dans un fichier de propriétés de contrôle remplacé plus tôt.

Utilitaire client de ligne de commande batchManager sur z/OS avec un fichier de clés SAF
Pour utiliser le fichier de clés SAF (System Authorization Facility) de votre serveur Liberty avec l'utilitaire de ligne de commande batchManager du client, vous devez définir les paramètres d'environnement java.environment et spécifier sur l'appel de cet utilitaire un ID utilisateur autorisé à lire le fichier de clés SAF.
Les commandes ci-après autorisent l'utilisateur à lire le fichier de clés SAF.
PermitRingOwnerId.RingName.LST CLASS(RDATALIB)ID(userId)ACCESS(UPDATE)
SETROPTS RACLIST(RDATALIB) GENERIC(RDATALIB) REFRESH
Pour plus d'informations, consultez la référence au langage de commande (CL) WebSphere Application Server z/OS Security Server RACF.
L'exemple ci-après définit la variable d'environnement JVM_ARGS.
export JVM_ARGS="-Djavax.net.ssl.trustStore=safkeyring://ringOwnerId/ringName
-Djavax.net.ssl.trustStoreType=JCERACFKS -Djavax.net.ssl.keyStore=safkeyring://ringOwnerId/ringName
-Djavax.net.ssl.keyStoreType=JCERACFKS -Dcom.ibm.ssl.keyStoreFileBased=false -Dcom.ibm.ssl.trustStoreFileBased=false
-Djava.protocol.handler.pkgs=com.ibm.crypto.provider -Djavax.net.ssl.keyStorePassword=password"
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é. |