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.
[17.0.0.1 and later]pause
[17.0.0.1 and later]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.
[17.0.0.1 and later]resume
[17.0.0.1 and later]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.
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.

Icône indiquant le type de rubrique Rubrique Tâche

Nom du fichier : twlp_admin_script.html