Konfigurationsvariablen für die Migration eines eingebundenen Knotens 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 eingebundenen Knotens können.

Unterstützte Konfigurationen Unterstützte Konfigurationen:

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.

sptcfg

Variablen der Antwortdatei

create
Ein erforderliches Schlüsselwort, das die Erstellung einer neuen Migrationsdefinition angibt.
intermediateSymlinkPreference
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.

IntermediateSymlink
Pfadname des temporären symbolischen Links

Dieser Link wird von den Anpassungsjobs erstellt und verweist auf das Dateisystemverzeichnis des Produkts.

profileName
Der Name des während der Migration erstellten Profils.

Für die Plattform z/OS ist dieser Name immer default.

profilePath
Vollständig qualifizierter Pfad, in den die generierten Migrationsdefinition geschrieben werden soll.
templatePath
Schablonenpfad
Einer der folgenden Werte:
  • zos-migDmgr

    Migration eines Deployment Manager

  • zos-migFederated

    Migration eines eingebundenen Knotens

  • zos-migStandalone

    Migration eines eigenständigen Anwendungsservers

zConfigHfsName
Name der MVS-Datei, die das Konfigurationsdateisystem enthält.

Dieser Name wird als Eingabe für den Migrationsjob verwendet, der das Konfigurationsdateisystem erstellt.

zConfigHfsPrimaryCylinders
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.
zConfigHfsSecondaryCylinders
Die Anzahl sekundärer Zylinder, die dem Konfigurationsdateisystem zugeordnet werden.
Empfehlung: Die empfohlene Mindestgröße sind 100 Zylinder.
zConfigHfsVolume
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.

zConfigMountPoint
Mountpunkt für das Dateisystemverzeichnis, in das die Anwendungsdaten und Umgebungsdateien geschrieben werden.
zFilesystemType
Dateisystemtyp
Einer 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.

zJobStatement1 . . . n
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.

zTargetHLQ
Ü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.
zmbAdminUserid
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.

zmbAdminPassword
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.

zmbControllerProcName
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.

zmbServantProcName
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.

zmbDaemonProcName
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.

zmbAdjunctProcName
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.

zmbReplaceStartedProcedureNames
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:
  • Die Konfiguration von Version 9.0 muss andere JCL-Prozeduren verwenden als diejenigen, die von der Konfiguration von Version 7.0 verwendet werden. Der Migrationsprozess erstellt neue JCL-Prozeduren von Version 9.0 mit den hier angegebenen Prozedurnamen.
  • Wenn Sie dieselben Namen wie in der Konfiguration von Version 7.0 verwenden, überschreibt der Migrationsprozess die vorhandenen Prozeduren. Falls Sie dieselben Namen verwenden, sollten Sie die vorhandenen Prozeduren von Version 7.0 vor Ausführung der Migrationsjobs sichern, falls Sie die neue Konfiguration später rückgängig machen müssen.
zmbEnablePostUpgradeTrace
Traceerstellung während des WASPostUpgrade-Prozesses aktivieren (true) oder inaktivieren (false).
zmbEnablePreUpgradeTrace
Traceerstellung während des WASPreUpgrade-Prozesses aktivieren (true) oder inaktivieren (false).
zmbEnableProfileTrace
Traceerstellung während der Profilerstellung aktivieren (true) oder inaktivieren (false).
zmbEnableScriptingTrace
Traceerstellung für die Erstellung von Ausgangsverzeichnissen, den Aufruf von Profil- und Migrationstools und die Endverarbeitungsphasen der Migration aktivieren (true) oder inaktivieren (false).
zmbFromConfigRoot
Mountpunkt der Konfiguration, die als Quelle für die Migration verwendet wird.
zmbFromWASHomeDir
Ausgangsverzeichnis der Konfiguration, die als Quelle für die Migration verwendet wird.
zmbInitialHeapSize
Der für den JVM-Heapspeicher zugeordnete Anfangsspeicher.
zmbJavaTempDirectory
Ein temporäres Java-Verzeichnis, das von der Java Virtual Machine bei der Migration zum Erstellen und Speichern temporärer Dateien verwendet wird.
zmbMaxHeapSize
Die maximale Größe des Heapspeichers, die für den JVM-Heapspeicher zugeordnet werden kann.
zmbProclibName
Eine vorhandene Prozedurenbibliothek, in die die katalogisierten Prozeduren von WebSphere Application Server for z/OS kopiert werden.
zmbResolvePortConflicts
Durch Angabe eines der folgenden Werte definieren, wie Portkonflikte gehandhabt werden.
  • incrementCurrent

    Wenn ein Portkonflikt festgestellt wird, wird der Portwert des den Konflikt verursachenden Ports auf den nächsten verfügbaren Portwert erhöht.

  • startingPort
    Wenn ein Portkonflikt festgestellt wird, wird der Portwert ab dem angegebenen Wert auf den nächsten verfügbaren Portwert erhöht.
    Anmerkung: Wenn sowohl zmbResolvePortConflicts als auch zmbSetPorts auf startingPort gesetzt ist, wird die Variable zmbResolvePortConflicts ignoriert.
    zmbStartingPort
    Der Anfangsportwert, ausgehend vom dem neue Ports generiert werden.
