Variables de configuration pour la migration d'un noeud fédéré z/OS à l'aide de la commande zmmt

Avant de faire migrer WebSphere Application Server for z/OS, vous devez créer des travaux JCL (fichiers CNTL et DATA) que vous exécuterez lors de la migration concrète. Vous pouvez utiliser la commande zmmt avec un fichier de réponses pour créer les travaux de migration appropriés. Le fichier de réponses contient un ensemble de variables de configuration que vous pouvez utiliser pour créer des travaux en vue de migrer un noeud fédéré.

Configurations prises en charge Configurations prises en charge:

Cet article traite de la migration de configuration de profil. Pour faire migrer vos applications vers la dernière version, utilisez le kit d'outils de migration de WebSphere Application Server. Pour plus d'informations, voir Migration Toolkit on WASdev.

sptcfg

Variables du fichier de réponses

Créer
Mot clé obligatoire pour indiquer la création d'une nouvelle définition de migration
intermediateSymlinkPreference
Création d'un lien symbolique intermédiaire

Si vous spécifiez un lien symbolique intermédiaire, les liens symboliques sont créés entre le système de fichiers de la configuration et le lien symbolique intermédiaire ; sinon, ils sont créés directement vers le système de fichiers du produit.

IntermediateSymlink
Nom de chemin du lien symbolique intermédiaire

Ce lien sera créé par les travaux de personnalisation et pointera vers le répertoire du système de fichiers du produit.

profileName
Nom du profil créé pendant la migration.

Il s'agit toujours de default pour la plate-forme z/OS.

profilePath
Chemin complet indiquant où sera écrite la sortie générée pour la définition de migration.
templatePath
Chemin de modèles
L'une des valeurs suivantes :
  • zos-migDmgr

    Migration d'un gestionnaire de déploiement

  • zos-migFederated

    Migration d'un noeud fédéré

  • zos-migStandalone

    Migration d'un serveur d'applications autonome

zConfigHfsName
Nom du fichier MVS qui doit contenir le système de fichiers de configuration

Ce nom est utilisé comme donnée d'entrée du travail de migration qui crée le système de fichiers de configuration.

zConfigHfsPrimaryCylinders
Nombre de cylindres principaux qui doivent être alloués au système de fichiers de configuration

Sur un serveur d'applications, l'espace total nécessaire pour ces fichiers augmente avec la taille et le nombre d'applications installées.

Recommandation : La taille minimale suggérée est de 420 cylindres.
zConfigHfsSecondaryCylinders
Nombre de cylindres secondaires qui doivent être alloués au système de fichiers de configuration
Recommandation : La taille minimale suggérée est de 100 cylindres.
zConfigHfsVolume
Numéro de série du volume DASD qui doit contenir le fichier indiqué ci-dessus, ou symbole "*" si vous voulez laisser le service SMS sélectionner un volume.

L'utilisation du symbole "*" nécessite que les routines de sélection de classe automatique du service SMS soient installées pour sélectionner le volume. Si vous ne possédez aucune configuration du service SMS permettant de gérer l'attribution automatique du fichier, répertoriez le volume de façon explicite.

zConfigMountPoint
Point de montage du répertoire du système de fichiers dans lequel les données de l'application ainsi que les fichiers d'environnement sont enregistrés
zFilesystemType
Type de système de fichiers
L'une des valeurs suivantes :
  • HFS

    L'allocation et le montage du fichier de votre système de fichiers de configuration s'effectuent avec le système hiérarchique de fichiers HFS.

  • ZFS

    L'allocation et le montage du fichier de votre système de fichiers de configuration s'effectuent avec le système de fichiers zSeries.

zJobStatement1 . . . n
Instructions JOB personnalisables qui seront utilisées pour les travaux de migration générés

Une instruction de travail sera nécessaire pour tous les travaux de migration personnalisés à votre intention. Entrez une instruction de travail valide pour votre installation. Le processus de création de migration réactualisera pour vous le nom du travail dans tous les travaux générés ; vous n'êtes donc pas tenu de vous préoccuper de cette partie de l'instruction de travail. Si vous avez besoin de lignes de continuation, remplacez les lignes de commentaire par des lignes de continuation.

