Variables de configuration pour la migration d'un gestionnaire de déploiement à l'aide de l'outil z/OS Migration Management Tool

Avant de faire migrer un serveur WebSphere Application Server for z/OS, vous devez créer des travaux JCL (fichiers CNTL et DATA) que vous exécuterez sous z/OS lors de la migration concrète. Vous pouvez utiliser l'outil z/OS Migration Management Tool pour créer une définition de migration et télécharger les travaux de migration appropriés. L'outil z/OS Migration Management Tool met à votre disposition un ensemble de variables de configuration lorsque vous créez une définition pour la migration d'un gestionnaire de déploiement.

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

Sélection d'un type de noeud à migrer

Type du noeud de migration
Type de noeud de la WebSphere Application Server devant migrer

Nom de la définition de migration

Cette section identifie le nom et le chemin de répertoire de la définition de migration contenant les travaux par lots et les instructions à utiliser pour la migration d'un noeud WebSphere Application Server for z/OS.
Nom de la définition de migration
Nom de la définition de migration z/OS

Ce nom est utilisé sur le poste de travail uniquement pour identifier les travaux et instructions de migration générés. Le nom choisi n'a aucune incidence sur la configuration de WebSphere Application Server for z/OS.

Chemin du fichier de réponses (facultatif)
Chemin complet d'un fichier de réponses comportant des valeurs par défaut à précharger dans l'outil

Un fichier de réponses est écrit chaque fois qu'une définition de migration z/OS est créée. Ce fichier contient toutes les données variables qui ont été utilisées pour créer la définition de migration, et il peut être utilisé pour précharger les valeurs par défaut lors de la création d'une définition de migration similaire. Le fichier de réponses associé à une définition de migration donnée est écrit dans le fichier nom_définition_migration.responseFile qui se trouve dans le répertoire principal retenu pour la définition de migration.

En principe, vous devez identifier un fichier de réponses à partir d'une définition de migration du même type que celle que vous allez créer.

Remarque : Une copie du fichier de réponses est placée dans le fichier .DATA inclus dans la définition de migration que vous téléchargez vers un système cible z/OS. Ce fichier de réponses n'est pas utilisé sur le système z/OS : il n'est là que pour information. Le nom de membre du fichier est ZMMTDMGR.

Fichiers cible

Qualificatif de haut niveau (HLQ)
Qualificatif de haut niveau pour les fichiers z/OS cible qui doivent contenir les travaux et instructions générés
Lorsqu'une définition de migration z/OS est téléchargée vers le système z/OS cible, les travaux et les fichiers de migration sont écrits dans deux fichiers partitionnés. Ces fichiers peuvent être réutilisés mais il est plus sûr de créer des fichiers distincts pour chaque système z/OS à migrer.
  • HLQ.CNTL - Fichier partitionné avec enregistrements de longueur fixe (80 octets) pour écriture des travaux de migration.
  • HLQ.DATA - Fichier partitionné avec enregistrements de longueur variable pour écriture de toute autre donnée contenue dans la définition de migration.
Remarque : Le qualificatif de haut niveau indiqué pour le fichier peut être un qualificatif multiniveau.

Noms de fichiers et répertoire du produit

Nom de fichier de la bibliothèque de procédures JCL
Bibliothèque de procédures existante dans laquelle les procédures WebSphere Application Server for z/OS cataloguées doivent être copiées
Répertoire du produit WebSphere Application Server
Emplacement du système de fichiers de votre produit WebSphere Application Server Version 9.0 installé
Lien symbolique intermédiaire
Sélectionnez cette option pour pouvoir configurer un lien symbolique intermédiaire et spécifiez le nom de chemin de ce lien si vous le sélectionnez.

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.

Si vous sélectionnez cette option, vous pourrez spécifier le nom de chemin d'un 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.
Nom de chemin du lien symbolique intermédiaire
Nom de chemin du lien symbolique intermédiaire

Système de fichiers de configuration