zmbSetPorts
Durch Angabe eines der folgenden Werte definieren, welche Portwerte im neuen Profil verwendet werden sollen.
  • useOld

    Die im Quellenprofil definierten Portwerte wiederverwenden.

  • generateNew

    Angepasste Werte für jeden Port im Zielprofil festlegen.

  • startingPort

    Neue Portwerte durch Erhöhen des Werts ausgehend vom angegebenen Portwert generieren. In Konflikt stehende Ports werden automatisch aufgelöst.

    zmbStartingPort
    Der Anfangsportwert, ausgehend vom dem neue Ports generiert werden.
zmbSMPEHome
Position des Produktdateisystems Ihrer Installation von WebSphere Application Server Version 9.0
zmbTempDirectory
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.

zmbTimestamp
Eine Kennung, die zum Erstellen eines Verzeichnisses unter dem temporären Verzeichnis mit den temporären Migrationsdatensätzen und Sicherungskonfigurationsdaten verwendet wird.
zmbToConfigRoot
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.

zmbToWASHomeDir
Ausgangsverzeichnis der Konfiguration, die als Ziel für die Migration verwendet wird.
zmbWorkspaceRootPreference
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.
zmbUserWorkspaceRoot
Position des benutzerdefinierten Stammverzeichnisses (Root) des Arbeitsbereichs.

Beispiel einer Antwortdatei für die Migration eines eingebundenen Knotens

create
EnableIntermediateSymlink=false
EnableJavaTmpDir=false
intermediateSymlinkPreference=N
profileName=default
profilePath=<Stammverzeichnis>/profiles/ZMigFed01
templatePath=<Stammverzeichnis>/profileTemplates/zos-migFederated
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=FED
zmbAdjunctProcName=BBO9CRA
zmbAdminPassword=XXXXXXXX
zmbAdminUserid=XXXXXXXX
zmbControllerProcName=BBO9ACR
zmbDaemonProcName=BBO89MN
zmbEnablePostUpgradeTrace=0
zmbEnablePreUpgradeTrace=0
zmbEnableProfileTrace=0
zmbEnableScriptingTrace=0
zmbFromConfigRoot=/WebSphere/V7R0
zmbFromWASHomeDir=AppServer
zmbInitialHeapSize=512
zmbMaxHeapSize=768
zmbProclibName=SYS1.PROCLIB
zmbReplaceStartedProcedureNames=true
zmbResolvePortConflicts=incrementCurrent
zmbSMPEHome=/usr/lpp/WebSphere/AppServer/V9R0
zmbServantProcName=BBO9ASR
zmbSetPorts=useOld
zmbTempDirectory=/tmp/migrate
zmbTimestamp=05173538
zmbToConfigRoot=/wasv9config
zmbToWASHomeDir=AppServer
zmbWorkspaceRootPreference=D

Symbol, das den Typ des Artikels anzeigt. Konzeptartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-zos&topic=cmig_zmmt_cmd_fednodevar
Dateiname:cmig_zmmt_cmd_fednodevar.html