Konfigurationsvariablen für die Migration eines Deployment Manager unter z/OS mit dem Befehl "zmmt"
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 ausgeführt werden. Sie können den Befehl zmmt zusammen mit einer Antwortdatei verwenden, um die geeigneten Migrationsjobs zu erstellen. Die Antwortdatei für die Migration enthält eine Reihe von Konfigurationsvariablen, mit denen Sie Jobs für die Migration eines Deployment Manager erstellen können.

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.
sptcfgVariablen der Antwortdatei
- Ein erforderliches Schlüsselwort, das die Erstellung einer neuen Migrationsdefinition angibt.
- Soll ein temporärer symbolischer Link erstellt werden?
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.
- Pfadname des temporären symbolischen Links
Dieser Link wird von den Anpassungsjobs erstellt und verweist auf das Dateisystemverzeichnis des Produkts.
- Pfadname des temporären symbolischen Links
- Der Name des während der Migration erstellten Profils.
Auf der Plattform z/OS ist dies immer "default".
- Vollständig qualifizierter Pfad, in den die generierten Migrationsdefinition geschrieben werden soll.
- SchablonenpfadEiner der folgenden Werte:
- Name der MVS-Datei,
die das Konfigurationsdateisystem enthält.
Dieser Name wird als Eingabe für den Migrationsjob verwendet, der das Konfigurationsdateisystem erstellt.
- Die Anzahl primärer Zylinder, die dem Konfigurationsdateisystem zugeordnet werden.
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. - Die Anzahl sekundärer Zylinder, die dem Konfigurationsdateisystem zugeordnet werden.
Empfehlung: Die empfohlene Mindestgröße sind 100 Zylinder.
- Die Seriennummer des DASD-Datenträgers für die oben angegebene Datei oder
"*", wenn SMS einen Datenträger auswählen soll.
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.
- Mountpunkt für das Dateisystemverzeichnis, in das die Anwendungsdaten und Umgebungsdateien geschrieben werden.
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öchten, müssen Sie sicherstellen, dass der hier angegebene Mountpunkt vorhanden ist, bevor Sie die Migrationsjobs ausführen, die mit diesem Tool erstellt werden. 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.
- DateisystemtypEiner der folgenden Werte:
- HFS
Die Datei für das Konfigurationsdateisystem wird über das hierarchische Dateisystem (Hierarchical File System, HFS) zugeordnet und angehängt.
- ZFS
Die Konfigurationsdateisystemdatei wird mit dem zSeries-Dateisystem zugeordnet und angehängt.
- HFS
- Anpassbare JOB-Anweisungen, die für die generierten Migrationsjobs verwendet werden.
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.
- Übergeordnetes Qualifikationsmerkmal für die z/OS-Zieldateien,
die die generierten Jobs und Anweisungen enthalten. Anmerkung: Als übergeordnetes HLQ für die Datei kann ein mehrstufiges HLQ angegeben werden.
- Die Benutzer-ID eines Administrators, die zum Verwalten des Knotens verwendet wird der migriert wird.
Dies ist erforderlich, um die erforderlichen Verwaltungsaktionen während des Migrationsprozesses auszuführen.
- Das Kennwort für die
Benutzer-ID des Administrators, die zum Verwalten des Knotens verwendet wird der migriert wird.
Dies ist erforderlich, um die erforderlichen Verwaltungsaktionen während des Migrationsprozesses auszuführen.
- Diese Einstellung gibt an, wie die installierten Anwendungen migriert werden sollen. Einer der folgenden Werte:Anmerkung: Die Systemanwendungen von WebSphere Application Server werden unabhängig von dem hier definierten Wert migriert.
- 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 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.
- Legt fest, ob die START-Befehle in der Konfiguration mit den neuen angegebenen Namen
aktualisiert werden sollen (true) oder ob die vorhandenen Namen beibehalten werden sollen (false).
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. Geben Sie für diese Variable "true" an, um diese Konfigurationsaktualisierung auszuführen.
Wenn Sie sich für die Verwendung der vorhandenen Prozedurnamen entscheiden, geben Sie für diese Variable "false" an. Wenn Sie keine einheitlichen Prozedurnamen für alle Server eines bestimmten Prozesstyps (z. B. alle Servants) auf dem zu migrierenden Knoten verwenden, wird empfohlen, für diese Variable "false" anzugeben. 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: - Legt fest, ob
der frühere Deployment Manager während der Migration inaktiviert werden soll (true) oder nicht (false).
Wenn der Deployment Manager von Version 7.0 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 Version 7.0 gestoppt und inaktiviert, um zu verhindern, dass mehrere Deployment Manager dieselben Knoten verwalten. Sie müssen den Deployment Manager von Version 7.0 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.
- Traceerstellung während des WASPostUpgrade-Prozesses aktivieren (true) oder inaktivieren (false).
- Traceerstellung während des WASPreUpgrade-Prozesses aktivieren (true) oder inaktivieren (false).
- Traceerstellung während der Profilerstellung aktivieren (true) oder inaktivieren (false).
- Traceerstellung für die Erstellung von Ausgangsverzeichnissen, den Aufruf von Profil- und Migrationstools und die Endverarbeitungsphasen der Migration aktivieren (true) oder inaktivieren (false).
- Mountpunkt der Konfiguration, die als Quelle für die Migration verwendet wird.
- Ausgangsverzeichnis der Konfiguration, die als Quelle für die Migration verwendet wird.
- Der für den JVM-Heapspeicher zugeordnete Anfangsspeicher.
- Ein temporäres Java-Verzeichnis, das von der Java Virtual Machine bei der Migration zum Erstellen und Speichern temporärer Dateien verwendet wird.
- Die maximale Größe des Heapspeichers, die für den JVM-Heapspeicher zugeordnet werden kann.
- Eine vorhandene Prozedurenbibliothek, in die die katalogisierten Prozeduren von WebSphere Application Server for z/OS kopiert werden.
- Durch Angabe eines der folgenden Werte definieren, wie Portkonflikte gehandhabt werden.
- Durch Angabe eines der folgenden Werte definieren, welche Portwerte im neuen Profil verwendet werden sollen.
- Position des Produktdateisystems Ihrer Installation von WebSphere Application Server Version 9.0
- 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.
- Mountpunkt der Konfiguration, die als Ziel für die Migration verwendet wird.
Dieser Wert entspricht dem Wert, der für die Variable zConfigMountPoint angegeben ist.
- Ausgangsverzeichnis der Konfiguration, die als Ziel für die Migration verwendet wird.
- Gibt an, ob die über die Administrationskonsole angepassten Einstellungen für "Eigene Tasks", die
an der Standardposition des Arbeitsbereichstammverzeichnisses (D) wurden, oder die an einer benutzerdefinierten
Position des Arbeitsbereichsstammverzeichnisses (U) gespeicherten Positionen migriert werden sollen.
- Position des benutzerdefinierten Stammverzeichnisses (Root) des Arbeitsbereichs.
Beispiel einer Antwortdatei für die Migration eines Deployment Manager
create
EnableIntermediateSymlink=false
EnableJavaTmpDir=true
intermediateSymlinkPreference=N
profileName=default
profilePath=<Stammverzeichnis>/profiles/ZMigDmgr01
templatePath=<Stammverzeichnis>/profileTemplates/zos-migDmgr
zConfigHfsName=OMVS.WAS90.CONFIG.HFS
zConfigHfsPrimaryCylinders=420
zConfigHfsSecondaryCylinders=100
zConfigHfsVolume=*
zConfigMountPoint=/wasv9config
zFilesystemType=HFS
zJobStatement1=(ACCTNO,ROOM),'USERID',CLASS=A,REGION=0M
zJobStatement2=//*
zJobStatement3=//*
zJobStatement4=//*
zTargetHLQ=DMR
zmbAdminPassword={xor}BwcHBwcHBwc=
zmbAdminUserid=XXXXXXXX
zmbAppInstallDirLine1=/wasv9config/DeploymentManager/profiles/default/installedApps
zmbAppInstallDirLine2=
zmbAppMigrationPreference=D
zmbControllerProcName=BBO9DCR
zmbDaemonProcName=BBO9DMN
zmbDisableDmgr=true
zmbEnablePostUpgradeTrace=0
zmbEnablePreUpgradeTrace=0
zmbEnableProfileTrace=0
zmbEnableScriptingTrace=0
zmbFromConfigRoot=/WebSphere/V7R0
zmbFromWASHomeDir=DeploymentManager
zmbInitialHeapSize=512
zmbJavaTempDirectory=/tmp
zmbMaxHeapSize=768
zmbProclibName=SYS1.PROCLIB
zmbReplaceStartedProcedureNames=true
zmbResolvePortConflicts=incrementCurrent
zmbSMPEHome=/usr/lpp/WebSphere/AppServer/V9R0
zmbServantProcName=BBO9DSR
zmbSetPorts=useOld
zmbTempDirectory=/tmp/migrate
zmbTimestamp=05171857
zmbToConfigRoot=/wasv9config
zmbToWASHomeDir=DeploymentManager
zmbWorkspaceRootPreference=D