Konfigurationsvariablen für die Migration eines eingebundenen Knotens mit z/OS Migration Management Tool
Bevor Sie einen Knoten mit WebSphere Application Server for z/OS auf Version 9.0 migrieren, müssen Sie JCL-Jobs (CNTL- und DATA-Dateien) erstellen, die während der eigentlichen Migration unter z/OS ausgeführt werden. Mit z/OS Migration Management Tool können Sie eine Migrationsdefinition erstellen und die entsprechenden Migrationsjobs hochladen. z/OS Migration Management Tool stellt eine Reihe von Konfigurationsvariablen bereit, wenn Sie eine Definition für die Migration eines eingebundenen Knotens erstellen.

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.
sptcfgAuswahl des Migrationsknotentyps
- Der Typ des zu migrierenden Knotens mit WebSphere Application Server.
Name der Migrationsdefinition
In diesem Abschnitt werden der Name und der Verzeichnispfad der Migrationsdefinition für die Stapeljobs und Anweisungen angegeben, die für die Migration eines Knotens mit WebSphere Application Server for z/OS verwendet werden.- Der Name der z/OS-Migrationsdefinition.
Dieser Name wird ausschließlich auf der Workstation verwendet, um die Migrationsjobs und Anweisungen anzugeben, die generiert werden. Der ausgewählte Name hat keine Auswirkung auf die Konfiguration von WebSphere Application Server for z/OS.
- Der vollständige Pfadname einer Antwortdatei, die Standardwerte enthält, die im Tool vorab geladen werden sollen.
Bei jeder Erstellung einer z/OS-Migrationsdefinition wird eine Antwortdatei geschrieben. Sie enthält alle variablen Daten, die zum Erstellen der Migrationsdefinition verwendet wurden, und sie kann verwendet werden, um die Standardwerte vorab zu laden, wenn eine ähnliche Migrationsdefinition definiert wird. Die Antwortdatei für eine bestimmte Migrationsdefinition wird in die Datei Name_der_Migrationsdefinition.responseFile im Stammverzeichnis für die Migrationsdefinition geschrieben.
Normalerweise müssen Sie eine Antwortdatei aus einer Migrationsdefinition angeben, die denselben Typ hat wie die Definition, die Sie erstellen möchten.
Anmerkung: Eine Kopie der Antwortdatei ist in der .DATA-Datei in der Migrationsdefinition, die Sie in ein z/OS-Zielsystem hochladen, enthalten. Diese Antwortdatei wird im z/OS-System nicht verwendet, ist aber zu Referenzzwecken enthalten. Der Teildateiname der Datei ist ZMMTFED.
Zieldateien
- Übergeordnetes Qualifikationsmerkmal für die z/OS-Zieldateien,
die die generierten Jobs und Anweisungen enthalten. Wenn eine z/OS-Migrationsdefinition in das z/OS-Zielsystem hochgeladen wird, werden die Migrationsjobs und -dateien in ein Paar partitionierter Dateien geschrieben. Diese Dateien können zwar wiederverwendet werden, es ist jedoch am sichersten, separate Dateien für jedes zu migrierende z/OS-System zu erstellen.Anmerkung: Als übergeordnetes HLQ für die Datei kann ein mehrstufiges HLQ angegeben werden.
Dateinamen und Produktverzeichnis
- Eine vorhandene Prozedurenbibliothek, in die die katalogisierten Prozeduren von WebSphere Application Server for z/OS kopiert werden.
- Position des Produktdateisystems Ihrer Installation von WebSphere Application Server Version 9.0
- Wählen Sie diese Option aus, um einen temporären symbolischen
Link einzurichten, und geben Sie bei Auswahl dieses Links den Pfadnamen an.
Wenn Sie einen temporären symbolischen Link angeben, werden symbolische Links vom Konfigurationsdateisystem zum temporären symbolischen Link erstellt. Andernfalls werden sie direkt zum Produktdateisystem erstellt.
Wenn Sie diese Option auswählen, können Sie den Pfadnamen eines temporären symbolischen Links angeben. Dieser Link wird von den Anpassungsjobs erstellt und verweist auf das Dateisystemverzeichnis des Produkts.- Pfadname des temporären symbolischen Links
Konfigurationsdateisystem
Im Konfigurationsdateisystem ist die Konfiguration für den zu migrierenden Knoten physisch gespeichert. Sie können ein vorhandenes Dateisystem von Version 9.0 verwenden, wenn bereits ein entsprechendes Dateisystem auf dem zu migrierenden Knoten vorhanden ist. Wenn Sie ein vorhandenes Dateisystem von Version 9.0 verwenden, müssen Sie sicherstellen, dass der Mountpunkt, den Sie hier angeben, vorhanden ist, bevor Sie die Migrationsdienstprogramme (BBOWMG1F, BBOWMG2F usw.), die mit diesem Tool erstellt werden, ausführen. Wenn Sie ein neues Dateisystem von Version 9.0 auf dem zu migrierenden Knoten erstellen, findet die eigentliche Erstellung des neuen Dateisystems erst statt, wenn Sie den optionalen Job BBOMMHFS oder BBOMMZFS während des eigentlichen Migrationsprozesses ausführen. In jedem Fall müssen Sie hier den korrekten Wert für den Mountpunkt angeben.
Suchen Sie in den angepassten Anweisungen, die von diesem Tool generiert werden, nach speziellen Informationen zum Festlegen des richtigen Eigners und der richtigen Berechtigungen für den Konfigurationsmountpunkt. Weitere Informationen zum Angeben dieser Variablen finden Sie in den generierten Anweisungen und im Artikel Eingebundenen Knoten unter z/OS migrieren.
- Mountpunkt für das Dateisystemverzeichnis mit Schreib-/Lesezugriff, in das die Anwendungsdaten und Umgebungsdateien geschrieben werden.
Ist dieser Mountpunkt noch nicht vorhanden, wird er vom Migrationsprozess erstellt, wenn Sie den optionalen Job BBOMMHFS oder BBOMMZFS ausführen.
- Dateisystemdatei, die Sie erstellen und über den zuvor genannten Mountpunkt anhängen.
- Geben Sie die Seriennummer des DASD-Datenträgers mit der oben angegebenen
Datei an. Bei Angabe von "*" wählt SMS einen Datenträger aus.
Die Verwendung von "*" setzt voraus, dass SMS-ACS-Routinen (Automatic Class Selection) für die Auswahl des Datenträgers vorhanden sind. Falls SMS nicht für die automatische Zuordnung von Dateien konfiguriert ist, geben Sie den Datenträger explizit an.
- Zuordnung der Anfangsgröße in Zylindern für die Konfigurationsdateisystemdatei.
In einem Anwendungsserver nimmt der für diese Datei erforderliche Gesamtspeicherplatz mit der Größe und Anzahl der installierten Anwendungen zu.
Empfehlung: Die empfohlene Mindestgröße sind 420 Zylinder. - Größe jedes Sekundärbereichs in Zylindern.
Empfehlung: Die empfohlene Mindestgröße sind 100 Zylinder.
- Das Konfigurationsdateisystem wird über HFS zugeordnet und angehängt.
- Das Konfigurationsdateisystem wird über ZFS zugeordnet und angehängt.
Serveranpassung (Teil 1)
- Mountpunkt der Konfiguration, die als Quelle für die Migration verwendet wird.
- Ausgangsverzeichnis der Konfiguration, die als Quelle für die Migration verwendet wird.
- Mountpunkt der Konfiguration, die als Ziel für die Migration verwendet wird.
Diese Einstellung wurde zuvor in der Anzeige Konfigurationsdateisystem vorgenommen.
- Ausgangsverzeichnis der Konfiguration, die als Ziel für die Migration verwendet wird.
- Mountpunkt der Konfiguration, die als Ziel für die Migration verwendet wird.
- Name der JCL-Startprozedur, die zum Starten des migrierten Dämons verwendet wird.
Wenn Sie eine Migration auf Version 9.0 durchführen, müssen Sie Ihre JCL-Startprozeduren aktualisieren. Während der Migration wird automatisch eine neue Startprozedur generiert. Sie können einen neuen Namen für die Dämonprozedur angeben oder den alten Namen verwenden.
- Name der JCL-Startprozedur, die zum Starten der migrierten Controller verwendet wird.
Wenn Sie eine Migration auf Version 9.0 durchführen, müssen Sie Ihre JCL-Startprozeduren aktualisieren. Während der Migration wird automatisch eine neue Startprozedur generiert. Sie können einen neuen Namen für die Controllerprozedur angeben oder den alten Namen verwenden.
- Name der JCL-Startprozedur, die zum Starten der migrierten Servants verwendet wird.
Wenn Sie eine Migration auf Version 9.0 durchführen, müssen Sie Ihre JCL-Startprozeduren aktualisieren. Während der Migration wird automatisch eine neue Startprozedur generiert. Sie können einen neuen Namen für die Servantprozedur angeben oder den alten Namen verwenden.
- Name der JCL-Startprozedur, die zum Starten des migrierten Adjuncts verwendet wird.
Wenn Sie eine Migration auf Version 9.0 durchführen, müssen Sie Ihre JCL-Startprozeduren aktualisieren. Während der Migration wird automatisch eine neue Startprozedur generiert. Sie können einen neuen Namen für die Adjunct-Prozedur angeben oder den alten Namen verwenden.
- Wenn Sie neue Namen für Ihre JCL-Prozeduren angegeben haben, müssen die entsprechenden
START-Befehle in der Konfiguration von WebSphere Application Server
an die neuen Prozedurnamen angepasst werden.
Wählen Sie diese Option aus, um diese Konfigurationsaktualisierung durchzuführen.
Wenn Sie sich für die Verwendung der alten Prozedurnamen entscheiden, wählen Sie diese Option nicht aus. Es wird empfohlen, diese Option nicht auszuwählen, wenn Sie keine einheitlichen Prozedurnamen für alle Server eines bestimmten Prozesstyps (z. B. alle Servants) auf dem zu migrierenden Knoten verwenden. In diesem Fall müssen Sie die START-Befehle beibehalten und die Prozeduren manuell mit der Prozedur ersetzen, die während der Migration als Schablone generiert wird.
Anmerkungen: - Der Migrationsprozess erfordert die Verwendung eines Verwaltungsclients. Geben Sie eine gültige WebSphere-Administrator-ID an,
die der Verwaltungsclient für die Authentifizierung verwenden kann.
Sie können die Eingabe einer Benutzer-ID auf einen späteren Zeitpunkt verschieben und die Jobs BBOWMG3F, BBOWMPRO, BBOWMPRE und BBOWMPOS später manuell bearbeiten. Dazu müssen Sie die Variable "TO_AdminUserid" mit der richtigen Benutzer-ID aktualisieren, bevor Sie den Job übergeben.
- Der Migrationsprozess erfordert die Verwendung eines Verwaltungsclients. Geben Sie ein gültiges WebSphere-Administratorkennwort an,
das der Verwaltungsclient für die Authentifizierung verwenden kann.
Sie können die Eingabe eines Kennworts auf einen späteren Zeitpunkt verschieben und die Jobs BBOWMG3F, BBOWMPRO, BBOWMPRE und BBOWMPOS später manuell bearbeiten. Dazu müssen Sie die Variable "TO_AdminPassword" mit dem richtigen Kennwort aktualisieren, bevor Sie den Job übergeben.
Serveranpassung (Teil 2)
- "Eigene Tasks" wird mit dieser Einstellung nur in WebSphere Application Server Version 7.0 oder höher
unterstützt.
- Benutzerdefinierte Position des Arbeitsbereichsstammverzeichnisses
Optionen für den Migrationsprozess
Wenn Sie die Traceerstellung aktivieren, bleibt sie während des gesamten Migrationsprozesses aktiviert.
- Mit dieser Einstellung wird die Traceerstellung für die Erstellung von Ausgangsverzeichnissen, den Aufruf von Profil- und Migrationstools und die Endverarbeitungsphasen der Migration aktiviert bzw. oder inaktiviert.
- Mit dieser Einstellung wird die Traceerstellung für die Profilerstellung aktiviert bzw. inaktiviert.
- Mit dieser Einstellung wird die Traceerstellung für den WASPreUpgrade-Prozess aktiviert bzw. inaktiviert.
- Mit dieser Einstellung wird die Traceerstellung für den WASPostUpgrade-Prozess aktiviert bzw. inaktiviert.
- Der für den JVM-Heapspeicher zugeordnete Anfangsspeicher.
- Die maximale Größe des Heapspeichers, die für den JVM-Heapspeicher zugeordnet werden kann.
- Das Verzeichnis, in das die Sicherung der vorherigen Konfiguration und der Migrationstrace geschrieben werden.
Während der Migration muss eine Sicherungskopie der Konfiguration der vorherigen Version erstellt werden. Die Standardposition für diese Sicherung ist /tmp/migrate. Wenn das Dateisystem /tmp nicht genügend Speicherplatz für die Sicherungskonfiguration hat, können Sie eine andere Position angeben. Wenn Sie das Standardverzeichnis der Sicherungskopie überschreiben möchten, wird empfohlen, die Namenskonvention beizubehalten und lediglich den Abschnitt /tmp durch einen anderen Pfad, z. B. /myTemp/migrate, zu ersetzen.
- Eine Kennung, die zum Erstellen eines Verzeichnisses unter dem temporären Verzeichnis mit den temporären Migrationsdatensätzen und Sicherungskonfigurationsdaten verwendet wird.
- Sie können ein temporäres Java-Verzeichnis angeben, das von der Java Virtual Machine bei der Migration zum Erstellen und Speichern temporärer Dateien verwendet wird.
- Temporäres Java-Verzeichnis festlegen
- Position des temporären Java-Verzeichnisses
Portwerte
Definieren, welche Portwerte im neuen Profil verwendet und wie Portkonflikte gehandhabt werden sollen. Wenn Sie Portwerte des alten Profils wiederverwenden, kann das neue Profil aufgrund von Portkonflikten nicht gleichzeitig mit dem alten Profil ausgeführt werden. Wenn Sie beabsichtigen, beide Profile gleichzeitig auszuführen, vergewissern Sie sich, dass jedes Profil einen anderen Port verwendet.
- Die im Quellenprofil definierten Portwerte wiederverwenden.
- Neue Portwerte ausgehend vom angegebenen Portwert generieren. In Konflikt stehende Ports werden automatisch aufgelöst.
- Auswählen, wie Portkonflikt gelöst werden sollen.
- Wert ausgehend vom Wert des den Konflikt verursachenden Ports erhöhen
- Wenn ein Portkonflikt festgestellt wird, wird der Portwert des den Konflikt verursachenden Ports auf den nächsten verfügbaren Portwert erhöht.
- Wert ausgehend von einem allgemeinen Anfangsportwert erhöhen
- Wenn ein Portkonflikt festgestellt wird, wird der Portwert ab dem angegebenen Wert auf den nächsten verfügbaren Portwert erhöht.
Definition von Jobanweisungen
Für alle Migrationsjobs, die angepasst werden, ist eine Jobanweisung erforderlich.Geben Sie eine gültige Jobanweisung für Ihre Installation ein. Während des Migrationserstellungsprozesses wird der Jobname in allen generierten Jobs automatisch aktualisiert, d. h., Sie müssen sich um diesen Teil der Jobanweisung nicht kümmern. Wenn Fortsetzungszeilen erforderlich sind, ersetzen Sie die Kommentarzeilen durch Fortsetzungszeilen.