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.

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.

Auf der Plattform z/OS ist dies 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.

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.

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.

zmbAppMigrationPreference
Diese Einstellung gibt an, wie die installierten Anwendungen migriert werden sollen.
Einer der folgenden Werte:
  • D

    Benutzerunternehmensanwendungen während der Migration im Standardverzeichnis der Anwendungsinstallation installieren

  • Y

    Benutzerunternehmensanwendungen während der Migration in einem Verzeichnis installieren, das mit den folgenden Variablen angegeben wurde

    zmbAppInstallDirLine1
    zmbAppInstallDirLine2
    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.

    Wenn der Standortpfad länger ist als 60 Zeichen, muss er, wie oben gezeigt, auf zwei Zeilen angegeben werden. Er darf jedoch eine Gesamtlänge von 120 Zeichen nicht überschreiten.

    Lassen Sie diese beiden Felder leer, sofern Sie für "zmbAppMigrationPreference" nicht "Y" angeben.

  • S

    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:
    /tmp/migrate/55449/Knotentyp_backup/
    Knotentyp steht hier je nach Typ des migrierten Knotens für dmgr, fed oder base.

    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.

  • P

    Benutzerunternehmensanwendungen während der Migration installieren und die Anwendungsinstallationsverzeichnisse der vorherigen Version beibehalten

    Einschränkungen: Wenn Sie diese Option auswählen, wird die Position von der vorhandenen Installation von WebSphere Application Server Version 7.0 und der Installation von Version 9.0 gemeinsam genutzt. Die folgenden Einschränkungen gelten, wenn die migrierten Anwendungen in denselben Verzeichnissen belassen werden:
    • Die Einschränkungen der Unterstützung von WebSphere Application Server Version 9.0 für heterogene Knoten müssen eingehalten werden. Das bedeutet, dass die folgende Unterstützung nicht verwendet werden kann, wenn der Befehl wsadmin aufgerufen wird:
      • JSP vorkompilieren
      • Binärkonfiguration verwenden
      • EJB implementieren
    • Sie riskieren einen unbeabsichtigten Verlust migrierter Anwendungen, wenn Sie Anwendungen in diesen Verzeichnissen später bei der Verwaltung (z. B. Deinstallation) Ihrer Installation von Version 7.0 löschen.
    • Jede Anwendung, die relativ zu einer Variablen der Version 7.0 installiert wird, wird relativ zu der Position installiert, die dieser Variablen in Version 9.0 zugeordnet ist. Anders ausgedrückt, wird die absolute Position nicht beibehalten. Die Anwendung wird an die relative Position in der neuen Umgebung mit Version 9.0 migriert.
      Wenn die Einstellung "binariesURL" in der Datei deployment.xml für eine zu migrierende Anwendung einen Pfad enthält, der relativ zu WebSphere Application Server angegeben ist, d. h. mit $(APP_INSTALL_ROOT), $(WAS_INSTALL_ROOT) usw. beginnt, wird der neue Wert der Variablen von WebSphere Application Server verwendet, um den Pfad aufzulösen, wenn die Anwendung an der neuen Position installiert wird. Dies führt bei Auswahl dieser Option zu den folgenden Ergebnissen:
      • Jede Anwendung, die an einer Verzeichnisposition installiert ist, die relativ zu einer Variablen von WebSphere Application Server ist, wird in Version 9.0 unter dem Wert dieser Variablen installiert.
      • Jede Anwendung, die an einer Verzeichnisposition installiert ist, die nicht relativ zu einer Variablen von WebSphere Application Server ist, wird in dasselbe Verzeichnis migriert und überschrieben. Wenn eine Anwendung beispielsweise im Verzeichnis /employee_records/retrieval_Apps installiert ist, wird die Anwendung in das Verzeichnis /employee_records/retrieval_Apps migriert und überschrieben.
  • N

    Benutzerunternehmensanwendungen unverändert beibehalten

Anmerkung: Die Systemanwendungen von WebSphere Application Server werden unabhängig von dem hier definierten Wert migriert.
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.

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

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_depmanvar
Dateiname:cmig_zmmt_cmd_depmanvar.html