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.

Eviter les incidents Eviter les incidents: Les noeuds enregistrés doivent disposer des mêmes produits que l'agent d'administration et le niveau de version des produits doit être identique sur ces noeuds et sur l'agent d'administration. Cette exigence est appliquée car l'environnement correspondant doit être installé sur l'agent d'administration afin que toutes les fonctions d'administration du noeud enregistré puissent être traitées. Un noeud n'est pas autorisé à s'enregistrer auprès d'un agent d'administration s'il ne dispose pas d'un ensemble identique de produits et de versions. gotcha

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.

transition : Si vous exécutiez précédemment la version 7.0.0.11 ou une version antérieure et que vous disposez d'un agent d'administration doté d'un noeud géré dont les produits ou les versions ne correspondent pas, lors de la migration vers la version 8.0, cet agent d'administration ne pourra pas démarrer le sous-système pour les noeuds qui ne correspondent pas. Vous devez mettre ces noeuds à jour pour avoir les mêmes produits et versions que les agents d'administration, redémarrer les serveurs sur le noeud et, enfin, redémarrer l'agent d'administration avant que celui-ci puisse reprendre la gestion de ces noeuds enregistrés.

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 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]
registerNode.sh -conntype SOAP -port 8878 
 -profilePath racine_serveur_app/profiles/default
[AIX][HP-UX][Linux][Solaris]
registerNode.sh -conntype SOAP -port 8878 
 -profilePath racine_serveur_app/profiles/AppSrv01
[Windows]
registerNode.bat -conntype SOAP -port 8878 
 -profilePath racine_serveur_app\profiles\AppSrv01
[IBM i]
registerNode -conntype SOAP -port 8878 
 -profilePath racine_données_utilisateur/profiles/AppSrv01

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=ragt_registerNode
Nom du fichier : ragt_registerNode.html