Commande stopServer
La commande stopServer lit le fichier de configuration du processus serveur spécifié. Elle envoie une commande JMX (Java™ management extensions) au serveur lui indiquant de s'arrêter.
Le processus serveur peut être un serveur d'applications, un DMZ Secure Proxy Server for IBM® WebSphere Application Server, un serveur agent d'administration ou un serveur gestionnaire de travaux.
Par défaut, la commande stopServer ne retourne pas de contrôle à la ligne de commande tant que le serveur n'est pas complètement arrêté. L'option -nowait permet un renvoie immédiat, d'autres de contrôler le comportement de la commande stopServer. Pour plus d'informations sur l'emplacement où s'exécute cette commande, voir la rubrique Utilisation des outils de ligne de commande.
Si vous exécutez le produit sur un système d'exploitation Microsoft Windows et que votre serveur s'exécute comme un service Windows, la commande stopServer arrête le service Windows chargé de démarrer le serveur.
Même si la commande stopServer renvoie le contrôle une fois l'arrêt du service terminé, elle peut le renvoyer avant la fin du processus IBM i. Selon la quantité de mémoire que la machine virtuelle Java doit renvoyer au pool de mémoire, la durée du processus peut varier de quelques secondes à plusieurs minutes. Tant que le processus n'est pas terminé, n'essayez pas de démarrer le serveur une nouvelle fois. Utilisez la commande CL WRKACTJOB SBS(subsystem) pour déterminer si le processus a totalement pris fin. Par défaut, le sous-système est QWAS85.
Si la sécurité est activée, vous devez utiliser un nom d'utilisateur et un mot de passe avec la commande stopServer, car la commande utilise une méthode MBean sur le serveur.
Les paramètres de nom d'utilisateur et de mot de passe ne sont pas requis avec la commande stopServer. Les paramètres sont automatiquement transmis au script que le service Windows utilise pour arrêter le système.

Syntaxe
La syntaxe de la commande peut se présenter sous l'une des formes ci-dessous :
stopServer <server_name> [options]
où nom_serveur est le nom du répertoire de configuration du serveur d'applications ou du DMZ Secure Proxy Server for IBM WebSphere Application Server que vous souhaitez arrêter.
Cet argument est obligatoire.
Cet argument est facultatif. Si le profil par défaut est utilisé, le serveur par défaut est server1. Si le nom de profil n'est pas celui par défaut, le serveur prend par défaut le nom du profil.
stopServer <adminagent_name>
où nom_agent_admin représente le nom de l'agent d'administration que vous souhaitez arrêter.
stopServer <job_manager>
où gest_travaux représente le nom du gestionnaire de travaux que vous souhaitez arrêter.
Paramètres
Les options suivantes sont disponibles pour la commande stopServer :
- -nowait
- Indique à la commande stopServer de ne pas attendre l'arrêt effectif du processus serveur.
- -quiet
- Supprime les informations de progression que la commande stopServer imprime en mode normal.
- -logfile <fileName>
- Spécifie l'emplacement du fichier journal dans lequel sont consignées les informations de trace. Par défaut, le fichier journal est appelé stopServer.log et est créé dans le répertoire logs.
- -profileName
- Définit le profil d'un processus serveur dans une installation comportant plusieurs profils. L'option -profileName n'est pas nécessaire à l'exécution dans un environnement de profil unique. La valeur par défaut pour cette option correspond au profil par défaut.
- -replacelog
- Remplace le fichier journal au lieu d'ajouter les données à celui en cours.
- -trace
- Génère des informations de trace dans un fichier à des fins de débogage. Le résultat de trace est consign2 dans le fichier stopServer.log qui se trouve dans le répertoire racine_profil/logsserveur.
- -timeout <seconds>
- Indique le temps d'attente avant que la procédure d'arrêt du serveur n'arrive à expiration et ne renvoie une erreur.
- -statusport <portNumber>
- Paramètre facultatif permettant à un administrateur de définir le numéro de port pour le rappel de l'état du serveur. Cet outil ouvre le port et attend le rappel d'état émis par le serveur, un peu avant l'arrêt de celui-ci. Si ce paramètre n'est pas défini, un port inutilisé est automatiquement attribué.
- -conntype <type>
- Spécifie le type de connecteur JMX à utiliser pour la connexion au gestionnaire de déploiement. Les types corrects sont SOAP ou Remote Method Invocation (RMI).
- -port <portNumber>
- Indique le port JMX du serveur à utiliser explicitement de façon à pouvoir éviter de lire les fichiers de configuration pour obtenir des informations.
- -username <name>
- Indique le nom d'utilisateur pour l'authentification si la sécurité est activée sur le serveur. Fonctionne comme l'option -user.
- -user <name>
- Indique le nom d'utilisateur pour l'authentification si la sécurité est activée sur le serveur. Fonctionne comme l'option -username.
- -password <mot de passe>
- Indique le mot de passe pour l'authentification si la sécurité est activée sur le serveur.
Eviter les incidents: Si votre système fonctionne dans un environnement sécurisé et que vous n'avez pas indiqué d'ID utilisateur et de mot de passe, vous recevez le message d'erreur suivant :
Pour résoudre cet incident, indiquez l'ID utilisateur et le mot de passe.gotchaADMN0022E : Accès refusé pour l'opération stop sur le MBean serveur suite à des justificatifs insuffisants ou vides.
- -help
- Imprime une syntaxe.
- -?
- Imprime une syntaxe.
Scénario d'utilisation
Les exemples suivants montrent la syntaxe correcte :
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
stopServer server1
stopServer server1 -nowait
stopServer server1 -trace (produces the stopserver.log file)
stopServer adminagent
stopServer jobmgr
stopServer proxy1 (for the secure proxy profile)
![[IBM i]](../images/iseries.gif)
stopServer server1 (stops the server1 server for the default profile)
stopServer server1 -nowait
stopServer server1 -trace (produces the stopserver.log file)
stopServer -profileName mytest (stops server mytest
configured for profile mytest)
stopServer AdminAgent01
stopServer JobMgr01
stopServer proxy1 (default server name for the SecureProxySrv01 profile)