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
java -jar <jar file name>.jar
Opération
- Pour Windows : fichier jar %HOMEPATH%/wlpExtract/< name>_nnnnnnnnnnnnnnnnnnn
- Pour toutes les autres plateformes : fichier jar $HOME/wlpExtract/< 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 Ctrl-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 :
- 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.
- 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
Nom de variable d'environnement | Description |
---|---|
WLP_JAR_EXTRACT_ROOT | Extrait le fichier JAR dans le répertoire ${WLP_JAR_EXTRACT_ROOT}/< name>_nnnnnnnnnnnnnnnnnnn |
WLP_JAR_EXTRACT_DIR | Extrait le 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 en utilisant server debug <nom_serveur> au lieu de server run <nom_serveur>. |
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. |