Sie können ein Job-Manager-Profil und den zugehörigen Satz registrierter Server von Version 7.0 oder höher auf Version 9.0 migrieren.
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
Lesen Sie die Informationen zur Migrationsplanung
auf der Webseite Knowledge Collection: Migration planning for WebSphere Application Server.
Tipp: Anstatt einzelne Parameter in Migrationsbefehlen anzugeben, können Sie
den Parameter
-properties Dateiname.properties angeben, um eine Eigenschaftendatei einzugeben.
Weitere Informationen hierzu finden Sie im Artikel
Migration mit Eigenschaften migrieren.
Informationen zu diesem Vorgang
Für die Job-Manager-Profile können ein oder mehrere der folgenden Servertypen registriert sein:
- Deployment-Manager-Server
- Verwaltete Basisanwendungsserver (die auch bei einem Verwaltungsagenten registriert sind)
Fehler vermeiden: - Verwaltete Basisanwendungsserver und Deployment-Manager-Server
können keine Jobs von einem Job-Manager der vorherigen Version akzeptieren.
Zum Vermeiden von Problemen sollten vor der Migration der
verwalteten Basisanwendungsserver und Deployment-Manager-Server auf Version 9.0 die Job-Manager-Profile auf
Version 9.0 migrieren.
- Wenn Sie einen verwalteten Basisanwendungsserver oder einen verwalteten Deployment-Manager-Server
in einer Umgebung mit flexibler Verwaltung implementieren, müssen die Knotennamen in Version 9.0
und im vorherigen Release identisch sein.
- Stellen Sie sicher, dass der Wert für die maximale Anzahl geöffneter Dateien 10000 oder höher ist. Wenn dieser Wert zu niedrig angegeben ist, kann dies zu einer Reihe von Migrationsfehlern führen.
gotcha
Vorgehensweise
- Installieren Sie WebSphere Application Server Network Deployment
Version 9.0 auf dem Zielhost in einem neuen Verzeichnis.
Weitere Informationen finden Sie in der Installationsdokumentation.
- Erstellen Sie ein Profil des Job-Managers von Version 9.0, das als Ziel für die Migration des Job-Managers verwendet wird.
Führen Sie den Befehl
manageprofiles mit den geeigneten Parametern aus, um ein neues Job-Manager-Profil zu erstellen.
Beispiel:
C:\WebSphere\AppServer90\bin>manageprofiles.bat -create -profileName JobMgr01
-profilePath C:\WebSphere\AppServer90\profiles\JobMgr01 -templatePath C:\WebSphere\AppServer90\profileTemplates\management
-serverType JOB_MANAGER -nodeName JobMgr01Node01 -cellName JobMgr01Cell01 -hostName localhost
- Stoppen Sie den alten Job-Manager. Alle Jobs, die in der alten Job-Manager-Datenbank enthalten sind, werden im Rahmen der Migration ebenfalls migriert.
- Speichern Sie die aktuelle Job-Manager-Konfiguration im Migrationssicherungsverzeichnis. Führen Sie dazu den Befehl
WASPreUpgrade im Verzeichnis bin des neuen Installationsstammverzeichnisses von WebSphere Application Server aus.
Der Befehl
WASPreUpgrade nimmt keine Änderungen an der alten Konfiguration vor.
- Führen Sie den Befehl WASPreUpgrade aus. Beispiel:
C:\WebSphere\AppServer90\bin>WASPreUpgrade.bat C:\WAS70JobMgrbackup C:\WebSphere\AppServer70 -oldProfile JobMgr01
-traceString *=all=enabled -tracefile C:\WAS70JobMgrbackup\logs\WASPreMigrationSummary.log
- Prüfen Sie die Warnungen und Fehler in der Konsolenausgabe und in den
WASPreUpgrade-Protokollen. Nach Ausführung des
Befehls WASPreUpgrade suchen Sie in der Konsolenausgabe nach Nachrichten
des Typs Failed with errors oder Completed with warnings.
Prüfen Sie anschließend die folgenden Protokolldateien auf Warnungen oder Fehler:
- Migrationssicherungsverzeichnis/logs/WASPreMigrationSummary.log
- WASPreUpgrade.Zeitmarke.log
- WASPreUpgrade.trace
Falls Fehler vorhanden sind, beheben Sie diese und führen Sie
den Befehl WASPreUpgrade erneut aus.
Prüfen Sie, ob sich
die Warnungen auf Migrations- oder Laufzeitaktivitäten
in Version 9.0 auswirken.
Wurde der Befehl erfolgreich ausgeführt, ist es nicht erforderlich,
in den Protokollen nach Fehlern oder Warnungen zu suchen.
- Ursprüngliche Job-Manager-Konfiguration wiederherstellen Führen Sie den Befehl
WASPostUpgrade im Verzeichnis bin des Installationsstammverzeichnisses der neuen
WebSphere Application Server aus, um die vorherige Job-Manager-Konfiguration, die im Migrationssicherungsverzeichnis
gespeichert wurde, wiederherzustellen.
Fehler vermeiden: Zum Vermeiden von Datenbankinkonsistenzen führen Sie den Befehl
WASPostUpgrade unmittelbar nach der Ausführung des Befehls
WASPreUpgrade aus. Bei Ausführung von
WASPreUpgrade wird auch eine Sicherung der Datenbank erstellt.
Wenn Sie den alten Job-Manager vor der Ausführung von
WASPostUpgrade erneut starten, sind die Datenbank in der Sicherung und die Datenbank im alten Job-Manager
nicht synchron.
gotcha
- Führen Sie den Befehl
"WASPostUpgrade" aus, um die gespeicherte Job-Manager-Konfiguration
im neuen Profil des Verwaltungsagenten der Version 9.0 wiederherzustellen. Beispiel:
C:\IBM\WebSphere\AppServer90\bin>WASPostUpgrade.bat C:\WAS70JobMgrbackup -oldProfile JobMgr01 -profileName JobMgr01
-traceString *=all=enabled -tracefile C:\WAS70JobMgrbackup\logs\WASPostMigrationSummary.log -username myuser -password mypass
- Prüfen Sie die Warnungen und Fehler in der Konsolenausgabe und in den
WASPostUpgrade-Protokollen. Nach Ausführung des
Befehls WASPostUpgrade suchen Sie in der Konsolenausgabe nach Nachrichten
des Typs Failed with errors oder Completed with warnings.
Prüfen Sie anschließend die folgenden Protokolldateien auf Warnungen oder Fehler:
- Migrationssicherungsverzeichnis/logs/WASPostMigrationSummary.log
- WASPostUpgrade.Name_des_Zielprofils.Zeitmarke.log
- WASPostUpgrade.Name_des_Zielprofils.trace
Falls Fehler vorhanden sind, beheben Sie diese und führen Sie
den Befehl WASPostUpgrade erneut aus.
Prüfen Sie, ob sich
die Warnungen auf Migrations- oder Laufzeitaktivitäten
in Version 9.0 auswirken.
Wurde der Befehl erfolgreich ausgeführt, ist es nicht erforderlich,
in den Protokollen nach Fehlern oder Warnungen zu suchen.
- Starten Sie den Job-Manager von Version 9.0 und vergewissern Sie sich, dass Version 7.0 oder höher und Version 9.0 des Job-Managers ausgeführt werden.
- Wechseln Sie in das Verzeichnis bin des neuen Job-Manager-Profils von Version 9.0.
- Führen Sie den Befehl
startServer jobmgr aus.
- Prüfen Sie die Datei SystemOut.log
auf Warnungen oder Fehler.
Anmerkung: Dieser Artikel referenziert eine oder mehrere Protokolldateien des Anwendungsservers. Alternativ dazu wird empfohlen, den Server
so zu konfigurieren, dass er die HPEL-Protokoll- und -Traceinfrastruktur (High Performance Extensible Logging) verwendet und nicht die Dateien SystemOut.log , SystemErr.log,
trace.log und activity.log auf verteilten oder IBM® i-Systemen. Sie können HPEL auch in Verbindung
mit Ihren nativen z/OS-Protokolleinrichtungen verwenden. Wenn Sie HPEL verwenden, können Sie
mit dem Befehlszeilentool LogViewer im Verzeichnis "bin" des Serverprofils auf alle Ihre Protokoll- und Tracedaten zugreifen. Weitere Informationen zur Verwendung von
HPEL finden Sie in der Dokumentation zum Einsatz von HPEL für die Fehlerbehebung in Anwendungen.
- Migrieren Sie die registrierten Server.
Der Job-Manager von Version 9.0 kann registrierte Server von Version 7.0 oder höher verwalten. Sie müssen die registrierten Server nicht migrieren, damit die Topologie mit Version 7.0 oder höher mit dem Job-Manager von Version 9.0 funktioniert.
Führen Sie
für jeden registrierten Server,
den Sie auf
Version 9.0 migrieren möchten, die folgenden Schritte aus:
Ergebnisse
Sie haben ein Job-Manager-Profil und die zugehörigen
verwalteten Basisanwendungsserver mit den Migrationstools
von WebSphere Application Server Version 7.0 oder höher auf Version 9.0 migriert.