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.

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.
sptcfgSélection d'un type de noeud à migrer
- 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 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 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 pour les fichiers z/OS cible qui doivent contenir les travaux et
instructions générésLorsqu'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.Remarque : Le qualificatif de haut niveau indiqué pour le fichier peut être un qualificatif multiniveau.
Noms de fichiers et répertoire du produit
- Bibliothèque de procédures existante dans laquelle les procédures WebSphere Application Server for z/OS cataloguées doivent être copiées
- Emplacement du système de fichiers de votre produit WebSphere Application Server Version 9.0 installé
- 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
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 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.
- Fichier de système de fichiers que vous allez créer et monter au niveau du point de montage ci-dessus
- 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 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. - Taille de chaque mesure secondaire dans les cylindresRecommandation : La taille minimale suggérée est de 100 cylindres.
- L'attribution et le montage de votre système de fichiers de configuration s'effectuent avec le système hiérarchique de fichiers HFS
- 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)
- Point de montage de la configuration à partir de laquelle vous migrez
- Répertoire de base de la configuration à partir de laquelle vous migrez
- 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 de la configuration vers laquelle vous migrez
- Point de montage de la configuration vers laquelle vous migrez
- 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 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 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.
- 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 : - 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.
- 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)
- 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.
- 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.
- Installez les applications d'entreprise utilisateur dans le répertoire d'installation des applications par défaut dans le cadre de la migration
- Les applications d'entreprise utilisateur sont placées dans le répertoire d'installation
des applications indiqué dans le cadre de la migration
- 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.
- Emplacement où WebSphere
Application Server doit installer vos applications d'entreprise
- 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 migrationDes 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 :
where nodetype is dmgr, fed, or base depending on the type of node that you are migrating./tmp/migrate/55449/nodetype_backup/
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.
- 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:
- Do nothing with user enterprise applications
- "My tasks" is only supported in WebSphere
Application Server Version 7.0 ou ultérieures.
- User defined workspace root location
Migration Process Options
If you choose to enable tracing, it will remain enabled throughout the entire migration process.
- Enable or disable trace of the home creation, profile and migration tooling invocation, and final processing phases of migration
- Enable or disable trace trace during profile creation
- Enable or disable trace during the WASPreUpgrade process
- Enable or disable trace during the WASPostUpgrade process
- The initial memory allocated for the JVM heap.
- The maxiumum heap size that can be allocated for the JVM heap.
- 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.
- Identifier that will be used to create a directory under the temporary directory that will contain the temporary migration datasets and backup configuration data
- 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.
- Reuse the port values that are defined in the source profile.
- Set custom values for each port in the target profile on the following panel.
- Generate new ports from the specified port value. Conflicting ports are automatically resolved.
- 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.