WebSphere Enterprise Service Bus, Version 6.2.0 Betriebssysteme: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


Befehlszeilendienstprogramm 'WBIPostUpgrade'

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.

For i5/OS operating system 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:

For i5/OS operating system
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.

For Linux operating systemFor UNIX operating system
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]

For Windows operating system
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
For UNIX operating systemFor Linux operating systemFor Windows operating system
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:
  1. Ändern Sie Ihre Administrationsscripts dahingehend, dass sie sämtliche Einstellungen der Version 6.2 verwenden.
  2. 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.
  • Wenn der Parameter den Wert "false" hat, gilt Folgendes:
    Die Portdefinitionen der Version 6.0.x oder 6.1.x werden bei der Migration nicht ersetzt.
    • Die Konfiguration der vorherigen Version wird nicht geändert - Kanäle werden nicht gelöscht.
    • Die folgenden Kanäle werden auf Werte gesetzt, die äquivalent zu den Werten sind, die für die vorherige Version festgelegt wurden:
      • WC_adminhost
      • WC_defaulthost
      • WC_adminhost_secure
      • WC_defaulthost_secure
    • Der Migrationsprozess erstellt auf Basis der Einstellung -scriptCompatibility die Transporte oder Kanäle für alle Ports im vorherigen Release.
    • Der Migrationsprozess setzt alle Ports, die sich nicht auf Web-Container beziehen, auf die Werte, die für das vorherige Release festgelegt wurden.
    • Wenn der Migrationsprozess einen Transport oder Kanal erstellt, der mit dem im Web-Container definierten Port übereinstimmt, kann es zu einem Portkonflikt kommen.

    Hierbei handelt es sich um die Standardeinstellung.

  • Wenn der Parameter den Wert "true" hat, gilt Folgendes:

    Alle Porteinstellungen für Aliasnamen für virtuelle Hosts werden bei der Migration durch Portdefinitionen der Version 6.2 ersetzt.

    Der Migrationsprozess fügt standardmäßig die Konfigurationsdaten aus der vorherigen Umgebung zu den Daten in der neuen WebSphere ESB-Umgebung hinzu. Unter Umständen ist dieses Verhalten für diese Portwerte nicht erwünscht. So kann es beispielsweise sein, dass bestehende Portdefinitionen in einem früheren Release so gewählt wurden, dass keine Portkonflikte mit anderen Produkten entstehen. In einem derartigen Fall möchten Sie diese Einstellungen wahrscheinlich in der Konfiguration der neuen Version weiterverwenden. Wenn Sie den Wert 'true' für diesen Parameter angeben, werden alle Ports für übereinstimmende virtuelle Hosts aus der Konfiguration der neuen Version entfernt, bevor die neuen Werte hinzugefügt werden.
    • Alle dem Web-Container zugeordneten Transportkanäle mit Ausnahme der folgenden Kanäle werden gelöscht. Die folgenden Kanäle werden auf Werte gesetzt, die äquivalent zu den Werten sind, die für die vorherige Version festgelegt wurden:
      • WC_adminhost
      • WC_defaulthost
      • WC_adminhost_secure
      • WC_defaulthost_secure
    • Der Migrationsprozess erstellt auf Basis der Einstellung -scriptCompatibility die Transporte oder Kanäle für alle Ports im vorherigen Release.
    • Der Migrationsprozess setzt alle Ports, die sich nicht auf Web-Container beziehen, auf die Werte, die für das vorherige Release festgelegt wurden.
-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.


reference Referenzabschnitt

Nutzungsbedingungen | Feedback


Zeitmarkensymbol Letzte Aktualisierung: 05 Juli 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/rmig_wbipostupgrade.html
Copyright IBM Corporation 2005, 2010. Alle Rechte vorbehalten.
Dieses Information Center basiert auf Eclipse-Technologie (http://www.eclipse.org).