Variables de configuration pour la migration d'un nœud fédéré à l'aide de l'outil de gestion de la migration d' z/OS

Avant de migrer un nœud WebSphere® Application Server pour z/OS® vers la version 9.0, vous devez créer des tâches JCL (Job Control Language) (ensembles de données CNTL et DATA) que vous exécuterez sur z/OS pendant la migration. Vous pouvez utiliser l'outil de gestion de la migration z/OS pour créer une définition de migration et télécharger les tâches de migration appropriées. L'outil de gestion de la migration d' z/OS vous propose un ensemble de variables de configuration lorsque vous créez une définition pour la migration d'un nœud fédéré.

Configurations prises en charge :

Cette rubrique concerne la migration de la configuration de profil. Pour migrer vos applications vers la dernière version, utilisez l'outil de migration WebSphere Application Server Migration Toolkit.

Sélection d'un type de noeud à migrer

Type du noeud de migration
Type de WebSphere Application Server nœud à migrer
Migration clone
Sélectionnez cette option pour effectuer une migration clone d'un profil existant. La migration clone permet aux environnements existant et nouveau de s'exécuter simultanément. Si le gestionnaire de déploiement qui gère ce nœud a été cloné, ce nœud doit être cloné. Si le gestionnaire de déploiement n'a pas été cloné, ce nœud ne peut pas être cloné.

Migration clone

Ce panneau s'affiche uniquement si vous avez sélectionné l'option de migration clone.

Nom d'hôte
Indiquez le nom d'hôte du nouveau gestionnaire de déploiement auquel le profil cloné est fédéré. Le nouveau gestionnaire de déploiement doit être en cours d'exécution sur ce nom d'hôte pendant la migration du nœud.
Port SOAP
Sélectionnez cette option pour indiquer le port SOAP du nouveau gestionnaire de déploiement à la migration. Vous devez indiquer au moins l'un des ports SOAP ou RMI du nouveau gestionnaire de déploiement. Si les deux sont spécifiés, une connexion au port SOAP est tentée en premier, puis une connexion au port RMI en cas d'échec de la connexion au port SOAP.
Port RMI
Sélectionnez cette option pour indiquer le port RMI du nouveau gestionnaire de déploiement à la migration. Vous devez indiquer au moins l'un des ports SOAP ou RMI du nouveau gestionnaire de déploiement. Si les deux sont spécifiés, une connexion au port SOAP est tentée en premier, puis une connexion au port RMI en cas d'échec de la connexion au port SOAP.

Nom de la définition de migration

Identifie le nom de la définition de migration et le chemin d'accès au répertoire contenant les tâches batch et les instructions utilisées pour migrer un nœud d' WebSphere Application Server s pour 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 aucun effet sur l' WebSphere Application Server, pour la configuration d' z/OS.

Nom de chemin du fichier de réponses (facultatif)
Chemin complet d'un fichier de réponses contenant des valeurs par défaut à pré-installer dans l'outil.

Un fichier de réponses est généré 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é-installer les valeurs par défaut lors de la création d'une définition de migration similaire. Le fichier de réponse pour une définition de migration donnée est écrit dans le migration_definition_name.responseFile fichier situé dans le répertoire racine de la définition de migration.

En règle générale, vous devez spécifier un fichier de réponses à partir d'une définition de migration du même type que celle que vous êtes sur le point de définir.

Remarque : une copie du fichier de réponse est incluse dans le .DATA jeu de données qui fait partie de 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 ZMMTFED.

Fichiers cible

Qualificatif de haut niveau (HLQ)
Qualificateur de haut niveau pour les ensembles de données cibles z/OS qui contiennent les tâches et les instructions générées.
Lorsqu'une définition de migration d' z/OS s est téléchargée vers le système cible d' z/OS s, les tâches et les fichiers de migration sont écrits dans une paire de jeux de données partitionnés. Bien qu'il soit possible de réutiliser ces ensembles de données, il est plus sûr de créer des ensembles de données distincts pour chaque système d' z/OS s à migrer.
  • HLQ.CNTL - Fichier partitionné avec enregistrements de longueur fixe (80 octets) pour écriture des travaux de migration.
  • HLQ.DATA - Fichier partitionné avec des données de longueur variable conçu pour contenir les autres donnée placées dans la définition de migration.
Remarque : Le qualificatif de haut niveau indiqué pour le fichier peut être un qualificatif multiniveau.

Système de fichiers de configuration