zTargetHLQ
Qualificatif de haut niveau pour les fichiers z/OS cible qui doivent contenir les travaux et instructions générés
Remarque : Le qualificatif de haut niveau indiqué pour le fichier peut être un qualificatif multiniveau.
zmbAdminUserid
ID utilisateur d'un administrateur utilisé pour gérer le noeud que vous faites migrer.

Vous devez définir ce paramètre pour effectuer les actions d'administration requises pendant la procédure de migration.

zmbAdminPassword
Mot de passe de l'ID utilisateur de l'administrateur utilisé pour gérer le noeud que vous faites migrer.

Vous devez définir ce paramètre pour effectuer les actions d'administration requises pendant la procédure de migration.

zmbControllerProcName
Nom de la procédure lancée par JCL qui est utilisée pour démarrer les contrôleurs migrés

Lors de la migration vers la Version 9.0, vous devez mettre à niveau les procédures lancées par JCL. Une nouvelle procédure sera générée à votre intention en cours de migration. Vous pouvez soit indiquer un nouveau nom pour la procédure contrôleurs, soit utiliser l'ancien nom.

zmbServantProcName
Nom de la procédure lancée par JCL qui est utilisée pour démarrer les servants migrés

Lors de la migration vers la Version 9.0, vous devez mettre à niveau les procédures lancées par JCL. Une nouvelle procédure sera générée à votre intention en cours de migration. Vous pouvez soit indiquer un nouveau nom pour la procédure servants, soit utiliser l'ancien nom.

zmbDaemonProcName
Nom de la procédure lancée par JCL qui est utilisée pour démarrer le démon migré

Lors de la migration vers la Version 9.0, vous devez mettre à niveau les procédures lancées par JCL. Une nouvelle procédure sera générée à votre intention en cours de migration. Vous pouvez soit indiquer un nouveau nom pour la procédure démon, soit utiliser l'ancien nom.

zmbAdjunctProcName
Nom de la procédure lancée par JCL qui est utilisée pour démarrer l'adjoint migré

Lors de la migration vers la Version 9.0, vous devez mettre à niveau les procédures lancées par JCL. Une nouvelle procédure sera générée à votre intention en cours de migration. Vous pouvez soit indiquer un nouveau nom pour la procédure adjoint, soit utiliser l'ancien nom.

zmbReplaceStartedProcedureNames
Indique s'il faut mettre à jour les commandes START dans la configuration avec les nouveaux noms spécifiés (true) ou s'il faut conserver les mêmes noms (false).

Si vous avez spécifié de nouveaux noms pour vos procédures JCL, les commandes START correspondantes dans la configuration WebSphere Application Server doivent être mises à jour afin de refléter ces nouveaux noms. Spécifiez true pour cette variable afin d'effectuer cette mise à jour de la configuration.

Si vous choisissez d'utiliser les mêmes noms de procédure, spécifiez false pour cette variable. Si vous n'utilisez pas des noms de procédure cohérents pour tous les serveurs d'un type de processus donné (tous les servants, par exemple) pour le noeud que vous migrez, il est recommandé de spécifier false pour cette variable. Dans ce cas, vous devrez conserver les mêmes commandes START et remplacer les procédures manuellement en utilisant comme modèle la procédure qui est générée en cours de migration.

Notes :
  • Votre configuration Version 9.0 doit utiliser des procédures JCL différentes de celles qui étaient utilisées par votre configuration version 7.0. Le processus de migration crée de nouvelles procédures JCL sous la Version 9.0 à l'aide des noms de procédures spécifiés ici.
  • Si vous utilisez les mêmes noms que ceux utilisés dans la configuration version 7.0, le processus de migration écrase les procédures existantes. Par conséquent, si vous utilisez les mêmes noms, veillez à sauvegarder les procédures version 7.0 avant d'exécuter les travaux de migration pour le cas où vous auriez besoin de procéder à une rétromigration.
