Administration du profil 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 du serveur. La syntaxe de ce script est la suivante :
server
<action> [serveur]
[options]
Pour prendre connaissance des valeurs disponibles pour les options, voir Options de la commande server.
Ce script prend en charge les actions
suivantes :
- create
- Commande permettant de créer un serveur.
- run
- Commande permettant de lancer le serveur en avant-plan.
- 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é crée un fichier, mais les types de cliché ne sont pas tous pris en charge par toutes les machines virtuelles. Le répertoire par défaut pour les fichiers de cliché 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
- package
- Commande permettant de conditionner un serveur.
- start
- Commande permettant de lancer le serveur en tant que 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 nom_serveur
server.bat package nom_serveur
server.bat run nom_serveur
server.bat help nom_serveur
Pour exécuter le script server sur d'autres systèmes :server create nom_serveur
server package nom_serveur
server run nom_serveur
server help nom_serveur
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 nom_serveur --create
java -javaagent:bin/tools/ws-javaagent.jar -jar bin/tools/ws-server.jar nom_serveur
java -javaagent:bin/tools/ws-javaagent.jar -jar bin/tools/ws-server.jar --help
L'option --help affiche des informations sur les
paramètres de ligne de commande supplémentaires pour le fichier JAR exécutable ws-server.jar, comme --stop, --version,
--clean, --include.