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.

[AIX Solaris HP-UX Linux Windows]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.

[IBM i]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.

[AIX][Linux][Solaris][HP-UX]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.

[Windows]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.

Eviter les incidents Eviter les incidents: Si le message ADMC0074E : La connexion va être fermée par suite d'une erreur irrémédiable apparaît dans le fichier journal système, il est probable qu'un client a tenté d'envoyer un nom d'utilisateur et un mot de passe à un autre serveur sur lequel la sécurité est désactivée. Vous pouvez ignorer ce message car le client aligne automatiquement ses paramètre de sécurité sur ceux du serveur avec lequel il tente de communiquer. La connexion demandée est établie au bout du compte. Toutefois la sécurité est à présent désactivée aussi bien pour le client d'administration que pour le serveur destinataire.gotcha

Syntaxe

La syntaxe de la commande peut se présenter sous l'une des formes ci-dessous :

stopServer <server_name> [options]

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.

[AIX Solaris HP-UX Linux Windows][z/OS]Cet argument est obligatoire.

[IBM i]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>

nom_agent_admin représente le nom de l'agent d'administration que vous souhaitez arrêter.

stopServer <job_manager>

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 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 :
ADMN0022E : Accès refusé pour l'opération stop
sur le MBean serveur 
suite à des justificatifs
insuffisants ou vides.
Pour résoudre cet incident, indiquez l'ID utilisateur et le mot de passe.gotcha
-help
Imprime une syntaxe.
-?
Imprime une syntaxe.

Scénario d'utilisation

Les exemples suivants montrent la syntaxe correcte :

[AIX Solaris HP-UX Linux Windows][z/OS]
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]
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)

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_stopserver
Nom du fichier : rxml_stopserver.html