Annulation de l'enregistrement de noeuds de l'agent d'administration

Vous pouvez annuler l'enregistrement de noeuds de serveurs d'application afin qu'ils ne soient plus enregistrés sur un agent d'administration. Désenregistrez les noeuds si vous n'en avez plus besoin dans l'environnement d'agent d'administration ou que vous voulez supprimer le profil de noeud de serveur d'applications. Après avoir annulé l'enregistrement d'un noeud sur un agent d'administration, vous pouvez utiliser le noeud en mode autonome, enregistrer le noeud auprès d'un autre agent d'administration ou supprimer le profil de noeud de serveur d'applications.

Avant de commencer

Le noeud de serveur d'application que vous souhaitez supprimer de l'environnement d'agent d'administration doit être enregistré auprès de l'agent d'administration. Démarrez l'agent d'administration s'il n'est pas déjà en cours d'exécution.

Si le noeud du serveur d'applications est enregistré sur un gestionnaire de travaux, annulez l'enregistrement du noeud sur le gestionnaire de travaux. Vous pouvez utiliser la console d'agent d'administration ou les commandes wsadmin pour annuler l'enregistrement du noeud :
  • Utilisez la console d'agent d'administration pour annuler l'enregistrement du noeud de serveur d'applications autonome sur un gestionnaire de travaux.
    1. Connectez-vous à la console de l'agent d'administration. Le nom de l'agent d'administration est similaire à nom_hôteAANode01.
    2. Cliquez sur Administration système > Agent d'administration.
    3. Sur l'onglet Configuration de la page Agent d'administration, cliquez sur Noeuds.
    4. Sur la page Noeuds, sélectionnez le noeud à désenregistrer sur le gestionnaire de travaux et cliquez sur Annuler l'enregistrement sur un gestionnaire de travaux.
    5. Dans la page Annuler l'enregistrement sur un gestionnaire de travaux, indiquez un nom de noeud, un numéro de port de console d'administration de gestionnaire de travaux, d'autres paramètres facultatifs tels que le nom d'utilisateur et le mot de passe du gestionnaire de travaux, puis cliquez sur OK.

      Pour le Port, si la sécurité n'est pas activée, indiquez 9960 pour un port de console d'administration de gestionnaire de travaux non sécurisé. Si aucun numéro de port n'est spécifié, le numéro de port sécurisé par défaut 9943 est utilisé.

  • Exécutez la commande wsadmin unregisterWithJobManager du groupe de commandes ManagedNodeAgent pour désenregistrer le noeud de serveur d'applications autonome sur un gestionnaire de travaux.

    Lorsque vous exécutez la commande unregisterWithJobManager, indiquez le nom du noeud du serveur d'applications autonome géré par le gestionnaire de travaux pour le paramètre -managedNodeName requis. Les autres paramètres sont facultatifs.

    AdminTask.unregisterWithJobManager('[-host myJobMgrHostname -port 8989
     -managedNodeName myAppServerNodeName]') 

    La valeur par défaut du paramètre -host est hôte_local.

    La valeur par défaut du paramètre -port est 9943, numéro de port sécurisé de la console d'administration du gestionnaire de travaux. Si la sécurité est désactivée, indiquez 9960, le numéro de port non sécurisé par défaut.

    Pour plus d'informations sur la commande unregisterWithJobManager et ses paramètres, consultez la rubrique relative au groupe de commandes ManagedNodeAgent pour l'objet AdminTask.

    Si le système ne parvient pas à désenregistrer un serveur d'applications autonome dans un gestionnaire de travaux, exécutez la commande cleanupTarget dans le groupe JobManagerNode pour nettoyer les informations d'enregistrement dans le gestionnaire de travaux. Voir la rubrique relative au groupe de commandes JobManagerNode de l'objet AdminTask.

Pourquoi et quand exécuter cette tâche

Pour désenregistrer un noeud, exécutez la commande deregisterNode dans le répertoire bin de l'agent d'administration. L'étape 1 décrit comment exécuter la commande deregisterNode.

Lorsque vous annulez l'enregistrement d'un noeud, la configuration de noeud est conservée mais est marquée comme non enregistrée avec l'agent d'administration. Si le noeud dont vous annulez l'enregistrement incluait les applications EJB (Enterprise JavaBeans) de gestion ou la console d'administration avant l'enregistrement du noeud, elles sont à nouveau activées.

L'exécution de la commande deregisterNode peut produire une exception de pointeur NULL si le profil du noeud du serveur d'applications est endommagé ou inutilisable. Si vous recevez ce type d'exception, cela signifie que le désenregistrement du serveur d'applications dans l'agent d'administration a échoué. Les messages ADMU0116I, ADMU0128I, ADMU0211I, ADMU0113E et ADMU1211I sont consignés dans le journal des erreurs. L'étape 2 décrit comment supprimer un noeud et les points d'extrémité associés en cas d'exception de pointeur NULL.

