Commande registerNode
La commande registerNode permet d'enregistrer un noeud autonome auprès d'un agent d'administration afin que ce dernier puisse gérer le noeud.
Exécutez la commande registerNode dans le répertoire bin du serveur de l'agent d'administration, afin d'enregistrer un noeud auprès de l'agent d'administration. Lorsque vous exécutez la commande,le noeud autonome est converti en noeud géré par l'agent d'administration.
L'agent d'administration et le noeud enregistrés doivent se trouver sur le même ordinateur.
L'agent d'administration fournit une interface unique permettant d'administrer plusieurs noeuds de serveur d'applications (autonome) non fédérés, par exemple des environnements de développement, de test d'unités ou de parcs de serveurs. En utilisant une seule interface pour gérer vos serveurs d'applications, vous réduisez le temps système nécessaire à l'exécution des services d'administration dans chaque serveur d'applications.
Vous pouvez utiliser la console d'administration de l'agent d'administration pour configurer ce dernier, afficher et modifier les propriétés des noeuds enregistrés auprès de lui, enregistrer et désenregistrer des noeuds de serveur d'applications auprès de gestionnaires de travaux, ainsi qu'afficher et modifier les configurations de gestionnaire de travaux pour un noeud enregistré. Un gestionnaire de travaux vous permet de soumettre et d'administrer des travaux de manière asynchrone pour un noeud enregistré auprès de l'agent d'administration lorsque le noeud est également enregistré auprès du gestionnaire de travaux. Pour plus d'informations sur le sous-système d'agent d'administration, reportez-vous à la section relative à l'agent d'administration dans l'article developerWorks Overview of administrative enhancements.