zmbEnablePostUpgradeTrace
Active (true) ou désactive (false) la trace durant le processus WASPostUpgrade
zmbEnablePreUpgradeTrace
Active (true) ou désactive (false) la trace durant le processus WASPreUpgrade
zmbEnableProfileTrace
Active (true) ou désactive (false) la trace durant la création des profils.
zmbEnableScriptingTrace
Active (true) ou désactive (false) la trace des appels aux outils de création des répertoires de base et de migration des profils ainsi que des phases de traitement final de la migration.
zmbFromConfigRoot
Point de montage de la configuration à partir de laquelle vous migrez
zmbFromWASHomeDir
Répertoire de base de la configuration à partir de laquelle vous migrez
zmbInitialHeapSize
Mémoire initiale allouée pour le segment JVM.
zmbJavaTempDirectory
Répertoire temporaire Java qui est utilisé par la machine virtuelle Java pour créer et stocker des fichiers temporaires lors de la migration.
zmbMaxHeapSize
Taille maximale de segment de mémoire qui peut être allouée pour le segment de mémoire JVM.
zmbProclibName
Bibliothèque de procédures existante dans laquelle les procédures WebSphere Application Server for z/OS cataloguées doivent être copiées
zmbResolvePortConflicts
Définissez comment gérer les conflits de port en spécifiant l'une des valeurs suivantes.
  • incrementCurrent

    Si un conflit de ports est détecté, la valeur du port est incrémentée à partir du port en conflit vers la valeur suivante de port disponible.

  • startingPort
    Si un conflit de ports est détecté, la valeur du port est incrémentée à partir de la valeur spécifiée vers la valeur suivante de port disponible.
    Remarque : Si zmbResolvePortConflicts et zmbSetPorts sont définis sur startingPort, la variable zmbResolvePortConflicts est ignorée.
    zmbStartingPort
    Valeur du port de départ à partir duquel de nouveaux ports sont générés.
zmbSetPorts
Définissez les valeurs de port à utiliser dans le nouveau profil en spécifiant l'une des valeurs suivantes.
  • useOld

    Réutilisez les valeurs de port qui sont définies dans le profil source.

  • generateNew

    Définissez des valeurs personnalisées pour chaque port dans le profil cible.

  • startingPort

    Générez de nouveaux ports en incrémentant la valeur de port spécifié. Les ports conflictuels sont automatiquement résolus.

    zmbStartingPort
    Valeur du port de départ à partir duquel de nouveaux ports sont générés.
zmbSMPEHome
Emplacement du système de fichiers de votre produit WebSphere Application Server Version 9.0 installé
zmbTempDirectory
Répertoire dans lequel sont enregistrées la sauvegarde de la configuration précédente et la trace de la migration.

Durant la migration, une copie de sauvegarde de la configuration de version précédente est obligatoire. L'emplacement par défaut de cette sauvegarde est /tmp/migrate. Si le système de fichiers /tmp n'a pas assez d'espace pour stocker la configuration de sauvegarde, vous pouvez spécifier un autre emplacement. Si vous choisissez d'écraser l'emplacement par défaut de la copie de sauvegarde, le meilleur moyen est de garder la même convention d'attribution de nom et de remplacer seulement la partie /tmp par un autre chemin, /myTemp/migrate par exemple.

zmbTimestamp
Identificateur qui sera utilisé pour créer un répertoire sous le répertoire temporaire qui contiendra les fichiers de migration temporaires et les données de configuration de sauvegarde
zmbToConfigRoot
Point de montage de la configuration vers laquelle vous migrez

Il s'agit de la même valeur que pour la variable zConfigMountPoint.

zmbToWASHomeDir
Répertoire de base de la configuration vers laquelle vous migrez
zmbWorkspaceRootPreference
Indique si vous souhaitez migrer les paramètres personnalisés "Mes tâches" de la console d'administration sauvegardés dans l'emplacement racine utilisateur de l'espace de travail par défaut (D) ou dans l'emplacement racine défini par l'utilisateur (U)
zmbUserWorkspaceRoot
Emplacement racine de l'espace de travail défini par l'utilisateur

Exemple de fichier de réponses pour la migration d'un noeud fédéré

create
EnableIntermediateSymlink=false
EnableJavaTmpDir=false
intermediateSymlinkPreference=N
profileName=default
profilePath=<root>/profiles/ZMigFed01
templatePath=<root>/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

Icône indiquant le type de rubrique Rubrique de concept



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-zos&topic=cmig_zmmt_cmd_fednodevar
Nom du fichier : cmig_zmmt_cmd_fednodevar.html