Befehl "WASPostUpgrade"
Der Befehl WASPostUpgrade für WebSphere Application Server ruft die gespeicherte Konfiguration ab, die vom Befehl WASPreUpgrade in dem von Ihnen angegebenen Sicherungsverzeichnis erstellt wurde. Das Script WASPostUpgrade für WebSphere Application Server liest die Konfiguration aus diesem Verzeichnis, um die Migration auf WebSphere Application Server Version 9.0 durchzuführen, und fügt alle migrierten Anwendungen im Verzeichnis Stammverzeichnis_des_Anwendungsservers/installedApps für die Installation von Version 9.0 hinzu.
Position

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.
sptcfgDie Befehlsdatei befindet sich im Verzeichnis Stammverzeichnis_des_Anwendungsservers/bin und muss von dort ausgeführt werden.
Syntax
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
WASPostUpgrade.sh Sicherungsverzeichnis
[-properties Name_der_Eigenschaftendatei]
[-username Benutzer-ID]
[-password Kennwort]
[-oldProfile Profilname]
[-profileName Profilname]
[-setPorts useOld | generateNew | Anfangsportnummer]
[-resolvePortConflicts incrementCurrent | Anfangsportnummer]
[-backupConfig true | false]
[-includeApps true | false | script]
[-clone true | false]
[-newDmgrHostname Hostname]
[[-newDmgrSoapPort Portnummer] | [-newDmgrRmiPort Portnummer]]
[-keepDmgrEnabled true | false]
[-requestTimeout Sekunden]
[-javaoption -Xms...m -javaoption -Xmx...m]
[[-appInstallDirectory benutzerdefiniertes_Verzeichnis] | [-keepAppDirectory true | false]]
[-traceString Tracespezifikation [-traceFile Dateiname]]
![[Windows]](../images/windows.gif)
WASPostUpgrade.bat Sicherungsverzeichnis
[-properties Name_der_Eigenschaftendatei]
[-username Benutzer-ID]
[-password Kennwort]
[-oldProfile Profilname]
[-profileName Profilname]
[-setPorts useOld | generateNew | Anfangsportnummer]
[-resolvePortConflicts incrementCurrent | Anfangsportnummer]
[-backupConfig true | false]
[-includeApps true | false | script]
[-clone true | false]
[-newDmgrHostname Hostname]
[[-newDmgrSoapPort Portnummer] | [-newDmgrRmiPort Portnummer]]
[-keepDmgrEnabled true | false]
[-requestTimeout Sekunden]
[-javaoption -Xms...m -javaoption -Xmx...m]
[[-appInstallDirectory benutzerdefiniertes_Verzeichnis] | [-keepAppDirectory true | false]]
[-traceString Tracespezifikation [-traceFile Dateiname]]
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
WASPostUpgrade.sh Sicherungsverzeichnis
[-oldAdminAgentProfilePath Pfad zum alten Verwaltungsagenten]
[-oldAdminAgentSoapPort SOAP-Port des alten Verwaltungsagenten]
[-oldAdminAgentHostname Hostname des alten Verwaltungsagenten, standardmäßig localhost ]
[-oldAdminAgentUsername Anmeldename für den alten Verwaltungsagenten, wenn die Verwaltungssicherheit aktiviert ist ]
[-oldAdminAgentPassword Anmeldekennwort für den alten Verwaltungsagenten, wenn die Verwaltungssicherheit aktiviert ist ]
[-newAdminAgentProfilePath Pfad zum neuen Verwaltungsagenten]
[-newAdminAgentSoapPort SOAP-Port des neuen Verwaltungsagenten ]
[-newAdminAgentHostname Hostname des neuen Verwaltungsagenten, standardmäßig localhost ]
[-newAdminAgentUsername Anmeldename für den neuen Verwaltungsagenten, wenn die Verwaltungssicherheit aktiviert ist ]
[-newAdminAgentPassword Anmeldekennwort für den neuen Verwaltungsagenten, wenn die Verwaltungssicherheit aktiviert ist ]
![[Windows]](../images/windows.gif)
WASPostUpgrade.bat Sicherungsverzeichnis
[-oldAdminAgentProfilePath Pfad zum alten Verwaltungsagenten]
[-oldAdminAgentSoapPort SOAP-Port des alten Verwaltungsagenten]
[-oldAdminAgentHostname Hostname des alten Verwaltungsagenten, standardmäßig localhost ]
[-oldAdminAgentUsername Anmeldename für den alten Verwaltungsagenten, wenn die Verwaltungssicherheit aktiviert ist ]
[-oldAdminAgentPassword Anmeldekennwort für den alten Verwaltungsagenten, wenn die Verwaltungssicherheit aktiviert ist ]
[-newAdminAgentProfilePath Pfad zum neuen Verwaltungsagenten]
[-newAdminAgentSoapPort SOAP-Port des neuen Verwaltungsagenten ]
[-newAdminAgentHostname Hostname des neuen Verwaltungsagenten, standardmäßig localhost ]
[-newAdminAgentUsername Anmeldename für den neuen Verwaltungsagenten, wenn die Verwaltungssicherheit aktiviert ist ]
[-newAdminAgentPassword Anmeldekennwort für den neuen Verwaltungsagenten, wenn die Verwaltungssicherheit aktiviert ist ]
Parameter
Der Befehl hat die folgenden Parameter:
- Dies ist ein erforderlicher Parameter. Der Wert Sicherungsverzeichnis gibt den Namen des Verzeichnisses an, in dem das Tool WASPreUpgrade die gesicherte Konfiguration speichert und aus dem das Tool WASPostUpgrade die Konfiguration und die Dateien liest.
- Dieser Parameter ist optional. Der Wert für den Platzhalter Name_der_Eigenschaftendatei gibt den Pfad zu einer Eigenschaftendatei mit Parametereigenschaften an,
die die Operationsweise von Migrationstools wie WASPostUpgrade definieren.
Sie können Parametereigenschaften in der Migrationseigenschaftendatei definieren, anstatt den Großteil der optionalen Parameter in der Befehlszeile anzugeben. Wenn Parameter in der Eigenschaftendatei definiert und in der Befehlszeile angegeben sind, haben die in der Befehlszeile angegebenen Parameter Vorrang.
Anmerkung: Bestimmte Parameter können nicht in der Eigenschaftendatei angegeben werden, z. B. der Parameter -properties selbst und die Parameter -username und -password. Eine Liste der Parameter, die nicht als Eigenschaft definiert werden können, finden Sie in der Schablonendatei migration.properties im Verzeichnis Stammverzeichnis_des_Anwendungsservers/bin. - Dieser Parameter ist optional. Der Wert für den Platzhalter Benutzer-ID gibt den Namen des Benutzers mit Verwaltungsaufgaben
für die aktuelle Installation von WebSphere Application Server Version 7.0 oder höher
an. Dieser Parameter ist erforderlich, wenn die folgenden Bedingungen zutreffen:
- Dieser Parameter ist optional. Der Wert für den Platzhalter Kennwort gibt das Kennwort des Benutzers mit Verwaltungsaufgaben
für die aktuelle Installation von WebSphere Application Server Version 7.0 oder höher an. Dieser Parameter ist erforderlich, wenn die folgenden Bedingungen zutreffen:Tipp: Wenn Sie im Migrationsassistenten ein Kennwort angeben müssen oder wenn Sie den Befehl WASPostUpgrade mit dem Parameter "-password" in der Befehlszeile verwenden, können Sie das Kennwort in Klartext eingeben oder den xor-verschlüsselten Wert verwenden. Wenn Sie den xor-verschlüsselten Wert verwenden möchten, geben Sie den vollständigen Chiffrierwert, einschließlich des Präfixes {xor} als Wert für den Parameter an. Dieser xor-verschlüsselte Wert kann in jeder Konfigurationsdatei von WebSphere Application Server für die frühere Konfiguration angegeben werden, einschließlich der Dateien soap.client.props, ssl.client.props und security.xml.Tipp: Wenn Sie den Befehl WASPostUpgrade mit dem Parameter "-password" in der Befehlszeile verwenden, können Sie das Kennwort in Klartext eingeben oder den xor-verschlüsselten Wert verwenden. Wenn Sie den xor-verschlüsselten Wert verwenden möchten, geben Sie den vollständigen Chiffrierwert, einschließlich des Präfixes {xor} als Wert für den Parameter an. Dieser xor-verschlüsselte Wert kann in jeder Konfigurationsdatei von WebSphere Application Server für die frühere Konfiguration angegeben werden, einschließlich der Dateien soap.client.props, ssl.client.props und security.xml.
- Dieser optionale Parameter wird für die Migration von Instanzen oder Profilen von früheren Versionen von
WebSphere Application Server
verwendet. Die Instanz bzw. das Profil muss bereits im Sicherungsverzeichnis für die Migration vorhanden sein, bevor Sie diesen
Befehl ausführen.
Wenn Sie den Parameter "-oldProfile" nicht angeben, wird das Standardprofil verwendet. Sollte kein Standardprofil vorhanden sein, meldet das System einen Fehler.
Fehler vermeiden: Wenn Sie zusammen mit "-oldProfile" keinen bestimmten Profilnamen angeben, wird das Profil migriert, das als Standardprofil bekannt ist. Möglicherweise müssen Sie jedes Profil in der Sicherung, die Sie vor der Migration erstellt haben, mit dem Befehl WASPostUpgrade, der nach der Migration ausgeführt wird, migrieren. Dabei müssen Sie die Parameter "-oldProfile" und "-profileName" für jedes einzelne Profil, das der Client in der neuen Umgebung mit Version 9.0 benötigt, angeben. Enthält das alte Profil zusätzlich zu den installierten Anwendungen (installedApps) Beispielanwendungen und Systemanwendungen, werden diese Anwendungen vom Migrationsprozess automatisch migriert. gotcha
- Dieser optionale Parameter wird für die Migration auf bestimmte Profile in WebSphere Application Server
Version 9.0 verwendet. Der Wert Profilname gibt den Namen des Profils von
Version 9.0 an, auf das das Script Ihre Konfiguration migriert.
Das Profil muss vor dem Aufruf
von WASPostUpgrade bereits erstellt worden sein. Falls Sie den Parameter "-profileName" nicht abgeben, wird das Standardprofil verwendet. Sollte kein Standardprofil vorhanden sein, meldet das System einen Fehler.
Fehler vermeiden: Wenn Sie mit dem Parameter "-profileName" keinen bestimmten Profilnamen angeben, wird das Profil migriert, das als Standardprofil bekannt ist. Möglicherweise müssen Sie jedes Profil in der Sicherung, die Sie vor der Migration erstellt haben, mit dem Befehl WASPostUpgrade, der nach der Migration ausgeführt wird, migrieren. Dabei müssen Sie die Parameter "-oldProfile" und "-profileName" für jedes einzelne Profil, das der Client in der neuen Umgebung benötigt, angeben. Enthält das alte Profil zusätzlich zu den installierten Anwendungen (installedApps) Beispielanwendungen und Systemanwendungen, werden diese Anwendungen vom Migrationsprozess automatisch migriert. gotcha
Anmerkung: Bei der Migration eines eigenständigen Anwendungsservers auf Version 9.0 können Sie einen eigenständigen Anwendungsserverknoten auswählen, der bereits bei einem Verwaltungsagenten als Migrationsziel registriert ist. - Mit diesem optionalen Parameter wird angegeben, ob die vorhandene Konfiguration von WebSphere Application Server Version 9.0
gesichert werden soll, bevor Änderungen durch das Tool
WASPostUpgrade vorgenommen werden. Die Standardeinstellung ist "true", d. h.
der Befehl backupConfig wird verwendet, um eine Kopie der aktuellen Konfiguration im Verzeichnis
Profilname/temp zu sichern.
Mit dem Befehl restoreConfig können Sie diese Konfiguration bei Bedarf wiederherstellen. Nähere Informationen finden Sie im Artikel Befehl "restoreConfig".
- Dieser Parameter ist optional und gibt an, wie Ports für das neue Profil festgelegt werden sollen. Für den Parameter
können die folgenden Werte angegeben werden:
Wenn Sie für diesen Parameter einen Wert angeben, werden alle neuen zugeordneten Ports auf der Basis dieses Wertes definiert. Jedes Mal, wenn ein neuer Portwert erforderlich ist, wird der Port auf der Basis dieses Werts erstellt und der Basiswert für die nächste Verwendung um eins erhöht. Es werden keine doppelten Portwerte zugeordnet.
- Mit diesem optionalen Parameter wird angegeben, wie die Portwerte zugeordnet werden sollen. Wenn ein Port nicht verwendet werden kann,
wird sein Wert so lange ausgehend von einem Ausgangswert erhöht, bis ein verfügbarer Port gefunden wird.
- Sie können in die Migration
Geschäftsanwendungen, Assets und Kompositionseinheiten einbeziehen.
Diese können wahlweise mit dem Parameter
"-IncludeApps" des Befehls WASPostUpgrade migriert werden. Dieser optionale Parameter kann auf die folgenden Werte gesetzt werden:
Systemanwendungen von WebSphere Application Server werden unabhängig vom Wert dieses Parameters migriert.
- Dieser Parameter ist optional und gibt an, ob eine Klonmigration durchgeführt werden soll, d. h. ob das Quellenprofil nach der Migration auf die Umgebung mit
Version 9.0 weiterhin verwendet werden kann. Die Standardeinstellung ist "false".
Wenn für den Parameter -clone der Wert "true" angegeben wird, können Sie -setPorts useold nicht angeben. Die neue Profilkonfiguration muss eindeutige Portnummern verwenden, sodass es bei den jetzt koexistierenden neuen und alten Konfigurationen nicht zu Portkonflikten kommt.
Wenn Sie einen Deployment Manager klonen, müssen Sie die zugehörigen eingebundenen Knoten ebenfalls klonen. Sie können eingebundene Knoten nicht klonen, wenn der Deployment Manager nicht geklont wird. Für Klonmigrationen von eingebundenen Knoten müssen Sie den neuen Hostnamen und den SOAP-Port oder den RMI-Port des Knotens mit den folgenden Parametern festlegen:- -newDmgrHostname
- Der Hostname des Deployment Manager von Version 9.0.
- -newDmgrSoapPort
- Der SOAP-Port (Simple Object Access Protocol) des Deployment Manager von Version 9.0.
- -newDmgrRmiPort
- Der RMI-Port (Remote Method Invocation) des Deployment Manager von Version 9.0.
- Mit diesem optionalen Parameter wird angegeben, ob der vorhandene Deployment Manager von WebSphere Application Server
Version 7.0 oder höher
inaktiviert werden soll. Der Standardwert ist "false", es sei denn, der Parameter -clone hat den Wert "true".
In diesem Falls hat -keepDmgrEnabled
ebenfalls den Wert "true".
Wenn Sie diesen Parameter auf "true" setzen, können Sie den vorhandenen Deployment Manager von Version 7.0 oder höher weiter verwenden, während die Migration durchgeführt wird. Dieser Parameter ist nur gültig, wenn Sie einen Deployment Manager migrieren. Bei allen anderen Migrationen wird er ignoriert.
Vorsicht: Verwenden Sie diesen Parameter mit Vorsicht. - Mit diesem optionalen Parameter wird angegeben, ob alle Anwendungen
in den Verzeichnissen installiert werden sollen, in denen sie sich momentan befinden.
Die Standardeinstellung ist "false".
Wenn Sie diesen Parameter auf "true" setzen, behalten die Anwendungen ihre Position bei.
Wenn Sie diesen Parameter angeben, dürfen Sie den Parameter -appInstallDirectory nicht angeben.
Einschränkungen: Wenn Sie diesen Parameter auf "true" setzen, wird das Verzeichnis von der vorhandenen Installation von WebSphere Application Server Version 7.0 oder höher und der Installation von Version 9.0 gemeinsam genutzt. Die folgenden Einschränkungen gelten, wenn die migrierten Anwendungen in denselben Verzeichnissen belassen werden: - Mit diesem optionalen Parameter wird der Verzeichnisname angegeben, der bei der Installation aller Anwendungen während der Migration verwendet werden soll.
Es wird die Standardeinstellung Profilname\installedApps verwendet, wenn dieser Parameter nicht angegeben ist.
Wenn Sie diesen Parameter angeben, dürfen Sie den Parameter "-keepAppDirectory" nicht angeben.
Der Verzeichnisname muss in Anführungszeichen eingeschlossen werden, wenn er Leerzeichen enthält.
Wenn Sie diesen Parameter verwenden, untersuchen die Migrationstools die knotenbezogenen Variablen für den zu migrierenden Knoten im Sicherungsverzeichnis (Variablen für das alte Release) und im Zielprofil (Variablen aus dem neuen Release). Wenn der Pfad zu einer der folgenden Variablen in einem der beiden Releases gehört, verkürzen die Tools die Pfadinformationen und verwenden die zugehörige Variable:
Beispiel:MIGR0341W: Das Anwendungsinstallationsverzeichnis wurde in {0} aktualisiert.
oderMIGR0341W: Das Anwendungsinstallationsverzeichnis wurde in ${USER_INSTALL_ROOT}\customAppDirectory aktualisiert.
MIGR0341W: Das Anwendungsinstallationsverzeichnis wurde in ${APP_INSTALL_ROOT}\cellName\customAppDirectory\ aktualisiert.
- Dieser Parameter ist optional. Der für Tracespezifikation angegebene Wert gibt die Traceinformationen an, die Sie erfassen möchten.
Wenn Sie alle Traceinformationen erfassen möchten, geben Sie "*=all=enabled" (mit Anführungszeichen) an.
Wenn Sie den Parameter "-traceString" bzw. "-traceFile" nicht angeben, erstellt der Befehl standardmäßig eine Tracedatei im Verzeichnis Sicherungsverzeichnis/logs.
- Dieser Parameter ist optional. Der für Dateiname angegebene Wert gibt den Namen der Ausgabedatei
für die Traceinformationen an.
Wenn Sie den Parameter "-traceString" bzw. "-traceFile" nicht angeben, erstellt der Befehl standardmäßig eine Tracedatei im Verzeichnis Sicherungsverzeichnis/logs.
- Dieser Parameter ist optional. Der Wert Sekunden legt fest, wie viele
Sekunden lang die Migration wartet, bevor wsadmin-Verbindungsversuche fehlschlagen.
Dieser Wert kann auch als Zeitlimitparameter während der Anwendungsmigration verwendet werden.
- Dieser Parameter ist optional. Der Wert Pfad zum alten Verwaltungsagenten gibt
den Dateisystempfad des Profilverzeichnisses für den ursprünglichen Verwaltungsagenten an.
Dieser Parameter ist nur dann erforderlich, wenn der zu migrierende Anwendungsserver von einem Verwaltungsagenten gesteuert wird.
- Dieser Parameter ist optional. Der Wert SOAP-Port des alten Verwaltungsagenten gibt den SOAP-Port
an, den der ursprüngliche Verwaltungsagent für Verwaltungsverbindungen verwendet.
Dieser Parameter ist nur dann erforderlich, wenn der zu migrierende Anwendungsserver von einem Verwaltungsagenten gesteuert wird.
- Dieser Parameter ist optional. Der Wert Hostname des alten Verwaltungsagenten
gibt die Hostnamensposition des ursprünglichen Verwaltungsagenten an.
Wird dieser
Parameter nicht angegeben, wird standardmäßig der Wert
"localhost" verwendet.
Dieser Parameter ist nur dann erforderlich, wenn der zu migrierende Anwendungsserver von einem Verwaltungsagenten gesteuert wird.
- Dieser Parameter ist optional. Der Wert Anmeldename für den alten Verwaltungsagenten
gibt den Benutzernamen für den ursprünglichen Verwaltungsagenten an.
Dieser Parameter ist nur dann erforderlich, wenn der zu migrierende Anwendungsserver von einem Verwaltungsagenten mit aktivierter Verwaltungssicherheit gesteuert wird.
- Dieser Parameter ist optional. Der Wert Pfad zum neuen Verwaltungsagenten gibt
den Dateisystempfad des Profilverzeichnisses für den neu migrierten Verwaltungsagenten an.
Dieser Parameter ist nur dann erforderlich, wenn der zu migrierende Anwendungsserver von einem Verwaltungsagenten gesteuert wird.
- Dieser Parameter ist optional. Der Wert SOAP-Port des neuen Verwaltungsagenten gibt den SOAP-Port
an, den der neu migrierte Verwaltungsagent für Verwaltungsverbindungen verwendet.
Dieser Parameter ist nur dann erforderlich, wenn der zu migrierende Anwendungsserver von einem Verwaltungsagenten gesteuert wird.
- Dieser Parameter ist optional. Der Wert Hostname des neuen Verwaltungsagenten
gibt die Hostnamensposition des neuen Verwaltungsagenten an.
Wird dieser
Parameter nicht angegeben, wird standardmäßig der Wert
"localhost" verwendet.
Dieser Parameter ist nur dann erforderlich, wenn der zu migrierende Anwendungsserver von einem Verwaltungsagenten gesteuert wird.
- Dieser Parameter ist optional. Der Wert Anmeldename für den neuen Verwaltungsagenten
gibt den Benutzernamen für den neuen Verwaltungsagenten an.
Dieser Parameter ist nur dann erforderlich, wenn der zu migrierende Anwendungsserver von einem Verwaltungsagenten mit aktivierter Verwaltungssicherheit gesteuert wird.
- Dieser Parameter ist optional. Der Wert Anmeldekennwort für den neuen Verwaltungsagenten
gibt das Kennwort für den neuen Verwaltungsagenten an.
Dieser Parameter ist nur dann erforderlich, wenn der zu migrierende Anwendungsserver von einem Verwaltungsagenten mit aktivierter Verwaltungssicherheit gesteuert wird.
- Dieser Parameter ist optional. Verwenden Sie diesen Parameter, um die Speicherkapazität des
von WASPostUpgrade verwendeten Java-Heapspeichers festzulegen.
Der Wert "-Xms...m" gibt die Anfangsgröße des Heapspeichers an. Ersetzen Sie "..." durch die benötigte Größe in Megabyte. Wenn Sie z. B. eine Anfangsgröße des Heapspeichers von 128 MB festlegen möchten, geben Sie den Parameter wie folgt an: -javaoption -Xms128m
Der Wert "-Xmx...m" gibt die maximale Größe des Heapspeicherss an. Ersetzen Sie "..." durch die benötigte Größe in Megabyte. Wenn Sie z. B. eine maximale Größe des Heapspeichers von 1024 MB festlegen möchten, geben sie den Parameter wie folgt an: -javaoption -Xmx1024m
Protokollierung
Das Tool WASPostUpgrade gibt während seiner Ausführung Statusinformationen am Bildschirm aus. Außerdem speichert das Tool ausführlichere Protokolldaten in der Datei WASPostUpgrade.Zeitmarke.log im Verzeichnis Sicherungsverzeichnis/logs. Sie können die Datei WASPostUpgrade.Zeitmarke.log in einem Texteditor anzeigen.
Sicherheitsaspekte
Vor der Migration muss auf dem Zielsystem die Sicherheit inaktiviert werden. Wenn Sie eine Migration von einer Quellenkonfiguration durchführen, in der die Sicherheit aktiviert ist, aktiviert der Befehl WASPostUpgrade während der Migration automatisch die Sicherheit für die Zielkonfiguration der Version 9.0.