Si le profil du noeud de serveur d'applications est supprimé avant l'annulation de l'enregistrement du noeud, l'exécution de la commande deregisterNode n'a aucun effet. Etant donné que le profil n'existe plus, l'agent d'administration ne le reconnaît plus. Effectuez l'étape 2 pour supprimer le noeud et les points d'extrémité associés de l'environnement de l'agent d'administration.

Procédure

  1. Désenregistrez un noeud à l'aide de la commande deregisterNode.

    Si le noeud que vous souhaitez désenregistrer existe, exécutez la commande deregisterNode, en indiquant le chemin d'accès du profil du noeud à désenregistrer.

    deregisterNode -profilePath racine_profil/profile_name

    Par exemple, pour désenregistrer le profil AppSrv02 de l'environnement de l'agent d'administration, exécutez la commande suivante :

    deregisterNode -profilePath racine_profil/AppSrv02

    Voir la rubrique relative à la commande deregisterNode pour plus d'informations sur les paramètres de la commande.

  2. Si une exception de pointeur NULL est produite par la commande deregisterNode ou si le profil de noeud a été supprimé, exécutez les commandes wsadmin qui suppriment le noeud enregistré et les points d'extrémité associés.
    1. Sur une ligne de commande, exécutez une commande pour démarrer l'outil de création de script wsadmin à partir du répertoire bin de l'agent d'administration.
      Pour utiliser le langage de script Jython, entrez :
      wsadmin -lang jython
      Pour utiliser le langage de script Jacl, entrez :
      wsadmin
    2. Si vous ignorez le nom du noeud à supprimer, exécutez la commande list AdminConfig pour afficher les noeuds qui sont enregistrés sur l'agent d'administration et identifiez le noeud à supprimer dans la liste.
      Pour Jython :
      print AdminConfig.list('ManagedNode')
      Pour Jacl :
      $AdminConfig list ManagedNode

      La liste des noeuds enregistrés qui apparaît se présente comme suit :

      nodeA(cells/myAACell01/managednodes/nodeA|managednode.xml#ManagedNode_1239121412703)
      nodeB(cells/myAACell01/managednodes/nodeB|managednode.xml#ManagedNode_1239121498500)

      Cette liste montre que nodeA et nodeB sont des noeuds enregistrés de l'agent d'administration myAACell01.

    3. Exécutez les commandes wsadmin qui suppriment le noeud.

      Pour supprimer nodeA et enregistrer les modifications, exécutez les commandes suivantes.

      Pour Jython :
      mn = AdminConfig.getid('/ManagedNode:nodeA/')
      
      AdminConfig.remove(mn)
      
      AdminConfig.save()
      Pour Jacl :
      set mn [$AdminConfig getid /ManagedNode:nodeA/]
      
      $AdminConfig remove $mn
      
      $AdminConfig save
    4. Exécutez les commandes wsadmin qui suppriment les points d'extrémité qui ont été générés pour le sous-système lorsque le profil de noeud a été enregistré.

      Exécutez les commandes suivantes successivement pour supprimer les points d'extrémité pour nodeA. La commande for pour Jython et la commande foreach pour Jacl sont des commandes en ligne qui sont affichées sur plusieurs lignes à des fins de lisibilité.

      Pour Jython :
      import java.lang.System as System
      
      lineSeparator = System.getProperty("line.separator")
      
      neps = AdminConfig.list("NamedEndPoint").split(lineSeparator)
      
      for nep in neps:
        set name = AdminConfig.showAttribute(nep, "endPointName")
        if (name.endswith("nodeA") == 1):
           AdminConfig.remove(nep)
      
      AdminConfig.save()
      
      quit
      Pour Jacl :
      set neps [$AdminConfig list NamedEndPoint]
      
      foreach nep $neps {set name [$AdminConfig showAttribute $nep endPointName]; 
      if {[string last "nodeA" $name] != -1} {$AdminConfig remove $nep}}
      
      $AdminConfig save
      
      quit
    5. Redémarrez l'agent d'administration.

      Pour redémarrer un agent d'administration nommé adminagent, exécutez les commandes suivantes à partir d'une invite de commande, dans le répertoire bin du profil de l'agent d'administration :

      stopServer adminagent
      
      startServer adminagent
    6. Vérifiez que le noeud n'est plus enregistré sur l'agent d'administration.

Résultats

Le noeud de serveur d'applications n'est plus enregistré sur l'agent d'administration.

Que faire ensuite

Vous pouvez utiliser le noeud désenregistré en mode autonome ou enregistrer le noeud avec un autre agent d'administration. Si vous le souhaitez, utilisez la commande manageprofiles pour supprimer le profil du serveur d'applications.


Icône indiquant le type de rubrique Rubrique de tâche



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