Mit dem Befehl WBIPostUpgrade für WebSphere ESB können Sie die Profilkonfiguration abrufen, die mit dem Befehl WBIPreUpgrade in dem von Ihnen angegebenen sicherungsverzeichnis gespeichert wurde.
Wichtig: i5/OS wird nur unterstützt, wenn Sie von
Version 6.1.x auf
Version 6.2 migrieren.
Anmerkung: Wenn die Migration auf einer
i5/OS-Plattform erfolgt, muss der Name des Zielprofils
mit dem Namen des zu migrierenden Quellenprofils übereinstimmen.
Details
Das Script WBIPostUpgrade für WebSphere ESB liest die Konfiguration, die auf WebSphere ESB Version 6.2 migriert werden soll, aus dem sicherungsverzeichnis und fügt alle migrierten Anwendungen in das Verzeichnis profilstammverzeichnis/installedApps für die neue Installation von WebSphere ESB hinzu.
Position
Die Befehlsdatei befindet sich im Verzeichnis
installationsstammverzeichnis/bin und sollte auch in diesem
Verzeichnis ausgeführt werden.
Syntax
Die Syntax lautet:
WBIPostUpgrade sicherungsverzeichnis
[-username benutzer-ID]
[-password kennwort]
[-scriptCompatibility true | false]
[-portBlock erste_portnummer]
[-backupConfig true | false]
[-replacePorts true | false]
[-keepDmgrEnabled true | false]
[-keepAppDirectory true | false]
[-appInstallDirectory benutzerdefiniertes_verzeichnis]
[-traceString tracespezifikation [-traceFile dateiname ]]
[-createTargetProfile]
Anmerkung: Der Parameter -profileName wird auf der i5/OS-Plattform nicht unterstützt. Falls er dennoch verwendet wird, so wird eine Ausnahmebedingung wegen eines ungültigen Parameters ausgelöst.

WBIPostUpgrade.sh sicherungsverzeichnis
[-username benutzer-ID]
[-password kennwort]
[-oldProfile profilname]
[-profileName profilname]
[-scriptCompatibility true | false]
[-portBlock erste_portnummer]
[-backupConfig true | false]
[-replacePorts true | false]
[-keepAppDirectory true | false]
[-keepDmgrEnabled true | false]
[-appInstallDirectory benutzerdefiniertes_verzeichnis]
[-traceString tracespezifikation [-traceFile dateiname ]]
[-createTargetProfile]
WBIPostUpgrade.bat sicherungsverzeichnis
[-username benutzer-ID]
[-password kennwort]
[-oldProfile profilname]
[-profileName profilname]
[-scriptCompatibility true | false]
[-portBlock erste_portnummer]
[-backupConfig true | false]
[-replacePorts true | false]
[-keepAppDirectory true | false]
[-keepDmgrEnabled true | false]
[-appInstallDirectory benutzerdefiniertes_verzeichnis]
[-traceString tracespezifikation [-traceFile dateiname ]]
[-createTargetProfile]
Anmerkung: Der Parameter -oldProfile muss dem Parameter -profileName (für das neue Profil) vorangestellt werden.
Parameter
Die folgenden Parameter werden verwendet:
- sicherungsverzeichnis
- Dieser Parameter ist erforderlich. Der Wert für sicherungsverezeichnis gibt den Pfad zu dem Sicherungsverzeichnis an, in dem das Tool WBIPreUpgrade die gespeicherte Konfiguration sowie die Dateien gesichert hat und aus dem das Tool WBIPostUpgrade die Konfiguration und die Dateien liest.
- -username
- Dieser optionale Parameter ist erforderlich, wenn die administrative Sicherheit in der Vorgängerversion von WebSphere ESB konfiguriert ist. Der Wert benutzer-ID gibt den Namen des Benutzers mit Verwaltungsaufgaben für die vorhandene Installation von WebSphere ESB (vor der Migration) an.
- -password
- Dieser optionale Parameter ist erforderlich, wenn die administrative Sicherheit in der Vorgängerversion von WebSphere ESB konfiguriert ist. Der Wert password gibt das Kennwort für den Benutzer mit Verwaltungsaufgaben für die vorhandene Installation von WebSphere ESB (vor der Migration) an.
- -oldProfile
Einschränkung: Dieser Parameter ist auf i5/OS-Plattformen nicht verfügbar.
Dieser optionale Parameter dient zur Migration von Instanzen oder Profilen aus
vorherigen Versionen. Die Instanz oder das Profil muss bereits im Migrationssicherungsverzeichnis
existieren, bevor dieser Befehl ausgeführt werden kann. Bei Nichtangabe des Parameters -oldProfile wird das Standardprofil verwendet. Wird kein Standardprofil
gefunden, gibt das System einen Fehler aus.
- -profileName