Le système de fichiers de configuration se trouve à l'emplacement où la configuration pour le noeud à migrer est stockée physiquement. Vous pouvez choisir d'utiliser un système de fichiers de la Version 9.0 existant si vous disposez déjà d'un système de fichiers adéquat sur le noeud devant migrer. Si vous décidez d'utiliser un système de fichiers de la Version 9.0 existant, vous devez vous assurer que le point de montage que vous indiquez ici existe bien avant d'exécuter les utilitaires de migration (BBOMDHFS ou BBOMDZFS, BBOMDCP, etc.) créés à l'aide de cet outil. Si vous décidez de créer un nouveau système de fichiers de la Version 9.0 sur le noeud devant migrer, sa création n'interviendra réellement que lors de la migration effective, lors de l'exécution du travail facultatif BBOMDHFS ou BBOMDZFS. Dans tous les cas, vous devez indiquer la valeur correcte ici pour le point de montage.

Reportez-vous aux instructions personnalisées générées par cet outil pour toute information spécifique concernant le paramétrage approprié de la propriété et des autorisations sur le point de montage de la configuration. Pour plus de détails sur la définition de ces variables, reportez-vous aux instructions générées ainsi qu'à la section Migration d'un gestionnaire de déploiement z/OS.

Point de montage
Point de montage en lecture/écriture 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

Si ce point de montage n'existe pas encore, le processus de migration le crée lorsque vous exécutez le travail facultatif BBOMDHFS ou BBOMDZFS.

Chaîne
Fichier de système de fichiers que vous allez créer et monter au niveau du point de montage ci-dessus
Volume ou '*' pour le service SMS
Indiquez le numéro de série du volume DASD qui doit contenir le fichier indiqué ci-dessus ou le symbole "*" pour 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.

Attribution principale dans des cylindres
Attribution d'une taille initiale dans les cylindres pour le fichier du système de fichiers

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.
Attribution secondaire dans des cylindres
Taille de chaque mesure secondaire dans les cylindres
Recommandation : La taille minimale suggérée est de 100 cylindres.
Type de système de fichiers
Système HFS (Hierarchical File System)
L'attribution et le montage de votre système de fichiers de configuration s'effectuent avec le système hiérarchique de fichiers HFS
Système de fichiers zSeries (ZFS)
L'attribution et le montage de votre système de fichiers de configuration s'effectuent avec le système de fichiers ZFS

Personnalisation de serveur (Partie 1)

Emplacement de la configuration source
Point de montage
Point de montage de la configuration à partir de laquelle vous migrez
Répertoire de base
Répertoire de base de la configuration à partir de laquelle vous migrez
Emplacement de la configuration cible
Point de montage
Point de montage de la configuration vers laquelle vous migrez

Ce point a été précédemment indiqué dans le panneau Système de fichiers de configuration.

Répertoire de base
Répertoire de base de la configuration vers laquelle vous migrez
Nom de la procédure démon
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.

Nom de la procédure contrôleurs
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.

Nom de la procédure servants
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.

Remplacer les noms des commandes pour les procédures lancées
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. Sélectionnez cette option pour effectuer cette mise à jour de la configuration.

Si vous choisissez d'utiliser les mêmes noms de procédure, ne sélectionnez pas cette option. Si vous n'utilisez pas des noms de procédure cohérents pour tous les serveurs d'un type donné (tous les servants, par exemple) pour le noeud que vous migrez, il est recommandé de ne pas sélectionner cette option. 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.
ID utilisateur de l'administrateur WebSphere
Le processus de migration nécessite le recours à un client d'administration. Indiquez un ID utilisateur d'administrateur WebSphere valide que le client d'administration va pouvoir utiliser pour s'authentifier.

Si vous le souhaitez, vous pouvez vous abstenir d'entrer un ID utilisateur à ce stade et éditer les travaux BBOWMG3D, BBOWDPRO, BBOWDPRE ou BBOWDPOS manuellement à une date ultérieure. Pour cela, mettez à jour la variable TO_AdminUserid avec l'ID utilisateur approprié avant de soumettre le travail.

