![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
Befehl "WASPreUpgrade"
Der Befehl WASPreUpgrade für WebSphere Application Server Version 9.0 speichert die Konfiguration einer zuvor installierten Version von WebSphere Application Server in einem migrationsspezifischen Sicherungsverzeichnis.
Position
Die Befehlsdatei befindet sich im Verzeichnis Version 9.0 Stammverzeichnis_des_Anwendungsservers/bin und muss von dort ausgeführt werden.
![[IBM i]](../images/iseries.gif)
Berechtigung
Für die Ausführung dieses Befehlsscript benötigt Ihr Benutzerprofil die Berechtigung *ALLOBJ.
Syntax
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
WASPreUpgrade.sh Sicherungsverzeichnis
aktuelles_WebSphere-Verzeichnis
[-properties Name_der_Eigenschaftendatei]
[-traceString Tracespezifikation [-traceFile Dateiname]]
[-machineChange true | false]
[-oldProfile Profilname]
[-workspaceRoot profile1=Benutzerarbeitsbereichsordner_1;profile2=Benutzerarbeitsbereichsordner_2]
[-username <Benutzername>]
[-password < Kennwort >]
[-javaoption < -Xms...m > -javaoption < -Xmx...m > ]
[-requireEmbeddedDBMigration true | false]
[-keepDmgrEnabled true | false]
![[Windows]](../images/windows.gif)
WASPreUpgrade.bat Sicherungsverzeichnis
aktuelles_WebSphere-Verzeichnis
[-properties Name_der_Eigenschaftendatei]
[-traceString Tracespezifikation [-traceFile Dateiname]]
[-machineChange true | false]
[-oldProfile Profilname]
[-workspaceRoot profile1=Benutzerarbeitsbereichsordner_1;profile2=Benutzerarbeitsbereichsordner_2]
[-username <Benutzername>]
[-password < Kennwort >]
[-javaoption < -Xms...m > -javaoption < -Xmx...m > ]
[-requireEmbeddedDBMigration true | false]
[-keepDmgrEnabled true | false]
![[IBM i]](../images/iseries.gif)
WASPreUpgrade Sicherungsverzeichnis
aktuelles_WebSphere-Verzeichnis
[-properties Name_der_Eigenschaftendatei]
[-traceString Tracespezifikation [-traceFile Dateiname]]
[-workspaceRoot profile1=Benutzerarbeitsbereichsordner_1;profile2=Benutzerarbeitsbereichsordner_2]
[-username <Benutzername>]
[-password < Kennwort >]
[-javaoption < -Xms...m > -javaoption < -Xmx...m > ]
[-requireEmbeddedDBMigration true | false]
[-keepDmgrEnabled true | false]
Parameter
Der Befehl hat die folgenden Parameter:
- Dieser Parameter ist erforderlich und muss zuerst angegeben werden.
Der Wert Sicherungsverzeichnis gibt den Namen des Verzeichnisses an, in dem das Befehlsscript
die gesicherte Konfiguration speichert.
Fehler vermeiden: Die Stammverzeichnisse WAS_INSTALL und USER_INSTALL sind ungültige Verzeichnisse für die Position des WebSphere Application Server-Sicherungsverzeichnisses.gotcha
Dies ist auch das Verzeichnis, aus dem der Befehl WASPostUpgrade die Konfiguration liest.
Wenn das Verzeichnis nicht vorhanden ist, wird es vom Befehlsscript WASPreUpgrade erstellt.
- Dieser Parameter ist erforderlich und muss als zweiter angegeben werden.
Dies kann jede Edition von WebSphere Application Server
Version 7.0 oder höher
sein, für die die Migration unterstützt wird.
Der Wert aktuelles_WebSphere-Verzeichnis gibt den Namen des Installationsstammverzeichnisses für die Quelleninstallation von WebSphere Application Server an.
Der Wert aktuelles_WebSphere-Verzeichnis gibt den Namen des Instanz- oder Profilstammverzeichnisses für das Quellenprofil der Instanz von WebSphere Application Server Version 7.0 oder höher an, das migriert werden soll.
Dieser Parameter ist optional. Der Wert Name_der_Eigenschaftendatei gibt den Pfad zu einer Eigenschaftendatei mit Parametereigenschaften an, die die Operationsweise von Migrationstools wie WASPreUpgrade 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 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 die Parameter -traceString und -traceFile nicht angeben, erstellt der Befehl standardmäßig eine Tracedatei im Verzeichnis Sicherungsverzeichnis/logs.
Dieser optionale Parameter wird für eine betriebssystem- und maschinenübergreifende Migration verwendet. Wenn Sie "true" für diesen Parameter angeben, wird eine Änderung der physischen Hardware bei der Migration unterstützt, indem die Elemente gesichert werden, die sich außerhalb der Installation bzw. der Profilordnerhierarchie von WebSphere Application Server befinden. Wenn Sie "false" für diesen Parameter angeben, werden nur die im Installationsordner bzw. in den Profilordnern von WebSphere Application Server gespeicherten Dateien während der Migration in das Sicherungsverzeichnis kopiert.
Die Standardeinstellung ist "false".
Wenn dieser Parameter den Wert "false" hat, geht der Migrationsprozess davon aus, dass sich die neue und die alte Installation von WebSphere Application Server auf derselben physischen Maschine befinden und beide auf dasselbe Dateisystem zugreifen. Daher sind alle Dateien außerhalb der WebSphere-Verzeichnisse öffentlich und und können gemeinsam genutzt werden. Der Migrationsprozess kopiert Dateien, die sich außerhalb der Struktur von WebSphere Application Server befinden, nicht in das Sicherungsverzeichnis, wenn "-machineChange" auf "false" gesetzt ist.
Wenn Sie den Migrationsassistenten verwenden, ist "false" die einzige zulässige Option. Wenn Sie "-machineChange=false" auswählen, müssen Sie den Befehl WASPostUpgrade auf derselben physischen Maschine ausführen.
Wenn Sie beabsichtigen, den Befehl WASPostUpgrade auf einer anderen Maschine oder in einem anderen Dateisystem auszuführen, müssen Sie den Befehl WASPreUpgrade mit der Option "-machineChange=true" absetzen. Mit der Option "-machineChange=true" erstellt der Migrationsprozess ein zusätzliches Unterverzeichnis (/migrated/) im Migrationssicherungsverzeichnis, das alle Dateien enthält, die von der Konfiguration von WebSphere Application Server referenziert werden und sich außerhalb der Produkt- bzw. Profilverzeichnisse befinden. Wenn Sie den Befehl WASPostUpgrade ausführen, werden diese Dateien auf der neuen Maschine in ihre ursprünglichen Pfade zurückgestellt.
Leistungsaspekte:Wenn Sie die Migration mit SIBs (Service Integration Bus) durchführen, die mit dateispeicherbasierten Dateisystemrepositorys konfiguriert sind, benötigen Sie möglicherweise zusätzlichen Speicherplatz im Migrations-Heap-Speicher und im Migrationssicherungsverzeichnis. Jeder Bus hat drei Dateispeicherwerte: ein Protokoll, einen temporären Speicherplatz und ein Repository. Diese drei Dateien variieren zwar in der Größe, sind aber jeweils auf maximal 100-500 MB beschränkt. Während der Durchführung der Migration werden im Upgrade-vorbereitenden Prozess (Pre-Upgrade) alle Dateispeicher gesichert, die sich in der Struktur von WebSphere Application Server befinden. Dazu muss ausreichend Speicherplatz im Dateisystem verfügbar sein. Wenn der upgradenachbereitende Prozess (Post-Upgrade) feststellt, dass bereits Dateispeicher an der Zielposition vorhanden sind, sichert der Migrationsprozess die Dateispeicher im Hauptspeicher, um ein Rollback möglich zu machen.
Wenn Sie den Befehl WASPreUpgrade mit "-machineChange=true" ausführen, was bewirkt, dass ein Sicherungsverzeichnis erstellt wird, das die gemeinsam genutzten Dateispeicherobjekte enthält, stellen Sie möglicherweise fest, dass im Upgrade-nachbereitenden Prozess Ausnahmen wegen abnormaler Speicherbedingungen eintreten, weil der maximal zulässige Standard-Heap-Speicher nicht ausreicht, um die Dateispeichersicherungen für ein potenzielles Rollback aufzunehmen. Führen Sie eine der folgenden Tasks aus, um dieses Problem zu beheben:Dieser optionale Parameter wird für die Migration einer bestimmten Instanz oder eines bestimmten Profils aus einer früheren Version von WebSphere Application Server verwendet.
- Dieser Parameter ist optional. Der Wert Benutzerarbeitsbereichsordner_x gibt die Position der angepassten Einstellungen für "Eigene Tasks" in der Administrationskonsole für ein oder mehrere Profile an.
- Dieser Parameter ist optional. Der Wert Benutzername gibt den Namen des Benutzers mit Verwaltungsaufgaben
für die aktuelle Installation von WebSphere Application Server
an. Dieser Parameter ist erforderlich, wenn die folgenden Bedingungen zutreffen:
- Sie migrieren einen Deployment Manager.
- Die Verwaltungssicherheit oder globale Sicherheit ist in der Quelleninstallation aktiviert.
- Die Installation von WebSphere Application Server, von der Sie migrieren, hat Version 8.0 oder höher.
- Dieser Parameter ist optional. Der Wert Kennwort gibt das
Verwaltungskennwort der aktuellen Installation von
WebSphere Application Server an. Dieser Parameter ist erforderlich, wenn die folgenden Bedingungen zutreffen:
- Sie migrieren einen Deployment Manager.
- Die Verwaltungssicherheit oder globale Sicherheit ist in der Quelleninstallation aktiviert.
- Die Installation von WebSphere Application Server, von der Sie migrieren, hat Version 8.0 oder höher.
- Dieser Parameter ist optional. Verwenden Sie diesen Parameter, um die Hauptspeichergröße für den im Befehl WASPreUpgrade
verwendeten Java™-Heapspeicher
anzugeben.
Der Wert "-Xms...m" ist der Parameter, mit dem die Anfangsgröße des Heapspeichers angegeben wird. Ersetzen Sie "..." durch die Größe in Megabyte, die verwendet werden soll. 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" ist der Parameter, mit dem die maximale Größe des Heapspeichers angegeben wird. Ersetzen Sie "..." durch die Größe in Megabyte, die verwendet werden soll. 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
- Das ist ein optionaler Parameter für das Migrieren integrierter Datenbanken.
Wenn der Wert "true" angegeben ist, führt jede Ausnahme, die beim Migrieren der integrierten Datenbanken eintritt, dazu, dass der Befehl WASPreUpgrade fehlschlägt. Wenn der Wert "false" angegeben ist, wird jede Ausnahme, die beim Migrieren der integrierten Datenbanken eintritt, in der Tracedatei protokolliert, und der Befehl WASPreUpgrade wird weiter ausgeführt.
Die Standardeinstellung ist "true".
- Das ist ein optionaler Parameter, der für das Migrieren eines Deployment-Manager-Profils von Version 8.0 verwendet wird.
Wenn WASPreUpgrade ausgeführt wird, werden Deployment-Manager-Profile der Version 8.0 gestoppt. Standardmäßig bleibt der Deployment Manager gestoppt. Wenn der Wert "true" angegeben ist, startet der Befehl WASPreUpgrade den Deployment Manager, bevor die Befehlsausführung abgeschlossen ist.
Der Standardwert ist "false".
Protokollierung
Das Tool WASPreUpgrade gibt während seiner Ausführung Statusinformationen am Bildschirm aus. Außerdem speichert das Tool ausführlichere Protokolldaten in der Datei WASPreUpgrade.Zeitmarke.log im Sicherungsverzeichnis. Sicherungsverzeichnis steht für den für den Parameter "Sicherungsverzeichnis" angegebenen Wert. Sie können die Datei WASPreUpgrade.Zeitmarke.log in einem Texteditor anzeigen.
Migrierte Ressourcen
WASPreUpgrade sichert alle Ressourcen, migriert aber keine Entitäten in Ihrem Verzeichnis classes.