Profil eines Verwaltungsagenten und seine registrierten verwalteten Basisanwendungsserver unter z/OS migrieren

Profile von Verwaltungsagenten verwalten mehrere Basisanwendungsserver in Umgebungen wie z. B. Entwicklungsumgebungen, bei Einheitentests oder in dem Teil einer Serverfarm, der sich auf einer einzelnen Maschine befindet. Bevor verwaltete Basisanwendungsserver von Version 7.0 oder höher auf Version 9.0 migriert werden können, muss zuerst der Verwaltungsagent migriert werden.

Vorbereitende Schritte

Unterstützte Konfigurationen Unterstützte Konfigurationen:

Dieser Artikel beschreibt die Migration von Profilkonfigurationen. Wenn Sie Ihre Anwendungen auf die aktuellste Version migrieren möchten, verwenden Sie WebSphere Application Server Migration Toolkit. Weitere Informationen finden Sie unter Migration Toolkit on WASdev.

sptcfg

Sehen Sie sich die Informationen zur Migrationsplanung an. Weitere Informationen finden Sie auf der Webseite Knowledge Collection: Migration planning for WebSphere Application Server.

Sie können Profile von Verwaltungsagenten und ihre registrierten verwalteten Basisanwendungsserver von Version 7.0 oder höher auf Version 9.0 migrieren.

Informationen zu diesem Vorgang

In dieser Aufgabe wird beschrieben, wie Sie z/OS Configuration Migration Management Tool verwenden, um einen Verwaltungsagenten und die ihm zugeordneten verwalteten Basisanwendungsserver von WebSphere Application Server Version 7.0 oder höher auf Version 9.0 zu migrieren. Ein Basisanwendungsserver wird dann zu einem verwalteten Basisanwendungsserver, wenn er bei einem einzelnen Verwaltungsagenten registriert ist. Ein Verwaltungsagent kann ein oder mehrere Basisanwendungsserver verwalten und muss denselben Release-Level haben und sich auf derselben Maschine befinden wie die von ihm verwalteten Basisanwendungsserver. Unter z/OS kann entweder nur der Verwaltungsagent der Version 7.0 oder höher oder nur der Verwaltungsagent der Version 9.0 aktiv sein. Die folgenden Anweisungen erläutern, in welchen Fällen Sie den alten und den neuen Verwaltungsagenten starten und stoppen müssen. Diese Einschränkung bedingt, dass alle verwalteten Basisanwendungsserver zurselben Zeit migriert werden müssen.

Fehler vermeiden Fehler vermeiden: Wenn Sie einen verwalteten Anwendungsserver in einer flexiblen Verwaltungsumgebung migrieren möchten, müssen die Knotennamen in Version 9.0 mit den Knotennamen im früheren Release übereinstimmen. gotcha