Mot de passe de l'administrateur WebSphere
Le processus de migration nécessite le recours à un client d'administration. Indiquez un mot de passe d'administrateur WebSphere valide que le client d'administration va pouvoir utiliser pour s'authentifier.

Si vous le souhaitez, vous pouvez vous abstenir d'entrer un mot de passe à ce stade et éditer les travaux BBOWMG3D, BBOWDPRO, BBOWDPRE ou BBOWDPOS manuellement à une date ultérieure. Pour cela, mettez à jour la variable TO_AdminPassword avec le mot de passe approprié avant de soumettre le travail.

Personnalisation de serveur (Partie 2)

Désactiver le précédent gestionnaire de déploiement
Permet d'indiquer s'il faut ou non désactiver le gestionnaire de déploiement précédent pendant la migration.
Si le gestionnaire de déploiement source n'est pas désactivé, vous pouvez continuer à l'utiliser pendant la migration.
Attention : Vous devez utiliser cette option avec précaution. Les gestionnaires de déploiement de WebSphere Application Server sont généralement arrêtés et désactivés afin d'éviter qu'un même noeud ne soit géré par plusieurs gestionnaires de déploiement. Vous devez arrêter le gestionnaire de déploiement source avant de commencer à utiliser celui de la Version 9.0. Si vous désélectionnez cette option, il est possible que tous les changements apportés dans l'ancienne configuration lors de la migration ne soient pas migrés.
Préférence pour la migration des applications
Permet d'indiquer la façon dont vous souhaitez migrer vos applications installées
Remarque : les applications système WebSphere Application Server seront migrées quelle que soit la valeur définie ici.
Migrer les applications et utiliser le répertoire d'installation des applications par défaut
Installez les applications d'entreprise utilisateur dans le répertoire d'installation des applications par défaut dans le cadre de la migration
Migrer les applications et utiliser le répertoire indiqué pour leur installation
Les applications d'entreprise utilisateur sont placées dans le répertoire d'installation des applications indiqué dans le cadre de la migration
Répertoire d'installation des applications
Emplacement où WebSphere Application Server doit installer vos applications d'entreprise

Cet emplacement est utilisé lorsque vos indiquez que vous souhaitez migrer et installer les applications selon votre préférence pour la migration des applications. Vous pouvez soit choisir un emplacement personnalisé spécifique à l'environnement, soit utiliser l'emplacement par défaut.

Migrer et générer des scripts administratifs pour installer les applications ultérieurement
Prépare les applications d'entreprise pour leur installation dans le répertoire WebSphere Application Server Version 9.0 installableApps sans effectivement les installer lors de la migration
Des scripts qui peuvent être utilisés pour installer ces applications sont générés et enregistrés dans le répertoire de sauvegarde de migration. Pour WebSphere Application Server for z/OS, l'emplacement de ce répertoire de sauvegarde est relatif au répertoire temporaire spécifié sur ce même panneau. L'emplacement du répertoire de sauvegarde est également déterminé par l'identifiant de migration dérivé ainsi que par le type de noeud migré. Si vous indiquez /tmp/migrate comme répertoire temporaire et que l'identifiant de migration dérivé est 55449, par exemple, l'emplacement des scripts générés est :
/tmp/migrate/55449/nodetype_backup/
where nodetype is dmgr, fed, or base depending on the type of node that you are migrating.

You can then run these files at any point and in any combination after migration has completed. You can also reorganize and combine these files for better application installation efficiency. Read the "Wsadmin tool" article in the documentation for additional information.

