Récupération ou déplacement de noeuds à l'aide de la commande addNode -asExistingNode
Vous pouvez utiliser l'option -asExistingNode de la commande addNode pour récupérer ou déplacer des noeuds d'un gestionnaire de déploiement. Grâce à l'option -asExistingNode, vous pouvez fédérer un nouveau noeud personnalisé en tant que noeud existant auprès d'un gestionnaire de déploiement. Durant la fédération, le produit utilise les informations de la configuration principale du gestionnaire de déploiement pour transformer le noeud personnalisé en noeud existant.
Avant de commencer
Dans cette rubrique, on suppose qu'un produit WebSphere Application Server, Network Deployment a un gestionnaire de déploiement avec un ou plusieurs noeuds gérés.
Pourquoi et quand exécuter cette tâche
Utilisez l'option -asExistingNode de la commande addNode pour récupérer rapidement un noeud endommagé, pour déplacer un noeud vers une installation du produit se trouvant sur un autre ordinateur, mais dans le même chemin, pour déplacer un noeud vers une installation du produit se trouvant sur un autre système d'exploitation ou dans un autre chemin, ou encore pour créer des cellules à partir d'une cellule modèle.
Les procédures suivantes décrivent comment utiliser l'option -asExistingNode :
- Récupérer un noeud géré existant d'un gestionnaire de déploiement.
- Déplacer un noeud vers une installation du produit sur un autre ordinateur, mais dans le même chemin.
- Déplacer un noeud vers une installation du produit sur un autre système d'exploitation ou dans un autre chemin.
- Créer une cellule à partir d'une cellule modèle.