Vous pouvez exécuter la commande uniquement sur un noeud non fédéré. Si la commande est exécutée sur un noeud fédéré, elle s'arrêtera avec une erreur.
Quand vous exécutez la commande registerNode, elle arrête tous les serveurs d'applications en cours d'exécution sur le noeud. Le cas échéant, vous pouvez arrêter les serveurs d'applications du noeud que vous voulez enregistrer avant d'exécuter la commande registerNode.
Si la console d'administration ou les applications EJB (JavaBeans) du serveur d'applications enregistré sont activées, le processus d'enregistrement de noeud les désactive.
Syntaxe
La syntaxe de la commande registerNode est la suivante :
registerNode [options]
Paramètres
Les options ci-après sont disponibles pour la commande registerNode.
- -conntype<JSR160RMI|IPC|RMI|SOAP>
- Type de connecteur facultatif permettant d'établir une connexion à l'agent d'administration
afin de lancer l'opération d'enregistrement du noeud. La valeur par défaut est SOAP.
Fonction obsolète: Il est possible que vous deviez utiliser le connecteur JSR160RMI à la place du connecteur RMI car l'utilisation de ce dernier est déconseillée.depfeat
- -host nom_hôte
- Paramètre facultatif qui indique le nom d'hôte de l'agent d'administration.
- -name managed_node_name
- Paramètre facultatif qui indique le nom du noeud géré après son enregistrement avec l'agent d'administration.
- -nodepassword node_password
- Paramètre facultatif indiquant le mot de passe du noeud que vous enregistrez. Indiquez ce paramètre si la sécurité est activée au niveau du noeud et si le mot de passe est différent du mot de passe de l'agent d'administration. Utilisez ce paramètre en association avec le paramètre -nodeusername. Les paramètres -nodeusername et -nodepassword sont utilisés pour arrêter tous les serveurs du noeud.
- -nodeusername node_user_name
- Paramètre facultatif indiquant le nom d'utilisateur du noeud que vous enregistrez. Indiquez ce paramètre si la sécurité est activée au niveau du noeud et si le nom d'utilisateur est différent du nom d'utilisateur de l'agent d'administration. Utilisez ce paramètre en association avec le paramètre -nodepassword. Les paramètres -nodeusername et -nodepassword sont utilisés pour arrêter tous les serveurs du noeud.
- -openConnectors connectors
- Paramètre facultatif qui indique une liste de connecteurs séparés par des virgules que l'agent d'administration ouvre. Par défaut, tous les connecteurs sont ouverts.
- -port numéro_port
- Paramètre facultatif qui indique le numéro de port de l'agent d'administration.
Le numéro de port par défaut est 8878 pour le port SOAP par défaut de l'agent d'administration. SOAP est le type de connecteur JMX (Java™ Management Extensions) par défaut pour la commande. Si vous disposez de plusieurs installations de produit ou de plusieurs profils, le port SOAP peut être différent de 8878. Consultez le fichier SystemOut.log de l'agent d'administration pour voir les ports actuellement utilisés.
Remarque : Cette rubrique fait référence à un ou plusieurs des fichiers journaux de serveur d'applications. Il est recommandé de configurer le serveur de telle sorte qu'il utilise l'infrastructure de journalisation et de trace HPEL (High Performance Extensible Logging) à la place des fichiers SystemOut.log, SystemErr.log, trace.log et activity.log sur les systèmes distribués et IBM® i. Vous pouvez également utiliser HPEL conjointement avec vos fonctions de journalisation z/OS natives. Si vous utilisez l'infrastructure HPEL, vous pouvez accéder à toutes les informations de journalisation et de trace en utilisant l'outil de ligne de commande LogViewer à partir de votre répertoire bin de profil de serveur. Pour plus d'informations sur l'utilisation de HPEL, voir les informations sur l'utilisation de HPEL en vue du traitement des incidents liés aux applications. - -profilePath chemin_profil
- Paramètre requis qui indique le chemin du profil du noeud du serveur d'applications à enregistrer.
- -trace
- Paramètre facultatif qui fournit une sortie de traçage pour la commande registerNode.
- -portsFile fichier_ports
- Paramètre facultatif qui spécifie le chemin d'accès à un fichier qui définit les paramètres de port pour le noeud récemment enregistré.
Lors de l'enregistrement de noeud, la commande registerNode utilise un ensemble généré automatiquement des ports recommandés si vous n'indiquez pas le paramètre -portsFile. Les valeurs de port recommandées peuvent être différentes des valeurs de port par défaut selon la disponibilité des ports par défaut.
Le format du fichier ports_file que vous indiquez est le même que celui du fichier portdef.props, sauf que seuls les ports suivants sont utilisés : SOAP_CONNECTOR_ADDRESS, RMI_CONNECTOR_ADDRESS, JSR160RMI_CONNECTOR_ADDRESS et IPC_CONNECTOR_ADDRESS.
- -profileName nom_profil
- Paramètre facultatif qui indique le nom de profil de l'agent d'administration.
- -username nomutilisateur
- Paramètre facultatif qui indique l'ID utilisateur permettant de se connecter à l'agent d'administration.
- -password motdepasse
- Paramètre facultatif qui indique le mot de passe permettant de se connecter à l'agent d'administration.
- -help
- Paramètre facultatif qui imprime une syntaxe.
- -?
- Paramètre facultatif qui imprime une syntaxe.
Scénarios d'utilisation
Les exemples qui suivent donnent la syntaxe appropriée. Les commandes sont réparties sur plusieurs lignes pour des raisons d'affichage.
![[z/OS]](../images/ngzos.gif)
registerNode.sh -conntype SOAP -port 8878
-profilePath racine_serveur_app/profiles/default
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
registerNode.sh -conntype SOAP -port 8878
-profilePath racine_serveur_app/profiles/AppSrv01
![[Windows]](../images/windows.gif)
registerNode.bat -conntype SOAP -port 8878
-profilePath racine_serveur_app\profiles\AppSrv01
![[IBM i]](../images/iseries.gif)
registerNode -conntype SOAP -port 8878
-profilePath racine_données_utilisateur/profiles/AppSrv01