Commande stopManager
La commande stopManager lit le fichier de configuration pour le processus du gestionnaire WebSphere Application Server, Network Deployment.
Elle envoie une commande JMX (Java™ Management Extensions) au gestionnaire lui indiquant de s'arrêter. Par défaut, la commande stopManager attend que le gestionnaire ait terminé le processus d'arrêt avant de renvoyer un contrôle à la ligne de commande. Il existe une option -nowait pour un renvoi immédiat ainsi que d'autres options permettant de contrôler le comportement de la commande stopManager. Pour plus d'informations sur l'emplacement depuis lequel exécuter cette commande, voir Utilisation des outils de ligne de commande.
Si vous utilisez le système d'exploitation Windows et que votre gestionnaire de déploiement s'exécute comme un service Windows, la commande stopManager arrête le service Windows associé et est responsable de l'arrêt du gestionnaire de déploiement.
Même si la commande stopServer renvoie le contrôle une fois le serveur arrêté, elle peut s'exécuter 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.
Syntaxe
La syntaxe de la commande est la suivante :
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
stopManager [options]
![[IBM i]](../images/iseries.gif)
stopManager [<server>] [options]
Paramètres
Les options ci-après sont disponibles pour la commande stopManager.
- -nowait
- Indique à la commande stopManager de ne pas attendre l'arrêt effectif du processus du gestionnaire de déploiement.
- -quiet
- Supprime les informations de progression que la commande stopManager 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 créé dans le répertoire logs.
-profileName
Définit le profil d'un processus de serveur d'applications dans une installation avec 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 écrit dans le fichier stopmanager.log qui est situé dans le répertoire racine_profil/logs.
- -timeout <seconds>
- Indique le temps d'attente avant que la procédure d'arrêt du gestionnaire n'arrive à expiration et ne renvoie une erreur.
- -statusport <numéro_port>
- Paramètre facultatif autorisant un administrateur à définir le numéro de port pour le rappel de l'état du gestionnaire de déploiement. Cet outil ouvre le port et attend le rappel d'état émis par le gestionnaire de déploiement, un peu avant l'arrêt complet 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 (Java Management Extensions) à utiliser pour la connexion avec le gestionnaire de déploiement. Les types corrects sont SOAP ou Remote Method Invocation (RMI).
- -port <portNumber>
- Indique le port JMX du gestionnaire de déploiement à 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 dans le gestionnaire de déploiement. Fonctionne comme l'option -user.
- -user <name>
- Indique le nom d'utilisateur pour l'authentification si la sécurité est activée dans le gestionnaire de déploiement. Fonctionne comme l'option -username.
- -password <mot de passe>
- Indique le mot de passe pour l'authentification si la sécurité est activée dans le gestionnaire de déploiement.Remarque : 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.ADMN0022E : 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 :
stopManager
stopManager -nowait
stopManager -trace (génère le fichier stopmanager.log)