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.

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