Migrate applications and use the previous application installation directory
Install user enterprise applications as part of the migration, and keep the same application installation directories as the previous version
Restrictions : If you select this option, the location is shared by the existing WebSphere Application Server installation and the Version 9.0 installation. If you keep the migrated applications in the same locations as those of the previous version, the following restrictions apply:
  • The WebSphere Application Server Version 9.0 mixed-node support limitations must be followed. This means that the following support cannot be used when evoking the wsadmin command:
    • Precompile JSP
    • Use Binary Configuration
    • Deploy EJB
  • You risk losing the migrated applications unintentionally if you later delete applications from these locations when administering (uninstalling for example) your older installation.
  • Any application that is installed relative to a variable in the source release will be installed relative to the location assigned to that variable in Version 9.0. In other words, the absolute location is not preserved—the application is migrated to the relative location within the new Version 9.0 environment.
    If the binariesURL in the deployment.xml file for an application being migrated has a path that is relative to WebSphere Application Server—that is, it begins with $(APP_INSTALL_ROOT), $(WAS_INSTALL_ROOT), and so on—the new WebSphere Application Server variable value is used to resolve the path when the application is installed in the new location. This leads to the following results when you select this option:
    • Any application that is installed in a directory location relative to a WebSphere Application Server variable is installed under that variable value in Version 9.0.
    • Any application that is installed in a directory location that is not relative to a WebSphere Application Server variable is migrated and overwritten in that same directory. If an application is installed in the /employee_records/retrieval_Apps directory, for example, the application is migrated and overwritten in the /employee_records/retrieval_Apps directory.
Do not migrate applications
Do nothing with user enterprise applications
Migrate administrative console customized "My tasks" settings
"My tasks" is only supported in WebSphere Application Server Version 7.0 ou ultérieures.
Migrate the settings for "My tasks" saved in the default workspace user root location (wstemp)
Migrate the settings for "My tasks" saved in a user defined workspace root location
User defined workspace root location

Migration Process Options

Migration trace options

If you choose to enable tracing, it will remain enabled throughout the entire migration process.

Enable script tracing
Enable or disable trace of the home creation, profile and migration tooling invocation, and final processing phases of migration
Enable profile creation tracing
Enable or disable trace trace during profile creation
Enable pre-upgrade tracing
Enable or disable trace during the WASPreUpgrade process
Enable post-upgrade tracing
Enable or disable trace during the WASPostUpgrade process
JVM options for migration processes
Initial heap size (MB)
The initial memory allocated for the JVM heap.
Maximum heap size (MB)
The maxiumum heap size that can be allocated for the JVM heap.
Temporary directory location
The directory where the backup of your previous configuration and the migration trace are written.

During migration, a backup copy of the previous version's configuration is required. The default location of this backup is /tmp/migrate. If the /tmp file system does not have adequate space to store the backup configuration, you can specify another location. If you choose to override the default location of the backup copy, the best practice is to keep the same naming convention and just replace the /tmp portion with another path, /myTemp/migrate for example.

Migration definition identifier
Identifier that will be used to create a directory under the temporary directory that will contain the temporary migration datasets and backup configuration data
Java temporary directory
You can specify a Java temporary directory that is used by the Java virtual machine to create and story temporary files during migration.
Set the Java temporary directory
Java temporary directory location

Port values

Define which port values to use in the new profile and how to handle port conflicts. If you reuse port values from the old profile, the new profile cannot run at the same time as the old profile because of port conflicts. If you intend to run both profiles concurrently, make sure that each profile uses different ports.

Use the same ports that the old profile used
Reuse the port values that are defined in the source profile.
Select ports manually
Set custom values for each port in the target profile on the following panel.
Generate new ports, incrementing from a common starting port value
Generate new ports from the specified port value. Conflicting ports are automatically resolved.
Port conflict resolution
Choose how to resolve port conflicts.
Increment from the conflicted port value
If a port conflict is detected, the port value is incremented from the conflicting port to the next available port value.
Increment from a common starting port value
If a port conflict is detected, the port value is incremented from the specified value to the next available port value.

Job Statement Definition

All the migration jobs that will be tailored for you will need a job statement.

Enter a valid job statement for your installation. The migration creation process will update the job name for you in all the generated jobs, so you do not need to be concerned with that portion of the job statement. If continuation lines are needed, replace the comment lines with continuation lines.


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_depmanvar
Nom du fichier : cmig_zmmt_depmanvar.html