Le système de fichiers de configuration se trouve à l'emplacement où la configuration pour le nœud à migrer est stockée physiquement. Vous pouvez choisir d'utiliser un système de fichiers existant de la version 9.0 si vous disposez déjà d'un système de fichiers approprié sur le nœud en cours de migration. Si vous choisissez d'utiliser un système de fichiers existant de la version 9.0, vous devez vous assurer que le point de montage que vous spécifiez ici est présent avant d'exécuter les utilitaires de migration ( BBOWMG1F, BBOWMG2F, etc.) créés à l'aide de cet outil. Si vous choisissez de créer un nouveau système de fichiers Version 9.0 sur le nœud en cours de migration, la création effective du nouveau système de fichiers n'aura lieu qu'une fois que vous aurez exécuté le travail facultatif BBOMMHFS ou BBOMMZFS pendant le processus de migration proprement dit. 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. Lisez les instructions générées et Migrer un nœud fédéré d' z/OS pour plus d'informations sur la spécification de ces variables.

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 BBOMMHFS ou BBOMMZFS.

Nom
Fichier de système de fichiers que vous créez et montez sur le point de montage.
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 indiquez 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 ce fichier 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 hiérarchique de fichiers (HFS)
Allouez et montez votre système de fichiers de configuration à l'aide de HFS.
Système ZFS (zSeries File System)
Allouez et montez votre système de fichiers de configuration à l'aide de ZFS.
Nom de la classe de stockage (facultatif)
Nom de la classe de stockage SMS pour le système de fichiers de configuration. Si aucun nom n'est affecté, les sous-programmes de sélection automatique de classe établis par l'administrateur de stockage déterminent la valeur.
Nom de la classe de gestion (facultatif)
Nom de la classe de gestion SMS pour le système de fichiers de configuration. Si aucun nom n'est affecté, les sous-programmes de sélection automatique de classe établis par l'administrateur de stockage déterminent la valeur.
Nom de la classe de données (facultatif)
Nom de la classe de données pour le système de fichiers de configuration. Si aucun nom n'est affecté, les sous-programmes de sélection automatique de classe établis par l'administrateur de stockage déterminent la valeur.

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 cataloguées pour l' z/OS doivent être copiées
WebSphere Application Server répertoire des produits
Emplacement de votre WebSphere Application Server Version 9.0 système de fichiers du produit installé
Lien symbolique intermédiaire
Sélectionnez cette option pour configurer un lien symbolique intermédiaire et indiquez 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.

Sélectionnez cette option pour indiquer le nom de chemin d'un lien symbolique intermédiaire. Ce lien est créé par les travaux de personnalisation et pointe 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

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é

Lorsque vous migrez vers la version 9.0, vous devez mettre à niveau vos procédures JCL lancées. Une nouvelle procédure est générée automatiquement 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

Lorsque vous migrez vers la version 9.0, vous devez mettre à niveau vos procédures JCL lancées. Une nouvelle procédure est générée automatiquement 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

Lorsque vous migrez vers la version 9.0, vous devez mettre à niveau vos procédures JCL lancées. Une nouvelle procédure est générée automatiquement en cours de migration. Vous pouvez soit indiquer un nouveau nom pour la procédure servants, soit utiliser l'ancien nom.

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

Lorsque vous migrez vers la version 9.0, vous devez mettre à niveau vos procédures JCL lancées. Une nouvelle procédure est générée automatiquement en cours de migration. Vous pouvez soit indiquer un nouveau nom pour la procédure adjoint, 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 WebSphere Application Server configuration doivent être mises à jour afin de correspondre aux nouveaux noms de procédure. 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 devez conserver les mêmes commandes START et remplacer manuellement les procédures à l'aide de la procédure générée lors de la migration en tant que modèle.

Remarques :
  1. Votre configuration d' 9.0 s de version doit utiliser des procédures JCL différentes de celles utilisées par votre configuration source. Le processus de migration crée de nouvelles procédures JCL Version 9.0 à l'aide des noms de procédure spécifiés.
  2. Si vous utilisez les mêmes noms que ceux utilisés dans la configuration source, le processus de migration écrase les procédures existantes. Par conséquent, si vous utilisez les mêmes noms, veillez à sauvegarder les procédures existantes avant d'exécuter les travaux de migration pour le cas où vous auriez besoin de procéder à une rétromigration.
  3. Si vous avez sélectionné l'option de migration clone, cette option n'est pas disponible.
ID utilisateur de l'administrateur WebSphere
Le processus de migration nécessite le recours à un client d'administration. Si la sécurité administrative est activée dans le profil source, sélectionnez l'option La sécurité administrative est activée. Indiquez un ID utilisateur d'administrateur WebSphere valide que le client d'administration va pouvoir utiliser pour s'authentifier. Sinon, désélectionnez l'option La sécurité administrative est activée.

