Registrierung von Knoten beim Verwaltungsagenten aufheben

Sie können die Registrierung von Anwendungsserverknoten bei einem Verwaltungsagenten aufheben. Heben Sie die Registrierung eines Knotens auf, wenn Sie den Knoten nicht mehr in der Umgebung des Verwaltungsagenten benötigen oder wenn Sie beabsichtigen, das Profil des Anwendungsserverknotens zu löschen. Nach dem Aufheben der Registrierung bei einem Verwaltungsagenten können Sie den Knoten eigenständig verwenden, den Knoten bei einem anderen Verwaltungsagenten registrieren oder das Profil des Anwendungsserverknotens löschen.

Vorbereitende Schritte

Der Anwendungsserverknoten, den Sie aus der Umgebung des Verwaltungsagenten entfernen möchten, muss beim Verwaltungsagenten registriert sein. Starten Sie den Verwaltungsagenten, wenn er noch nicht aktiv ist.

Wenn der Anwendungsserverknoten bei einem Job-Manager registriert ist, heben Sie die Registrierung des Knotens beim Job-Manager auf. Sie können die Konsole des Verwaltungsagenten oder wsadmin-Befehle verwenden, um die Registrierung des Knotens aufzuheben:
  • Konsole des Verwaltungsagenten verwenden, um die Registrierung des eigenständigen Anwendungsserverknotens bei einem Job-Manager aufzuheben:
    1. Melden Sie sich an der Verwaltungsagentenkonsole an. Der Verwaltungsagent hat einen Namen wie HostnameAANode01.
    2. Klicken Sie auf Systemverwaltung > Verwaltungsagent.
    3. Klicken Sie auf der Registerkarte "Konfiguration" der Seite "Verwaltungsagent" auf Knoten.
    4. Wählen Sie auf der Seite "Knoten" den Knoten aus, dessen Registrierung beim Job-Manager Sie aufheben möchten, und klicken Sie anschließend auf Registrierung bei einem Job-Manager zurücknehmen.
    5. Geben Sie auf der Seite "Registrierung bei einem Job-Manager zurücknehmen" einen Knotennamen an, geben Sie eine Portnummer für die Administrationskonsole des Job-Managers an, geben Sie optional weitere Parameter wie den Benutzernamen und das Kennwort für den Job-Manager an, und klicken Sie anschließend auf OK.

      Falls die Sicherheit nicht aktiviert ist, geben Sie im Feld Port den Wert 9960 für einen nicht gesicherten Port für die Administrationskonsole des Job-Managers an. Wenn Sie keine Portnummer angeben, wird der gesicherte Standardport 9943 verwendet.

  • wsadmin-Befehl unregisterWithJobManager in der Befehlsgruppe "ManagedNodeAgent" ausführen, um die Registrierung des eigenständigen Anwendungsserverknotens bei einem Job-Manager aufzuheben:

    Wenn Sie den Befehl "unregisterWithJobManager" ausführen, geben Sie den Namen des eigenständigen Anwendungsserverknotens, der vom Job-Manager verwaltet wird, mit dem erforderlichen Parameter -managedNodeName an. Die anderen Parameter sind optional.

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

    Der Standardwert für den Parameter -host ist localhost.

    Der Standardwert für den Parameter -port ist 9943 (die Nummer des sicheren Ports für die Administrationskonsole des Job-Managers). Wenn die Sicherheit inaktiviert ist, geben Sie 9960 an, die Standardnummer für den nicht gesicherten Port.

    Weitere Informationen zum Befehl "unregisterWithJobManager" und seinen Parametern finden Sie im Artikel zur Befehlsgruppe "ManagedNodeAgent" für das Objekt "AdminTask".

    Wenn das System die Registrierung eines eigenständigen Anwendungsservers bei einem Job-Manager nicht zurücknehmen kann, führen Sie den Befehl cleanupTarget in der Gruppe "JobManagerNode" aus, um die Registrierungsinformationen des Job-Managers zu entfernen. Weitere Informationen finden Sie im Artikel zur Befehlsgruppe "JobManagerNode" für das Objekt "AdminTask".

Informationen zu diesem Vorgang

Zum Aufheben der Registrierung eines Knotens führen Sie den Befehl deregisterNode im Verzeichnis bin des Verwaltungsagenten aus. Schritt 1 beschreibt, wie Sie den Befehl deregisterNode ausführen.

Wenn Sie die Registrierung eines Knotens zurücknehmen, bleibt die Knotenkonfiguration erhalten, wird jedoch beim Verwaltungsagenten als nicht registriert markiert. Wenn auf dem Knoten, dessen Registrierung Sie aufheben möchten, die Administrationskonsole oder Management-EJB-Anwendungen (Enterprise JavaBeans) installiert waren, bevor Sie die Registrierung durchgeführt haben, werden diese reaktiviert.

