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: 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: 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
- 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.
- Wechseln Sie in das Verzeichnis Profilstammverzeichnis_des_Verwaltungsagenten/bin.
- 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
- Wechseln Sie für jeden Knoten in der Knofiguration in das Verzeichnis Profilstammverzeichnis/bin.
- 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.
- Installieren Sie WebSphere Application Server for z/OS
Version 9.0 auf jedem Zielhost.
Weitere Informationen finden Sie in der Installationsdokumentation.
- 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: 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
- Führen Sie das folgende Arbeitsblatt aus: Konfiguration für die Deployment-Manager-Migration mit z/OS Migration Management Tool festlegen: Arbeitsblatt
- Wählen Sie in der Anzeige "Auswahl des Migrationsknotentyps" die Option Verwaltungsagenten migrieren aus.
- Füllen Sie die Felder in den nachfolgenden Anzeigen mit den Werten aus Ihrem Arbeitsblatt aus.
- 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.
- Laden Sie die Migrationsjobs auf das z/OS-Zielsystem hoch.
- 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.
- 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.
- 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.
- Ü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.
- 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: 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
- Führen Sie das folgende Arbeitsblatt aus: Konfiguration für die Migration eines eingebundenen Knotens mit z/OS Migration Management Tool festlegen: Arbeitsblatt
- Wählen Sie in der Anzeige "Auswahl des Migrationsknotentyps" die Option Verwalteten Basisanwendungsserver migrieren aus.
- Füllen Sie die Felder in den nachfolgenden Anzeigen mit den Werten aus Ihrem Arbeitsblatt aus.
- 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.
- Laden Sie die Migrationsjobs auf das z/OS-Zielsystem hoch.
- 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: - 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
- Ü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.
- Neuen migrierten Verwaltungsagenten
der Version 9.0 aufrufen
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
- Stoppen Sie den alten Verwaltungsagenten von Version 7.0 oder höher.
- Starten Sie den neuen Verwaltungsagenten der Version 9.0.
- Starten Sie den verwalteten Anwendungsserver.
- Starten Sie jeden verwalteten Basisanwendungsserver.
- Registrieren Sie jeden verwalteten Anwendungsserver bei dem neuen Verwaltungsagenten.
Suchen Sie in den Node-Agent-Protokollen nach Fehlern.
- 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.