Exécution d'un serveur Liberty à partir d'un fichier JAR

Vous pouvez démarrer un serveur Liberty à partir d'un fichier JAR (archive Java). Cette méthode permet de démarrer un serveur Liberty de manière compacte et portable. Vous créez le fichier JAR à l'aide de la commande serveur Liberty, puis vous exécutez ce fichier en tant que fichier JAR exécutable à l'aide de la commande Java -jar.

Création du fichier JAR exécutable

Vous pouvez spécifier minify pour obtenir l'archive la plus petite possible. Vous devez spécifier une archive de type JAR pour obtenir un fichier JAR exécutable. Le type d'archive par défaut est .zip sur toutes les plateformes, à l'exception de z/OS, où le type pris en charge est pax. Exemple :

server package <server name> --include=[minify,]runnable --archive=<jar file name>.jar

Exécution du fichier JAR

Exécutez le fichier JAR à l'aide de la commande java standard avec l'option –jar. Par exemple :
java –jar <jar file name>.jar

Opération

Lorsque le fichier JAR s'exécute, il est extrait vers un emplacement temporaire, puis le serveur s'exécute au premier plan, démarré par la commande run du serveur Liberty. Tous les résultats sont écrits dans stdout ou stderr. Par défaut, les fichiers sont extraits dans des emplacements temporaires :
  • Pour Windows : %HOMEPATH%/wlpExtract/<jar file name>_nnnnnnnnnnnnnnnnnnn
  • Pour toutes les autres plateformes : $HOME/wlpExtract/<jar file name>_nnnnnnnnnnnnnnnnnnn

Vous pouvez contrôler l'emplacement des résultats en utilisant la variable d'environnement WLP_JAR_EXTRACT_ROOT ou WLP_JAR_EXTRACT_DIR.

Arrêt du serveur

Pour arrêter le serveur Liberty, appuyez sur Ctlr-C. Lorsque le serveur Liberty s'arrête, le répertoire d'extraction est automatiquement supprimé. Si vous arrêtez l'interpréteur de commandes actif d'une autre manière, le répertoire d'extraction n'est pas automatiquement nettoyé ; vous devez le nettoyer manuellement.

Exécution en mode débogage

Vous pouvez exécuter le serveur Liberty en mode débogage si vous définissez la variable d'environnement WLP_JAR_DEBUG avant de démarrer le serveur.

Contrôle des résultats

Par défaut, les résultats sont écrits dans le répertoire d'extraction, lequel est supprimé lorsque le serveur s'arrête. Si vous souhaitez enregistrer les résultats, indiquez un emplacement de stockage de résultats durable à l'aide de la variable d'environnement WLP_OUTPUT_DIR avant de démarrer le serveur.

Transactions de validation en deux phases

Par défaut, les transactions de validation en deux phases sont désactivées car les journaux de transactions figurent dans le répertoire d'extension et sont supprimés lorsque le serveur liberty est arrêté. Par conséquent, la reprise des transactions n'est pas possible.

Pour activer la validation en deux phases, configurez le journal des transactions pour qu'il soit consigné dans un emplacement durable dans le système de fichiers ou un système de gestion de base de données relationnelle et définissez la variable d'environnement WLP_JAR_ENABLE_2PC.

Pour configurer le journal des transactions, utilisez l'attribut transactionLogDirectory ou l'attribut dataSourceRef sur l'élément de transaction dans votre fichier de configuration server.xml.

Exécution sous CYGWIN

L'exécution d'un fichier JAR de serveur Liberty dans un interpréteur de commandes CYGWIN répond à deux exigences :

  1. Spécifiez la variable d'environnement WLP_JAR_CYGWIN.

    Lorsque cette variable est définie, le module d'exécution JAR du serveur Liberty effectue un traitement de processus et de fichier de style UNIX lorsqu'il s'exécute dans l'environnement CYGWIN.

  2. Effectuez cette exécution sous l'interpréteur de commandes bash, et non mintty.

    La suppression automatique du fichier d'extraction se produit uniquement lorsque vous effectuez l'exécution sous l'interpréteur de commandes bash. Vous pouvez effectuer l'exécution sous mintty, mais vous devez supprimer les fichiers d'extraction manuellement. Mintty ne réachemine pas le signal nécessaire pour déclencher les unités d'exécution de fermeture Java.

Référence de variable d'environnement

Tableau 1. Noms de variable d'environnement et définitions correspondantes
Nom de variable d'environnement Description
WLP_JAR_EXTRACT_ROOT Extrait un fichier JAR dans le répertoire ${WLP_JAR_EXTRACT_ROOT}/<jar file name>_nnnnnnnnnnnnnnnnnnn
WLP_JAR_EXTRACT_DIR Extrait un fichier JAR dans le répertoire ${WLP_JAR_EXTRACT_DIR}.
WLP_OUTPUT_DIR Ecrit les fichiers de sortie du serveur Liberty dans le répertoire ${WLP_OUTPUT_DIR}.
WLP_JAR_DEBUG Exécute le serveur Liberty à l'aide de server debug <server name> à la place de server run <server name>.
WLP_JAR_ENABLE_2PC Affectez la valeur true à cette variable d'environnement pour active 2PC lorsque le fichier JAR exécutable s'exécute.
WLP_JAR_CYGWIN Affectez la valeur true à cette variable d'environnement si vous exécutez le fichier JAR sous CYGWIN.

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: Tuesday, 6 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwlp_setup_jarserver
Nom du fichier : rwlp_setup_jarserver.html