Commande stopNode
La commande stopNode lit le fichier de configuration pour le processus de l'agent de noeud et envoie une commande JMX (Java™ Management Extensions) indiquant à l'agent de s'arrêter.
Par défaut, la commande stopNode attend que l'agent soit arrêté avant de retourner le contrôle à la ligne de commande. L'option -nowait permet un renvoie immédiat, d'autres de contrôler le comportement de la commande stopNode. Pour plus d'informations sur l'emplacement depuis lequel exécuter cette commande, voir Utilisation des outils de ligne de commande.
Si vous utilisez un système d'exploitation Windows et que l'agent du noeud est exécuté comme service Windows, la commande stopNode utilise
le service Windows associé pour arrêter l'agent du noeud.
Si vous arrêtez le serveur avant d'arrêter l'agent de noeud à l'aide de la commande stopServer -servers, le serveur ne redémarre pas si vous exécutez une commande startServer.
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
stopNode [options]
Paramètres
Les options ci-après sont disponibles pour la commande stopNode.
- -nowait
- Indique à la commande stopNode de ne pas attendre l'arrêt effectif du processus agent de noeud.
- -quiet
- Supprime les informations de progression imprimées par la commande stopNode 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 du profil du noeud arrêté.
-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 la trace est enregistré dans le fichier was_nom_tâche-utilisateur_tâche-numéro_tâche.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 de l'agent n'arrive à expiration et ne renvoie une erreur.
Configurations prises en charge: Le paramètre timeout permet d'arrêter un serveur à la fois. Si vous utilisez le paramètre timeout avec le paramètre stopservers, la valeur du paramètre timeout est ignorée.sptcfg
- -statusport <numéro_port>
- Paramètre facultatif autorisant un administrateur à définir le numéro de port pour le rappel de l'état de l'agent de noeud. Cet outil ouvre le port et attend le rappel d'état émis par l'agent de noeud, 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é.
- -stopservers [-saveNodeState]
- Arrête tous les serveurs d'applications du noeud avant d'arrêter l'agent de noeud.
Utilisez l'option -saveNodeState pour enregistrer l'état de redémarrage du serveur afin de pouvoir démarrer les serveurs d'applications en fonction de l'état précédent, à l'aide de la commande startNode.
- -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 de l'agent de noeud à 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 l'agent de noeud. Fonctionne comme l'option -user.
- -user <name>
- Indique le nom d'utilisateur pour l'authentification si la sécurité est activée dans l'agent de noeud. 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 l'agent de noeud.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.Remarque : Lorsque vous demandez de l'aide sur la commande stopNode, une référence à la commande stopServer s'affiche. Toutes les options affichées pour cette instruction de syntaxe s'appliquent à la commande stopNode.
- -?
- Imprime une syntaxe.Remarque : Lorsque vous demandez de l'aide sur la commande stopNode, une référence à la commande stopServer s'affiche. Toutes les options affichées pour cette instruction de syntaxe s'appliquent à la commande stopNode.
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)
stopNode
stopNode -nowait
stopNode -trace (génère le fichier stopnode.log)
![[IBM i]](../images/iseries.gif)
stopNode
stopNode -profileName mynode
stopNode -nowait
stopNode -trace (génère des fichiers de trace dans
le répertoire racine_profil/logs.)