Anmerkung: Dieser Parameter wird auf der i5/OS-Plattform nicht unterstützt. Falls er dennoch verwendet wird, so wird eine Ausnahmebedingung des Typs Ungültiger Parameter ausgelöst.
Dieser optionale Parameter dient zur Migration auf bestimmte Profile. Der Wert
profilname gibt den Namen des Profils an, das in der neueren Version von
WebSphere ESB erstellt wurde und vom
Script als Ziel für die Migration der Konfiguration verwendet werden soll. Sie müssen dieses Profil
bereits erstellt haben, bevor Sie den Befehl WBIPostUpgrade aufrufen. Bei Nichtangabe des Parameters -profileName wird das Standardprofil verwendet. Wird kein Standardprofil
gefunden, gibt das System einen Fehler aus.
Anmerkung: Um sicherzustellen, dass das korrekte Profil migriert wird, sollten Sie den Profilnamen mit diesem Parameter angeben und sich nicht auf die Standardeinstellung verlassen.
- -scriptCompatibility
Anmerkung: Dieser Parameter wird für Migrationen von WebSphere ESB Version 6.1.x auf Version 6.2 ignoriert.
Dieser
optionale Parameter legt fest, ob bei der Migration die folgenden Konfigurationsdefinitionen
der Version 6.0.2.x erstellt werden: - Transport
- Prozessdefinition
- SSL für 6.0.2
Andernfalls werden die folgenden Konfigurationsdefinitionen der
Version 6.2 verwendet:
- Kanäle
- Prozessdefinitionen
- SSL für Version 6.2
Der Standardwert lautet true.
Geben Sie für diesen Parameter den Wert true an, um die Auswirkungen auf bestehende Administrationsscripts möglichst gering zu halten. Wenn Sie bestehende wsadmin-Scripts oder andere Programme verwenden, die über Konfigurations-APIs
anderer Anbieter Konfigurationsdefinitionen der Version 6.0.2.x erstellen
oder ändern, sollten Sie bei der Migration den Wert "true" für diese Option angeben.
Anmerkung: Es handelt
sich hierbei um eine vorläufige Übergangslösung, bis alle Knoten in der Umgebung
den Stand von
Version 6.2 aufweisen.
Wenn alle Knoten den neuen Stand aufweisen, führen Sie die folgenden Aktionen aus:
- Ändern Sie Ihre Administrationsscripts dahingehend, dass sie sämtliche Einstellungen der Version 6.2 verwenden.
- Verwenden Sie den Befehl convertScriptCompatability, um Ihre Konfigurationen
so zu konvertieren, dass sie den Einstellungen der
Version 6.2 entsprechen.
Weitere
Informationen finden Sie im Artikel
Befehl 'convertScriptCompatibility'.
- -portBlock
- Dieser Parameter ist optional. Der Wert erste_portnummer gibt den ersten
Port in einem Block aufeinanderfolgender Portnummern an, die bei der Ausführung des
Befehlsscripts zugeordnet werden.
- -replacePorts
- Dieser optionale Parameter legt fest, auf welche Weise Portwerte für virtuelle Hosts
und Ports für Web-Container-Transporte zugeordnet werden.
- -keepAppDirectory
Anmerkung: Dieser Parameter wird bei der Migration von WebSphere ESB Version
6.1 auf Version 6.2 ignoriert.
Dieser optionale Parameter legt fest, ob alle Anwendungen in dieselben Verzeichnisse
installiert werden, in denen sie sich bereits befinden. Der Standardwert ist 'false'. Bei Angabe von 'true' für diesen Parameter behalten alle Anwendungen ihre aktuelle Position bei.
Einschränkungen: Wenn Sie den Wert 'true' für diesen Parameter
angeben, werden die Verzeichnisse von der bestehenden und von der neuen
WebSphere ESB-Installation gemeinsam
genutzt. Wenn migrierte Anwendungen in denselben Verzeichnissen wie
in der vorherigen Version gespeichert werden, gelten die folgenden Einschränkungen:
- Die Einschränkungen hinsichtlich der Unterstützung unterschiedlicher Knoten in
Version 6.2 müssen eingehalten werden. Das bedeutet, dass die folgende Unterstützung beim Aufrufen des Befehls wsadmin
nicht verwendet werden kann:
- JSPs vorkompilieren
- Binäre Konfiguration verwenden
- EJB implementieren
- Sie riskieren den versehentlichen Verlust der migrierten Anwendungen, wenn Sie zu einem
späteren Zeitpunkt bei der Verwaltung der vorherigen Installation (z. B. bei der Deinstallation)
Anwendungen aus diesen Verzeichnissen löschen.
- -keepDmgrEnabled
Anmerkung: Dieser Parameter wird bei der Migration von WebSphere ESB Version
6.1 auf Version 6.2 ignoriert.
Dieser optionale Parameter legt fest, ob der Deployment Manager der bestehenden Installation
von WebSphere ESB inaktiviert werden
soll. Der Standardwert ist 'false'. Bei Angabe von 'true' für diesen Parameter können Sie
den bestehenden Deployment Manager während der Migration verwenden. Der Parameter ist nur dann gültig, wenn Sie einen Deployment Manager migrieren; in allen anderen Migrationsszenarien
wird er ignoriert.
Vorsicht: Verwenden Sie diesen Parameter mit Vorsicht.
- Der Grund dafür, dass bestehende Deployment Manager-Konfigurationen von
WebSphere ESB normalerweise gestoppt
und inaktiviert werden, besteht darin, die gleichzeitige Verwaltung derselben Knoten durch
mehrere Deployment Manager zu verhindern. Sie müssen den bestehenden Deployment Manager stoppen,
bevor Sie den Deployment Manager der neuen Version einsetzen. Wenn Sie dies nicht tun, treten Fehlerbedingungen auf; zu den wahrscheinlichsten Fehlerbedingungen
zählen Portkonflikte, die beim Starten der zweiten Deployment Manager-Instanz auftreten.
- Die Angabe von 'true' für diesen Parameter bedeutet, dass Konfigurationsänderungen,
die während der Migration an der alten Konfiguration vorgenommen werden, nicht migriert werden.
- -appInstallDirectory
Anmerkung: Dieser Parameter wird bei der Migration von WebSphere ESB Version
6.1 auf Version 6.2 ignoriert.
Dieser optionale Parameter übergibt einen Verzeichnisnamen, der für die Installation
der Anwendungen bei der Migration verwendet wird. Bei Nichtangabe dieses Parameters
wird der Standardwert profilname\installedApps verwendet.Falls der Verzeichnisname Leerzeichen enthält, muss er in Anführungszeichen gesetzt werden.
Tipp: Sie können die Variable ${BENUTZERINSTALLATIONSSTAMMVERZEICHNIS} in Ihr Argument einschließen. Diese Variable wird in <WPS-AUSGANGSVERZEICHNIS>\profiles\<profilname> erweitert. Wenn zum Beispiel WebSphere ESB Version 6.2 im Verzeichnis C:\wps\ installiert ist und das Zielprofil ProcSrv01 heißt, steht ${BENUTZERINSTALLATIONSSTAMMVERZEICHNIS} stellvertretend für den Verzeichnispfad C:\wps62\profiles\ProcSrv01.
- -traceString
Anmerkung: Dieser Parameter wird bei Migrationen von WebSphere ESB Version 6.0.2.x auf Version 6.2 ignoriert.
Dieser Parameter ist optional. Der Wert tracespezifikation
gibt die Traceinformationen an, die Sie aufzeichnen möchten.Wenn Sie alle Traceinformationen
aufzeichnen möchten, geben Sie *=all=enabled an.
Wichtig: Wenn
Sie diesen Parameter angeben, müssen Sie auch den Parameter -traceFile angeben. Wenn Sie den Parameter '-traceString' angeben, nicht aber den Parameter '-traceFile', erstellt der Befehl standardmäßig eine Tracedatei und speichert diese im Verzeichnis sicherungsverzeichnis/logs.
- -traceFile
Anmerkung: Dieser Parameter wird bei Migrationen von WebSphere ESB Version 6.0.2.x auf Version 6.2 ignoriert.
Dieser Parameter ist optional. Der Wert dateiname gibt den Namen
der Ausgabedatei für Traceinformationen an. Wichtig: Wenn Sie diesen Parameter angeben, müssen Sie auch den Parameter '-traceString' angeben. Wenn Sie den Parameter '-traceFile' angeben, nicht aber den Parameter '-traceString', dann verwendet der Befehl die Standardtracetiefe und speichert die Tracedatei an der von Ihnen angegebenen Speicherposition.
- -createTargetProfile
Dieser optionale Parameter erstellt ein neues Profil mit den korrekten Konfigurationseinstellungen
für Migrationszwecke.
Protokollierung
Der Befehl WBIPostUpgrade zeigt während seiner Ausführung Statusinformationen auf dem Bildschirm an. Außerdem werden mit diesem Befehl ausführlichere Protokolldaten in der Datei WBIPostUpgrade.zeitmarke.log im Verzeichnis sicherungsverzeichnis/logs gespeichert. Sie können die Datei WBIPostUpgrade.profilnamezeitmarke.log mit einem Texteditor anzeigen.