Vorgehensweise

  1. Sichern Sie den Quellenverwaltungsagenten und die -knotenkonfiguration mit dem Befehl backupConfig.

    Der Befehl backupConfig speichert die den Verwaltungsagenten und die Knotenkonfiguration in einer Datei, die Sie später für die Wiederherstellung verwenden können.

    1. Wechseln Sie in das Verzeichnis Profilstammverzeichnis_des_Verwaltungsagenten/bin.
    2. Führen Sie den Befehl backupConfig mit den geeigneten Parametern auf dem Verwaltungsagenten und allen verwalteten Basisanwendungsservern aus. Beispiel:
      /opt/WebSphereV70/profiles/v70dmgr01/bin/backupConfig.sh 
      /mybackupdir/v70dmgr01backupBeforeV90migration.zip 
      -username myuser -password mypass -nostop
    3. Wechseln Sie für jeden Knoten in der Knofiguration in das Verzeichnis Profilstammverzeichnis/bin.
    4. Führen Sie den Befehl backupConfig mit den geeigneten Parametern aus, um die aktuelle Profilkonfiguration in einer Datei zu sichern. Beispiel:
      /opt/WebSphereV70/profiles/v70mas01/bin/backupConfig.sh 
      /mybackupdir/v70mas01rbackupBeforeV90migration.zip 
      -username myuser -password mypass -nostop

    Alternativ können Sie den Befehl PAX verwenden, um alle HFS-Dateien zu sichern. Weitere Informationen finden Sie unter Using the z/OS UNIX pax command.

  2. Installieren Sie WebSphere Application Server for z/OS Version 9.0 auf jedem Zielhost.

    Weitere Informationen finden Sie in der Installationsdokumentation.

  3. Geben Sie die Migrationskonfiguration für den neuen Verwaltungsagenten in z/OS Migration Management Tool an.

    Verwenden Sie z/OS Migration Management Tool, um eine Migrationsdefinition zu erstellen und die Jobs für die Migration des Verwaltungsagenten hochzuladen.

    Fehler vermeiden Fehler vermeiden: Die Zelle mit Version 9.0 muss mit dem Zellennamen in der Konfiguration von Version 7.0 oder höher übereinstimmen. Sollten Sie ein Profil mit einem neuen Zellennamen erstellen, schlägt die Migration fehl.gotcha
    1. Führen Sie das folgende Arbeitsblatt aus: Konfiguration für die Deployment-Manager-Migration mit z/OS Migration Management Tool festlegen: Arbeitsblatt
    2. Wählen Sie in der Anzeige "Auswahl des Migrationsknotentyps" die Option Verwaltungsagenten migrieren aus.
    3. Füllen Sie die Felder in den nachfolgenden Anzeigen mit den Werten aus Ihrem Arbeitsblatt aus.
    4. Sehen Sie sich die Migrationsdefinition für den Verwaltungsagenten an, um sicherzustellen, dass alle Werte richtig sind.
      • Wählen Sie in der Tabelle mit den Migrationsdefinitionen von WebSphere Application Server for z/OS die Migrationsdefinition aus, die Sie überprüfen möchten.
      • Klicken Sie auf Anzeigen.
      • Informationen zur Migrationsdefinition erhalten Sie, wenn Sie auf Zusammenfassung, Anweisungen oder Antwortdatei klicken.
    5. Laden Sie die Migrationsjobs auf das z/OS-Zielsystem hoch.
  4. Stellen Sie sicher, dass alle in Bearbeitung befindliche Jobs für die verwalteten Profile ausgeführt wurden.

    Vor Ausführung des Befehls WASPreUpgrade für einen verwalteten Anwendungsserver oder Deployment Manager müssen alle in Bearbeitung befindlichen Jobs abgeschlossen sein.

  5. Wenn der Verwaltungsagent bei einem Job-Manager registriert ist, stoppen Sie das Abfragen des Job-Managers.

    Weitere Informationen zum Stoppen des Job-Managers finden Sie im Artikel Befehlsgruppe "ManagedNodeAgent" für das Objekt "AdminTask" mit wsadmin-Scripting.

  6. Führen Sie die Migrationsjobs für den Verwaltungsagenten mithilfe der folgenden Anweisungen in der Ansicht Migrationsanweisungen von z/OS Migration Management Tool bzw. in der Teildatei BBOMAINS der CNTL-Datei aus, die Sie auf das z/OS-Zielsystem hochgeladen haben.

    Die Schritte CRPROF (Profil erstellen), PREUPGRD (Upgradevorbereitung) und UPGRADE werden alle in diesem Prozess ausgeführt.

  7. Überprüfen Sie alle im Arbeitsverzeichnis des HFS/ZFS erstellten Ausgaben (angegeben in ZMMT) und alle von den Stapeljobs erstellten MVS-Jobausgaben.

    Prüfen Sie, ob die Rückkehrcodes 0 zurückgegeben werden, und überprüfen Sie die Protokolldateien im temporären Migrationsverzeichnis des Konfigurationsdateisystems.

    Das temporäre Migrationsverzeichnis ist temporäre_Verzeichnisposition/nnnnn. Dabei ist temporäre_Verzeichnisposition das für die temporäre Verzeichnisposition angegebene Verzeichnis und nnnnn ist der numerische Wert, der bei der Generierung Ihrer Migrationsjobs für die Migrations-ID generiert wird. Die Standardeinstellung für das temporäre Verzeichnis ist /tmp/migrate.

  8. Geben Sie in z/OS Migration Management Tool eine Migrationskonfiguration für einen verwalteten Anwendungsserver an.

    Verwenden Sie z/OS Migration Management Tool, um eine Migrationsdefinition zu erstellen und die Jobs für die Migration der verwalteten Basisanwendungsserver hochzuladen.

    Fehler vermeiden Fehler vermeiden: Die Zelle mit Version 9.0 muss mit dem Zellennamen in der Konfiguration von Version 7.0 oder höher übereinstimmen. Sollten Sie ein Profil mit einem neuen Zellennamen erstellen, schlägt die Migration fehl.gotcha
    1. Führen Sie das folgende Arbeitsblatt aus: Konfiguration für die Migration eines eingebundenen Knotens mit z/OS Migration Management Tool festlegen: Arbeitsblatt
    2. Wählen Sie in der Anzeige "Auswahl des Migrationsknotentyps" die Option Verwalteten Basisanwendungsserver migrieren aus.
    3. Füllen Sie die Felder in den nachfolgenden Anzeigen mit den Werten aus Ihrem Arbeitsblatt aus.
    4. Sehen Sie sich die Migrationsdefinition für den eingebundenen Knoten an, um sicherzustellen, dass alle Werte korrekt sind.
      • Wählen Sie in der Tabelle mit den Migrationsdefinitionen von WebSphere Application Server for z/OS die Migrationsdefinition aus, die Sie überprüfen möchten.
      • Klicken Sie auf Anzeigen.
      • Informationen zur Migrationsdefinition erhalten Sie, wenn Sie auf Zusammenfassung, Anweisungen oder Antwortdatei klicken.
    5. Laden Sie die Migrationsjobs auf das z/OS-Zielsystem hoch.
  9. Führen Sie die Migrationsjobs für den verwalteten Basisanwendungsserver mithilfe der folgenden Anweisungen in der Ansicht Migrationsanweisungen von z/OS Migration Management Tool bzw. in der Teildatei BBOMDINS der CNTL-Datei aus, die Sie auf das z/OS-Zielsystem hochgeladen haben.

    Die Schritte CRPROF (Profil erstellen), PREUPGRD (Upgradevorbereitung) und UPGRADE werden alle in diesem Prozess ausgeführt.

    Fehler vermeiden Fehler vermeiden:
    • Vergewissern Sie sich, dass der Quellenverwaltungsagent aktiv ist, sodass die Registrierung des Anwendungsservers beim Verwaltungsagenten aufgehoben werden kann.
    • Wenn der verwaltete Anwendungsserver auch in einem Job-Manager registriert ist, müssen Sie die Registrierung im Job-Manager aufheben, bevor Sie eine Migration des verwalteten Anwendungsservers durchführen. Nach Abschluss der Migration führen Sie erneut eine Registrierung beim Verwaltungsagenten und Job-Manager durch.
    gotcha
  10. Überprüfen Sie alle im Arbeitsverzeichnis des HFS erstellten Ausgaben (angegeben in ZMMT) und alle von den Stapeljobs erstellten MVS-Jobausgaben.

    Prüfen Sie, ob die Rückkehrcodes 0 zurückgegeben werden, und überprüfen Sie die Protokolldateien im temporären Migrationsverzeichnis des Konfigurationsdateisystems.

    Das temporäre Migrationsverzeichnis ist temporäre_Verzeichnisposition/nnnnn. Hier bezeichnet temporäre_Verzeichnisposition das Verzeichnis, das als temporäre Verzeichnisposition angegeben wurde, und nnnnn bezeichnet den numerischen Wert, der als Migrationskennung beim Generieren der Migrationsjobs generiert wurde. Die Standardeinstellung für das temporäre Verzeichnis ist /tmp/migrate.

  11. Neuen migrierten Verwaltungsagenten der Version 9.0 aufrufen
    Fehler vermeiden Fehler vermeiden: Stellen Sie sicher, dass alle im alten Verwaltungsagenten verwalteten Anwendungsserver migriert wurden. Die Registrierung dieser Anwendungsserver sollte während der jeweiligen Migrationsprozesse aufgehoben worden sein. gotcha
    1. Stoppen Sie den alten Verwaltungsagenten von Version 7.0 oder höher.
    2. Starten Sie den neuen Verwaltungsagenten der Version 9.0.
  12. Starten Sie den verwalteten Anwendungsserver.
    1. Starten Sie jeden verwalteten Basisanwendungsserver.
    2. Registrieren Sie jeden verwalteten Anwendungsserver bei dem neuen Verwaltungsagenten.
    Suchen Sie in den Node-Agent-Protokollen nach Fehlern.
  13. Starten Sie das Abfragen des Job-Managers.

    Weitere Informationen finden Sie im Artikel Befehlsgruppe "ManagedNodeAgent" für das Objekt "AdminTask" mit wsadmin-Scripting.

Ergebnisse

Sie haben das Profil eines Verwaltungsagenten und die zugehörigen verwalteten Basisanwendungsserver mit den Migrationstools von WebSphere Application Server Version 7.0 oder höher auf Version 9.0 migriert.


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-zos&topic=tmig_migrate_adminagent_zos
Dateiname:tmig_migrate_adminagent_zos.html