Die Ausführung des Befehls deregisterNode kann zu einer Nullzeigerausnahme führen, wenn das Profil des Anwendungsserverknotens beschädigt oder nicht verwendbar ist. Wenn Sie eine Nullzeigerausnahme empfangen, ist der Prozess zur Rücknahme der Registrierung des Anwendungsservers aus dem Verwaltungsagenten fehlgeschlagen. Im Fehlerprotokoll werden Nachrichten mit den Nummern ADMU0116I, ADMU0128I, ADMU0211I, ADMU0113E und ADMU1211I aufgezeichnet. Schritt 2 beschreibt, wie ein Knoten und die zugehörigen Endpunkte entfernt werden, wenn eine Nullzeigerausnahme eintritt.

Wenn das Profil des Anwendungsserverknotens gelöscht wird, bevor die Registrierung des Knotens aufgehoben wird, ist die Ausführung des Befehls deregisterNode unwirksam. Da das Profil nicht mehr vorhanden ist, erkennt der Verwaltungsagent das Profil nicht. Führen Sie Schritt 2 aus, um den Knoten und die zugehörigen Endpunkte aus der Umgebung des Verwaltungsagenten zu entfernen.

Vorgehensweise

  1. Heben Sie die Registrierung eines Knotens mit dem Befehl deregisterNode auf.

    Wenn der Knoten, dessen Registrierung Sie aufheben möchten, vorhanden ist, führen Sie den Befehl deregisterNode aus, und geben Sie mit dem Befehl den Profilpfad des Knotens an:

    deregisterNode -profilePath Profilstammverzeichnis/Profilname

    Wenn Sie beispielsweise die Registrierung des Profils "AppSrv02" in der Umgebung des Verwaltungsagenten aufheben möchten, führen Sie den folgenden Befehl aus:

    deregisterNode -profilePath Profilstammverzeichnis/AppSrv02

    Informationen zu den Befehlsparametern finden Sie im Artikel zum Befehl deregisterNode.

  2. Wenn eine Nullzeigerausnahme während der Ausführung des Befehls deregisterNode eintritt oder wenn das Knotenprofil gelöscht wurden, führen Sie wsadmin-Befehle aus, die den registrierten Knoten und die zugehörigen Endpunkte entfernen.
    1. Führen Sie in einer Befehlszeile einen Befehl aus, um das Scripting-Tool "wsadmin" im Verzeichnis bin des Verwaltungsagenten zu starten.
      Wenn Sie die Scripting-Sprache Jython verwenden möchten, geben Sie Folgendes ein:
      wsadmin -lang jython
      Wenn Sie die Scripting-Sprache Jacl verwenden möchten, geben Sie Folgendes ein:
      wsadmin
    2. Wenn Sie den Namen des zu entfernenden Knotens nicht kennen, führen Sie den AdminConfig-Befehl list aus, um Knoten aufzulisten, die beim Verwaltungsagenten registriert sind, und suchen Sie dann in dieser Liste den zu entfernenden Knoten.
      Für Jython:
      print AdminConfig.list('ManagedNode')
      Für Jacl:
      $AdminConfig list ManagedNode

      Die daraufhin angezeigte Liste der registrierten Knoten gleicht der folgenden:

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

      Diese Liste zeigt, dass die Knoten nodeA und nodeB registrierte Knoten des Verwaltungsagenten myAACell01 sind.

    3. Setzen Sie wsadmin-Befehle ab, die den Knoten entfernen.

      Zum Entfernen des Knotens nodeA und zum Speichern der Änderungen führen Sie nacheinander die folgenden Befehle aus:

      Für Jython:
      mn = AdminConfig.getid('/ManagedNode:nodeA/')
      
      AdminConfig.remove(mn)
      
      AdminConfig.save()
      Für Jacl:
      set mn [$AdminConfig getid /ManagedNode:nodeA/]
      
      $AdminConfig remove $mn
      
      $AdminConfig save   
    4. Führen Sie wsadmin-Befehle aus, die Endpunkte entfernen, die bei der Registrierung des Knotenprofils für das Subsystem generiert wurden.

      Führen Sie nacheinander die folgenden Befehle aus, um die Endpunkte für nodeA zu entfernen. Der Befehl for in Jython und der Befehl foreach in Jacl sind einzeilige Befehle, die hier nur zur besseren Lesbarkeit auf mehrere Zeilen verteilt sind.

      Für 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
      Für 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. Starten Sie den Verwaltungsagenten erneut.

      Wenn Sie einen Verwaltungsagenten mit dem Namen adminagent erneut starten möchten, führen Sie die folgenden Befehle an einer Eingabeaufforderung im Verzeichnis bin des Verwaltungsagentenprofils aus:

      stopServer adminagent
      startServer adminagent
    6. Vergewissern Sie sich, dass der Knoten nicht mehr beim Verwaltungsagenten registriert ist.

Ergebnisse

Der Anwendungsserverknoten ist nicht mehr beim Verwaltungsagenten registriert.

Nächste Schritte

Sie können den Knoten, dessen Registrierung Sie aufgehoben haben, eigenständig verwenden oder den Knoten bei einem anderen Verwaltungsagenten registrieren. Verwenden Sie optional den Befehl manageprofiles, um das Anwendungsserverprofil zu löschen.


Symbol, das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tagt_adminagent_deregister_node
Dateiname:tagt_adminagent_deregister_node.html