Konfigurationsvariablen für die Migration eines Deployment Manager mit z/OS Migration Management Tool
Bevor Sie WebSphere Application Server for z/OS 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 Ihnen eine Reihe von Konfigurationsvariablen bereit, wenn Sie eine Definition für die Migration eines Deployment Manager 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 ZMMTDMGR.
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 HLQ für die Datei kann ein mehrstufiger 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 (BBOMDHFS oder BBOMDZFS, BBOMDCP 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 BBOMDHFS oder BBOMDZFS 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 Migration eines Deployment Manager unter z/OS.
- 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 BBOMDHFS oder BBOMDZFS 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.
- 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 BBOWMG3D, BBOWDPRO, BBOWDPRE und BBOWDPOS 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 BBOWMG3D, BBOWDPRO, BBOWDPRE und BBOWDPOS 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)
- Geben Sie an, ob der frühere Deployment Manager während der Migration inaktiviert werden soll.
Wenn der Quellen-Deployment-Manager nicht inaktiviert ist, können Sie diesen auch nach Abschluss der Migration weiterverwenden.Vorsicht: Verwenden Sie diese Option mit Bedacht. Normalerweise werden Deployment Manager von WebSphere Application Server gestoppt und inaktiviert, um zu verhindern, dass mehrere Deployment Manager dieselben Knoten verwalten. Sie müssen den Quellen-Deployment-Manager stoppen, bevor Sie damit beginnen, den Deployment Manager von Version 9.0 zu verwenden. Wenn Sie diese Option abwählen, werden alle Konfigurationsänderungen, die Sie während der Migration an der alten Konfiguration vorgenommen haben, nicht migriert.
- Diese Einstellung gibt an, wie die installierten Anwendungen migriert werden sollen. Anmerkung: Die Systemanwendungen von WebSphere Application Server werden unabhängig von dem hier definierten Wert migriert.
- Mit dieser Einstellung werden Benutzerunternehmensanwendungen während der Migration im Standardverzeichnis der Anwendungsinstallation installiert.
- Mit dieser Einstellung werden Benutzerunternehmensanwendungen während der Migration in einem angegebenen
Anwendungsinstallationsverzeichnis installiert.
- Position, an der WebSphere Application Server
Ihre Unternehmensanwendungen installiert
Diese Position wird verwendet, wenn Sie in Ihren Einstellungen für die Anwendungsmigration angeben, dass Anwendungen migriert und installiert werden sollen. Sie können eine angepasste umgebungsspezifische Position oder die Standardposition verwenden.
- Position, an der WebSphere Application Server
Ihre Unternehmensanwendungen installiert
- Bereiten Sie die Benutzerunternehmensanwendungen für die Installation im Verzeichnis
installableApps von WebSphere Application Server Version 9.0
vor, ohne sie während der Migration tatsächlich zu installieren.
Im Migrationssicherungsverzeichnis werden Scripts generiert und gespeichert, die Sie später zum Installieren dieser Anwendungen verwenden können. Bei WebSphere Application Server for z/OS ist die Position dieses Sicherungsverzeichnisses relativ zum temporären Verzeichnis, das Sie in derselben Anzeige angeben. Die Position des Sicherungsverzeichnisses wird auch durch die abgeleiteten Migrations-ID und den Typ des migrierten Knotens bestimmt. Wenn Sie beispielsweise /tmp/migrate als temporäres Verzeichnis angeben und die abgeleitete Migrations-ID 55449 lautet, ist die Position der generierten Scripts wie folgt:
Knotentyp steht hier je nach Typ des migrierten Knotens für dmgr, fed oder base./tmp/migrate/55449/Knotentyp_backup/
Sie können diese Dateien jederzeit und in beliebiger Kombination nach Abschluss der Migration ausführen. Sie können diese Dateien bei Bedarf reorganisieren und kombinieren, um eine effizientere Installation der Anwendungen zu erreichen. Weitere Informationen finden Sie im Artikel "Tool 'wsadmin'" in der Dokumentation.
- Mit dieser Einstellung werden Benutzerunternehmensanwendungen im Rahmen der Migration installiert und die Anwendungsinstallationsverzeichnisse der Vorgängerversion übernommen.
Einschränkungen: Wenn Sie diese Option auswählen, wird die Position von der vorhandenen Installation von WebSphere Application Server und der Installation von Version 9.0 gemeinsam genutzt. Die folgenden Einschränkungen gelten, wenn die migrierten Anwendungen in denselben Verzeichnissen belassen werden:
- Mit dieser Einstellung wird die Benutzerunternehmensanwendungen unverändert beibehalten.
- "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.
- In der folgenden Anzeige angepasste Werte für jeden Port im Zielprofil festlegen.
- 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.