Konfigurationsvariablen für die Migration eines eigenständigen Anwendungsservers 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 eigenständigen Anwendungsservers 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 BBOMBHFS oder BBOMBZFS 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.
- 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.
- 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.
- 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: - 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.
- Standardanwendung installieren, die die Snoop-, Hello- und HitCount-Servlets enthält.
- Angabe, ob Beispielanwendungen implementiert werden sollen. Anmerkung: Diese Anwendungen werden in einer WebSphere Application Server Network Deployment-Zelle nicht unterstützt.
Installierne Sie die Beispielanwendungen, um den Anwendungsserver zu verwenden und die neuesten technischen Fortschritte zu bewerten. Die Beispielanwendungen werden nicht für Anwendungsserverumgebungen für Entwicklungs- oder Produktionszwecke empfohlen.
- Ein temporäres Java-Verzeichnis, das von der Java Virtual Machine bei der Migration zum Erstellen und Speichern temporärer Dateien verwendet wird.
- Angabe, ob das Quellenprofil bei einem Verwaltungsagenten registriert wird.
- Die maximale Größe des Heapspeichers, die für den JVM-Heapspeicher zugeordnet werden kann.
- Der Hostname des Quellenverwaltungsagenten.
- Wenn die Sicherheit aktiviert ist, das Kennwort für die Verwaltungssicherheit für den Quellenverwaltungsagenten.
- Der Dateisystempfad des Quellenverwaltungsagenten.
- Der vom Quellenverwaltungsagenten für SOAP-Verbindungen verwendete Port.
- Wenn die Sicherheit aktiviert ist, der Benutzername für den Quellenverwaltungsagenten.
- Der Hostname des Zielverwaltungsagenten.
- Wenn die Sicherheit aktiviert ist, des Kennwort für die Verwaltungssicherheit für den Zielverwaltungsagenten.
- Der Dateisystempfad des Zielverwaltungsagenten.
- Der vom Zielverwaltungsagenten für SOAP-Verbindungen verwendete Port.
- Wenn die Sicherheit aktiviert ist, der Benutzername für den Zielverwaltungsagenten.
- 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.
- 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
Beispiel einer Antwortdatei für die Migration eines eigenständigen Anwendungsservers
create
EnableIntermediateSymlink=false
EnableJavaTmpDir=true
intermediateSymlinkPreference=N
profileName=default
profilePath=<Stammverzeichnis>/profiles/ZMigSASrv01
templatePath=<Stammverzeichnis>/profileTemplates/zos-migStandalone
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=SAS
zmbAdjunctProcName=BBO9CRA
zmbAppInstallDirLine1=/wasv9config/AppServer/profiles/default/installedApps
zmbAppInstallDirLine2=
zmbAppMigrationPreference=D
zmbControllerProcName=BBO9ACR
zmbDaemonProcName=BBO9DMN
zmbEnablePostUpgradeTrace=0
zmbEnablePreUpgradeTrace=0
zmbEnableProfileTrace=0
zmbEnableScriptingTrace=0
zmbFromConfigRoot=/WebSphere/V7R0
zmbFromWASHomeDir=AppServer
zmbInitialHeapSize=512
zmbInstallDefaultApp=false
zmbInstallSamples=false
zmbJavaTempDirectory=/tmp
zmbManagedBaseNode=true
zmbMaxHeapSize=768
zmbNewAdminAgentHostname=localhost
zmbNewAdminAgentProfilePath=/WebSphere/V9R0/AdminAgent
zmbNewAdminAgentSoapPort=8880
zmbOldAdminAgentHostname=localhost
zmbOldAdminAgentProfilePath=/WebSphere/V7R0/AdminAgent
zmbOldAdminAgentSoapPort=8879
zmbProclibName=SYS1.PROCLIB
zmbReplaceStartedProcedureNames=true
zmbResolvePortConflicts=incrementCurrent
zmbSMPEHome=/usr/lpp/WebSphere/AppServer/V9R0
zmbServantProcName=BBO9ASR
zmbSetPorts=useOld
zmbTempDirectory=/tmp/migrate
zmbTimestamp=05160419
zmbToConfigRoot=/wasv9config
zmbToWASHomeDir=AppServer
zmbWorkspaceRootPreference=D