- -includeapps
- -includebuses
- -startingport
- -portprops
- -nodeagentshortname
- -nodegroupname
- -registerservice
- -serviceusername
- -servicepassword
- -coregroupname
- -excludesecuritydomains
Lorsque la commande addNode est exécutée avec l'option -asExistingNode, le produit ne recherche pas ni ne résout les conflits entre ports. Vous devez vérifier que les ports associés à un noeud ne sont pas en conflit avec les ports déjà utilisés sur l'hôte cible.
Procédure
- Récupérer un noeud géré existant
d'un gestionnaire de déploiement.
Vous pouvez utiliser l'option -asExistingNode de la commande addNode pour récupérer un noeud existant endommagé. Par exemple, si l'arrêt anormal d'un ordinateur provoque l'indisponibilité d'un noeud, mais que les informations de configuration de ce noeud sont encore présentes sur le gestionnaire de déploiement, vous pouvez utiliser l'option -asExistingNode pour recréer le noeud perdu.
- Assurez-vous que le noeud endommagé n'est pas en cours d'exécution. Arrêtez l'agent de noeud et les serveurs d'applications résidant sur ce noeud.
- Supprimez le profil d'origine et
créez-en un autre, destiné à remplacer celui du noeud endommagé. Veillez à lui donner le même chemin de profil
et les mêmes noms de profil et de noeud que ceux du noeud perdu. Vous pouvez aussi créer le profil
sur un ordinateur autre que celui du noeud d'origine, si le système d'origine est hors service et
que vous avez configuré un nouvel ordinateur avec le même nom d'hôte.
Par exemple, le noeud myNode01 qui porte le nom de profil AppSrv01 s'arrête de fonctionner. Pour le remplacer par un nouveau noeud, créez un profil de serveur d'applications nommé AppSrv01 pour le noeud myNode01.
- Exécutez la commande addNode avec l'option -asExistingNode à partir d'une ligne de commande,
dans le répertoire
bin du profil de serveur d'applications endommagé.
Le nom du nouveau noeud doit correspondre au nom du noeud sur lequel vous exécutez addNode avec l'option -asExistingNode.
- Ouvrez une invite de commande et passez dans le répertoire bin du profil du serveur d'applications. Par exemple, dans le cas du profil de serveur d'applications AppSrv01, passez dans le répertoire racine_profil/AppSrv01/bin.
- Exécutez la commande addNode avec l'option -asExistingNode
pour remplacer le noeud de serveur d'applications par le nouveau noeud. Dans l'exemple de commande
suivant, on suppose que la sécurité est activée et que le produit exige la saisie
d'un nom d'utilisateur et d'un mot de passe. Pour hôte_gest_dép et port_gest_dép,
spécifiez le nom d'hôte et le numéro de port du gestionnaire de déploiement.
addNode dmgr_host dmgr_port -asExistingNode -username nom_utilisateur -password motdepasse
Restriction : Les adaptateurs JCA installés précédemment ne sont pas stockés dans le cadre de la configuration WebSphere. Après avoir remplacé un noeud, réinstallez les adaptateurs JCA pour qu'ils puissent être utilisés dans le nouvel environnement. - Synchronisez tous les autres noeuds actifs dans la cellule.
- Pour synchroniser les noeuds actifs, le moyen le plus simple et le plus efficace est d'autoriser l'exécution de la synchronisation automatique. Par défaut, la synchronisation automatique est activée et les noeuds se synchronisent périodiquement, selon leur intervalle configuré.
- Si la synchronisation automatique n'est pas activée, vous pouvez
synchroniser les noeuds explicitement.
- Cliquez sur Administration du système > Noeuds.
- Sur la page Noeuds, sélectionnez les noeuds non synchronisés et cliquez sur Synchroniser.
Si vous avez plus de cinq noeuds à synchroniser, n'en synchronisez pas plus de cinq à la fois.
Pour récupérer un noeud géré à l'aide de la console d'administration du gestionnaire de déploiement, consultez la rubrique Ajout, gestion et suppression de noeuds.
- Déplacer un noeud vers une installation du produit sur
un autre ordinateur, mais dans le même chemin.
Vous pouvez utiliser l'option -asExistingNode pour déplacer un noeud vers un autre ordinateur, à condition que les valeurs suivantes soient les mêmes sur l'autre ordinateur :
- Répertoire d'installation de WebSphere Application Server
- Nom de profil
- Répertoire du profil
- Nom du noeud
Cette procédure met en jeu trois profils différents :
- Le profil du gestionnaire de déploiement est le profil destiné au gestionnaire de déploiement. Exécutez la commande changeHostName à partir de ce profil.
- Le profil source est le profil d'origine, c'est-à-dire celui à partir duquel vous souhaitez déplacer le noeud.
- Le profil de destination est le profil vers lequel vous souhaitez déplacer le noeud sur l'autre ordinateur.
- Assurez-vous que le noeud à déplacer (le profil source) n'est pas en cours d'exécution. Arrêtez l'agent de noeud et les serveurs d'applications résidant sur ce noeud.
- Changez le nom d'hôte du noeud dans la configuration principale présente sur le
gestionnaire de déploiement.
Effectuez les étapes suivantes, qui mettent en jeu le profil du gestionnaire de déploiement :
- Ouvrez une invite de commande et passez dans le répertoire bin du profil du gestionnaire de déploiement. Par exemple, si le profil du gestionnaire de déploiement se nomme Dmgr01, accédez au répertoire racine_profil/Dmgr01/bin.
- Exécutez les commandes
Jython de wsadmin qui changent le nom d'hôte du noeud. Dans les exemples de commandes
suivants, on suppose que la sécurité est activée et que le produit exige la saisie
d'un nom d'utilisateur et d'un mot de passe. Pour nouveau_nom_hôte, spécifiez le nom d'hôte de
l'ordinateur cible.
wsadmin -lang jython -userName nom_utilisateur -password motdepasse AdminTask.changeHostName('[-hostName nouveau_nom_hôte -nodeName nom_noeud]') AdminConfig.save() quit
- Déplacez le noeud de l'installation de produit sur l'ordinateur source vers
l'installation de produit sur l'ordinateur cible.
Effectuez les étapes suivantes, qui mettent en jeu le profil de destination, sur l'ordinateur cible :
- Installez WebSphere Application Server dans un répertoire ayant le même nom que le répertoire d'installation du produit sur l'ordinateur source.
- Créez un profil personnalisé, ayant le même nom de profil, le même répertoire de profil et le même nom de noeud que le profil du noeud que vous voulez déplacez. Lors de la création du profil personnalisé, choisissez de fédérer le noeud plus tard. Vous ne devez pas fédérer le noeud pendant la création du profil.
- Ouvrez une invite de commande et passez dans le répertoire bin du profil du serveur d'applications. Par exemple, si le profil du serveur d'applications se nomme AppSrv01, accédez au répertoire racine_profil/AppSrv01/bin.
- Exécutez la commande addNode avec l'option -asExistingNode
pour remplacer le noeud de serveur d'applications par le noeud que vous voulez
déplacer. Dans l'exemple de commande
suivant, on suppose que la sécurité est activée et que le produit exige la saisie
d'un nom d'utilisateur et d'un mot de passe. Pour dmgr_host et dmgr_port,
spécifiez le nom d'hôte et le numéro de port du gestionnaire de déploiement cible.
addNode dmgr_host dmgr_port -asExistingNode -username nom_utilisateur -password motdepasse
Restriction : Les adaptateurs JCA installés précédemment ne sont pas stockés dans le cadre de la configuration WebSphere. Après avoir déplacé un noeud, réinstallez les adaptateurs JCA pour qu'ils puissent être utilisés dans le nouvel environnement. - Utilisez la console d'administration du gestionnaire de déploiement cible ou wsadmin pour effectuer les étapes suivantes afin de permettre
aux serveurs sur le noeud de fonctionner correctement.
- Démarrez le noeud. Cette étape met en jeu le profil de destination.
- Mettez à jour les hôtes virtuels (alias d'hôte) pour inclure le nom d'hôte cible du noeud de serveur d'applications.
- Démarrez les serveurs d'applications sur le noeud.
- Si le noeud utilise un certificat SSL, remplacez le certificat par défaut
par un certificat contenant le nom d'hôte du noeud.
Consultez la rubrique consacrée à la création de certificats SSL pour remplacer les certificats existants dans un noeud.
- Synchronisez tous les autres noeuds actifs dans la cellule.
Il est possible que vous deviez mettre à jour la configuration des autres composants de l'infrastructure (par exemple, les serveurs Web) qui sont configurés de manière statique pour utiliser des serveurs d'applications résidant sur des hôtes spécifiques.
- Déplacer un noeud vers une installation du produit sur
un autre système d'exploitation ou dans un autre chemin.
Vous pouvez utiliser l'option -asExistingNode pour déplacer un noeud vers une installation de produit sur un autre ordinateur fonctionnant avec le même système d'exploitation, mais utilisant un nom d'hôte et un chemin différents. Vous pouvez aussi utiliser cette option pour déplacer un noeud vers une installation de produit sur un autre ordinateur fonctionnant avec un système d'exploitation différent, mais avec des fichiers de configuration compatibles ; par exemple, d'un système AIX vers un système Windows.
Restriction :- Les applications utilisant le Planificateur (Scheduler) ne fonctionnent qu'avec le même nom d'hôte. En effet, le nom d'hôte est incorporé dans chaque tâche planifiée, si bien que les tâches qui existaient avant le déplacement du noeud ne peuvent plus fonctionner ; en revanche, les tâches créées après le déplacement fonctionneront correctement. Après avoir déplacé un noeud, replanifiez toutes les tâches dont la création est antérieure au déplacement du noeud.
- Vous ne pouvez pas déplacer des noeuds entre une installation de produit sur z/OS et une installation sur un système d'exploitation autre que z/OS.
- Les adaptateurs JCA installés précédemment ne sont pas stockés dans le cadre de la configuration WebSphere. Après avoir déplacé un noeud, réinstallez les adaptateurs JCA pour qu'ils puissent être utilisés dans le nouvel environnement.
Dans la procédure qui suit, on suppose que le répertoire d'installation de WebSphere Application Server et le répertoire du profil sur l'ordinateur contenant le noeud à déplacer (l'ordinateur source) sont différents des répertoires sur l'ordinateur cible. En revanche, le nom de profil du noeud et le nom du noeud doivent être les mêmes sur l'ordinateur source et l'ordinateur cible.
Pour effectuer cette tâche, suivez les étapes de la procédure Déplacer un noeud vers une installation du produit sur un autre ordinateur, mais dans le même chemin. Toutefois, avant de déplacer le noeud sur l'ordinateur cible, ouvrez la configuration du gestionnaire de déploiement et changez les chemins d'installation et de profil de chaque noeud dans les mappes de variables. Par exemple :
- Dans la console d'administration, cliquez sur Environnement > Variables WebSphere.
- Sur la page Variables WebSphere, sélectionnez la portée de niveau noeud et cliquez sur ensuite sur la variable WAS_INSTALL_ROOT.
- Sur la page de définition de la variable WAS_INSTALL_ROOT, changez la Valeur afin de spécifier le nouveau chemin d'installation du produit, puis enregistrez le changement.
- Sur la page Variables WebSphere, la portée de niveau noeud étant sélectionnée, cliquez sur la variable USER_INSTALL_ROOT.
- Sur la page de définition de la variable USER_INSTALL_ROOT, changez la Valeur afin de spécifier le nouveau chemin d'installation du profil, puis enregistrez le changement.
- Répétez ces étapes selon nécessité pour adapter les chemins d'installation du produit et du profil de chaque noeud en fonction de l'ordinateur cible.
Dans cette tâche, il n'est pas nécessaire que les répertoires d'installation du produit et du profil sur l'ordinateur cible soient identiques à ceux de l'ordinateur source.
- Créer une cellule à partir
d'une cellule modèle.
Vous pouvez utiliser l'option -asExistingNode de la commande addNode pour créer rapidement une cellule à partir d'une cellule existante. La nouvelle cellule doit avoir le même nom que la cellule modèle.
Restriction :- L'application du planificateur (Scheduler) ne fonctionne pas avec plusieurs environnements. En effet, le nom d'hôte est incorporé dans chaque tâche planifiée, si bien que les tâches qui existaient avant le déplacement du noeud ne peuvent plus fonctionner ; en revanche, les tâches créées après le déplacement fonctionneront correctement. Après avoir déplacé un noeud, replanifiez toutes les tâches dont la création est antérieure au déplacement du noeud.
- Vous devez évaluer si différentes ressources (par exemple, les sources de données) sont nécessaires pour chaque environnement.
- Les adaptateurs JCA installés précédemment ne sont pas stockés dans le cadre de la configuration WebSphere. Après avoir déplacé un noeud, réinstallez les adaptateurs JCA pour qu'ils puissent être utilisés dans le nouvel environnement.
Si la sécurité est activée, il est probable que vous devrez regénérer des clés et des jetons pour la nouvelle cellule.
- Créez et configurez la cellule que vous souhaitez utiliser comme modèle pour les nouvelles installations de produit.
- Faites une copie de la configuration du profil du gestionnaire de déploiement à l'aide de la commande backupConfig. Vous l'utiliserez pour restaurer la configuration du gestionnaire de déploiement dans la nouvelle installation.
- Copiez la cellule modèle vers une nouvelle installation de produit.
Pour chaque nouvel environnement à provisionner, effectuez les étapes suivantes :
- Installez WebSphere Application Server.
- Créez les profils de noeud de gestionnaire de déploiement et de noeud de serveur d'applications. Les profils de serveur d'applications doivent posséder le même nom de noeud que la cellule modèle.
- Restaurez la configuration du profil de gestionnaire de déploiement à l'aide de la commande restoreConfig. Mettez à jour le nom d'hôte du gestionnaire de déploiement en utilisant wsadmin en mode local. Si le chemin du profil ou le chemin de l'installation de produit ont changé, modifiez en conséquence le fichier variables.xml du noeud de gestionnaire de déploiement. Mettez à jour les autres fichiers de propriétés selon nécessité. Il peut s'agir, par exemple, des fichiers wsadmin.properties et soap.client.props.
- Personnalisez chaque configuration de noeud dans le profil du gestionnaire de déploiement. Par exemple, changez les valeurs suivantes :
- Nom d'hôte
- Ports
- Répertoire d'installation du produit
- Répertoires des profils
- Configuration de la sécurité
- Exécutez addNode
–asExistingNode pour chaque noeud. Vous pouvez exécuter cette commande simultanément à partir de chaque noeud.
- Ouvrez une invite de commande et passez dans le répertoire bin du profil du serveur d'applications. Par exemple, si le profil du serveur d'applications se nomme AppSrv01, accédez au répertoire racine_profil/AppSrv01/bin.
- Exécutez la commande addNode avec l'option -asExistingNode pour remplacer le
noeud de serveur d'applications par le noeud dans la cellule cible. Dans l'exemple de commande
suivant, on suppose que la sécurité est activée et que le produit exige la saisie
d'un nom d'utilisateur et d'un mot de passe. Pour dmgr_host et dmgr_port,
spécifiez le nom d'hôte et le numéro de port du gestionnaire de déploiement cible.
addNode dmgr_host dmgr_port -asExistingNode -username nom_utilisateur -password motdepasse
- Utilisez la console d'administration du nouveau gestionnaire de déploiement ou wsadmin pour effectuer les étapes suivantes afin de permettre
aux serveurs sur chaque noeud de fonctionner correctement.
- Démarrez le noeud. Exécutez la commande startNode à partir du profil du noeud.
- Mettez à jour les hôtes virtuels (alias d'hôte) pour inclure le nom d'hôte du noeud de serveur d'applications.
- Démarrez les serveurs d'applications sur le noeud.
- Si la cellule utilise un certificat SSL, remplacez le certificat racine autosigné
dans le fichier de clés racine, DmgrDefaultRootStore.
Consultez la rubrique consacrée à la création de certificats SSL pour remplacer les certificats existants dans une cellule.
- Synchronisez tous les autres noeuds actifs dans la cellule.
Que faire ensuite
Examinez les noeuds dans l'installation cible pour vérifier que leur configuration fonctionne correctement. Si nécessaire, supprimez les profils de l'installation source.


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tagt_addNode_asExistingNode
Nom du fichier : tagt_addNode_asExistingNode.html