Administration de Liberty depuis la ligne de commande
Vous pouvez utiliser la commande server et le fichier JAR exécutable ws-server.jar pour créer un serveur, démarrer ou arrêter un serveur, vérifier si un serveur est démarré ou déboguer un serveur.
Pourquoi et quand exécuter cette tâche
Le répertoire wlp/bin
contient un script appelé server, avec lequel vous pouvez contrôler le processus serveur. La syntaxe de ce script est la suivante :
server <action> [server] [options]
Pour prendre connaissance des valeurs disponibles pour les options, voir Option de commande serveur.
Eviter les incidents : La console d'administration permet de démarrer et d'arrêter un serveur Liberty membre
d'un cluster auto-évolutif, mais uniquement lorsque le serveur se trouve en mode maintenance. Le démarrage ou l'arrêt d'un serveur Liberty à partir de la ligne de commande lorsque le
serveur Liberty est membre d'un cluster auto-évolutif peut entraîner des résultats imprévisibles.
Ce script prend en charge les actions
suivantes :
- create
- Commande permettant de créer un serveur.
- debug
- Commande permettant d'exécuter le serveur nommé en avant-plan dans la console après la connexion d'un débogueur au port de débogage. Le port par défaut est 7777. Vous pouvez utiliser la variable WLP_DEBUG_ADDRESS pour spécifier un autre port.
- dump
- Commande permettant de créer un instantané d'un serveur et de sauvegarder les résultats dans un fichier archive à des fins de diagnostic et d'optimisation.
- javadump
- Commande qui crée une image instantanée de la machine virtuelle
Java™ du serveur et qui sauvegarde le résultat dans des fichiers. Chaque type de cliché mémoire crée un fichier, mais les types de cliché mémoire ne
sont pas tous pris en charge par toutes les machines virtuelles. Le répertoire par défaut des fichiers de cliché mémoire est ${server.output.dir}. Pour
définir un répertoire par défaut différent, vous devez utiliser une machine virtuelle Java IBM® et définir les
variables d'environnement suivantes :
- IBM_HEAPDUMPDIR
- IBM_COREDIR
- IBM_JAVACOREDIR
- list
- Commande permettant de répertorier les serveurs d'application Liberty définis.
- package
- Commande permettant de conditionner un serveur.
pause
Commande mettant en pause tous les composants qui peuvent l'être sur le serveur. Pour mettre en pause des composants spécifiques, utilisez l'option --target. Pour plus d'informations sur les commandes pause et resume, consultez Mettre en pause et reprendre un serveur Liberty à partir de la ligne de commande.
resume
Commande effectuant la reprise de tous les composants qui peuvent être mis en pause sur le serveur. Pour reprendre des composants spécifiques, utilisez l'option --target. Pour plus d'informations sur les commandes pause et resume, consultez Mettre en pause et reprendre un serveur Liberty à partir de la ligne de commande.
- run
- Commande permettant de lancer le serveur en avant-plan.
- start
- Commande permettant de démarrer le serveur comme processus d'arrière plan.
- Vous pouvez utiliser la variable d'environnement WLP_ZOS_PROCEDURE pour spécifier le nom d'une procédure STC à utiliser pour démarrer le serveur en tant que tâche démarrée z/OS et non pas en tant que processus d'arrière-plan USS. Voir Personnalisation de l'environnement Liberty.
- stop
- Commande permettant d'arrêter un serveur en cours d'exécution.
- status
- Commande permettant de vérifier si un serveur spécifié est démarré.
- version
- Commande permettant d'afficher les informations de version du serveur actuel et de l'environnement d'exécution Java.
- help
- Commande permettant d'afficher l'aide du script de ligne de commande, avec des détails sur les options supplémentaires.
Remarque : Si aucun serveur n'est spécifié
sur la ligne de commande, l'action est effectuée pour l'instance de
serveur par défaut (defaultServer), si elle existe.
Vous pouvez aussi exécuter des actions similaires en utilisant le fichier JAR exécutable
ws-server.jar qui se trouve dans le répertoire ${wlp.install.dir}/bin/tools. Exemple
Pour exécuter le script server sur un système Windows :
server.bat create server_name
server.bat package server_name
server.bat run server_name
server.bat help server_name
Pour exécuter le script server sur d'autres systèmes :server create server_name
server package server_name
server run server_name
server help server_name
Pour exécuter le fichier JAR exécutable ws-server.jar sans utiliser le script server :
java -javaagent:bin/tools/ws-javaagent.jar -jar bin/tools/ws-server.jar server_name --create
java -javaagent:bin/tools/ws-javaagent.jar -jar bin/tools/ws-server.jar server_name
java -javaagent:bin/tools/ws-javaagent.jar -jar bin/tools/ws-server.jar --help
L'option --help affiche des informations sur les autres paramètres de ligne de commande
du fichier JAR exécutable ws-server.jar, comme --stop, --version, --clean, --include.