Vous pouvez différer l'entrée d'un ID utilisateur et éditer plus tard manuellement les travaux BBOWMG3F, BBOWMPRO, BBOWMPRE ou BBOWMPOS. Pour différer, désélectionnez l'option La sécurité administrative est activée et 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. Si la sécurité administrative est activée dans le profil source, sélectionnez l'option La sécurité administrative est activée et indiquez un mot de passe administrateur WebSphere valide que le client administratif peut utiliser pour s'authentifier. Sinon, désélectionnez l'option La sécurité administrative est activée .

Si vous le souhaitez, vous pouvez différer l'entrée d'un mot de passe et éditer plus tard manuellement les travaux BBOWMG3F, BBOWMPRO, BBOWMPRE ou BBOWMPOS. Pour différer, désélectionnez l'option La sécurité administrative est activée et mettez à jour la variable TO_AdminPassword avec le mot de passe utilisateur approprié avant de soumettre le travail.

Personnalisation de serveur (Partie 2)

Migrer les paramètres personnalisés "Mes tâches" de la console d'administration
La fonctionnalité « Mes tâches » n'est prise en charge que dans la version 4.0 ou ultérieure d' WebSphere Application Server. 7.0
Migrer les paramètres "Mes tâches" sauvegardés dans l'emplacement racine utilisateur de l'espace de travail par défaut (wstemp)
Migrer les paramètres "Mes tâches" sauvegardés dans l'emplacement racine de l'espace de travail défini par l'utilisateur
Emplacement racine de l'espace de travail défini par l'utilisateur

Personnalisation du serveur (troisième partie)

Ce panneau s'affiche uniquement si vous avez sélectionné l'option de migration clone.

Noms abrégés
Nom abrégé du noeud
Indiquez un nouveau nom abrégé pour le nœud version 9.0.
Préfixe du nom abrégé du serveur
Indiquez un préfixe de nom abrégé pouvant contenir jusqu'à 3 caractères. Il est utilisé pour générer des noms abrégés uniques pour le serveur de la cellule de la version 9.0.

Options de processus de migration

Options de trace de la migration

Si vous choisissez d'activer le traçage, il reste activé tout au long du processus de migration.

Activer le traçage des scripts
Permet d'activer ou de désactiver la trace de la création de l'accueil, de l'appel des outils de création de profils et de migration et des phases de traitement finales de la migration
Activer le traçage de la création des profils
Permet d'activer ou de désactiver la trace pendant la création des profils
Activer le traçage de la pré-mise à niveau
Permet d'activer ou de désactiver la trace pendant le processus WASPreUpgrade
Activer le traçage de la post-mise à niveau
Permet d'activer ou de désactiver la trace pendant le processus WASPostUpgrade
Options JVM pour les processus de migration
Taille initiale du segment de mémoire (Mo)
Mémoire initiale allouée pour le segment de mémoire JVM.
Taille maximale du segment de mémoire (Mo)
Taille maximale de segment de mémoire qui peut être allouée pour le segment de mémoire JVM.
Emplacement du répertoire temporaire
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.

Identificateur de la définition de migration
Identificateur utilisé pour créer un répertoire sous le répertoire temporaire contenant les fichiers de migration temporaires et les données de configuration de sauvegarde.
Répertoire temporaire Java™
Vous pouvez spécifier un répertoire temporaire Java qui sera utilisé par la machine virtuelle Java pour créer et stocker des fichiers temporaires pendant la migration.
Définissez le répertoire Java temporaire
Emplacement du répertoire Java temporaire

Valeurs de port

Définissez les valeurs de port à utiliser dans le nouveau profil et indiquez comment gérer les conflits de port. Si vous réutilisez des valeurs de port à partir de l'ancien profil, le nouveau profil ne peut pas être exécuté en même temps que l'ancien profil en raison de conflits de ports. Si vous avez l'intention d'exécuter simultanément les deux profils, assurez-vous que chaque profil utilise des ports différents.

Si vous avez sélectionné l'option de migration clone, le seul paramètre de port compatible consiste à générer de nouveaux ports, par incréments à partir d'une valeur de port de départ.

Utilisez les mêmes ports que l'ancien profil a utilisés
Réutilisez les valeurs de port qui sont définies dans le profil source.

Ce panneau n'est pas disponible si vous avez sélectionné l'option de migration clone.

Générez de nouveaux ports, en incrémentant d'une valeur de port de départ commune
Générez de nouveaux ports en incrémentant à partir de la valeur de port spécifiée. Les ports conflictuels sont automatiquement résolus.
Résolution des conflits de port
Choisissez comment résoudre les conflits de ports.

Ce panneau n'est pas disponible si vous avez sélectionné l'option de migration clone.

Incrémenter à partir de la valeur du port conflictuel
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.
Incrémenter à partir d'une valeur de port de départ commune
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.

Définition de l'instruction de travail

Une instruction de travail est 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éactualise automatiquement le nom du travail dans tous les travaux générés. Vous n'avez donc pas à 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.