Les profils d'agent d'administration gèrent plusieurs serveurs d'applications
de base dans des environnements de développement ou de test d'unité, ou dans la
partie d'un parc de serveurs qui réside sur une machine unique. Avant de pouvoir faire migrer des serveurs
d'applications de base gérés depuis Version 7.0 ou ultérieures vers Version 9.0, vous devez tout d'abord faire migrer l'agent d'administration.
Avant de commencer
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
Examinez les informations relatives à la planification de la migration. Voir Knowledge Collection: Migration planning for WebSphere Application Server.
Vous pouvez faire migrer les profils d'agent
d'administration et l'ensemble enregistré de serveurs d'applications de base
gérés depuis Version 7.0 ou ultérieures vers la Version 9.0.
Pourquoi et quand exécuter cette tâche
Cette tâche décrit comment utiliser l'outil de gestion des migrations
de configuration z/OS afin de migrer un agent d'administration et son ensemble associé
de serveurs d'applications de base gérés à partir de WebSphere
Application Server Version 7.0 ou ultérieures vers Version 9.0. Un serveur d'applications
de base devient géré lorsqu'il est enregistré avec un seul agent d'administration. Un agent
d'administration peut gérer un ou plusieurs serveurs d'applications de base
et doit être au même niveau de version et se trouver sur la même machine que les serveurs
d'applications de base qu'il gère. Sous z/OS, seule la Version 7.0 ou ultérieures ou l'agent
d'administration Version 9.0 peut être en cours d'exécution. Les instructions
suivantes vous indiquent quand démarrer et arrêter l'ancien et le nouvel agent agent d'administration.
Cette restriction requiert que tous les serveurs d'applications de base gérés soient migrés en même temps.
Eviter les incidents: Lors de la migration du serveur d'applications de base géré dans un environnement de gestion flexible, vérifiez que les noms de noeud sont identiques dans
Version 9.0 et les versions précédentes.
gotcha
Procédure
- Sauvegardez la configuration de noeud et d'agent d'administration source en exécutant la commande backupConfig.
La commande backupConfig enregistre la configuration de noeud et d'agent d'administration dans un fichier que vous pouvez utiliser ultérieurement à des fins de récupération.
- Accédez au répertoire racine_profil_agent_administration/bin.
- Exécutez la commande backupConfig avec
les paramètres appropriés sur l'agent d'administration et tous les serveurs
d'applications de base gérés. Exemple :
/opt/WebSphereV70/profiles/v70dmgr01/bin/backupConfig.sh
/mybackupdir/v70dmgr01backupBeforeV90migration.zip
-username myuser -password mypass -nostop
- Pour chaque noeud de la configuration, accédez au répertoire racine_profil/bin.
- Exécutez la commande backupConfig avec les paramètres
appropriés et sauvegardez la configuration de profil en cours dans un fichier. Exemple :
/opt/WebSphereV70/profiles/v70mas01/bin/backupConfig.sh
/mybackupdir/v70mas01rbackupBeforeV90migration.zip
-username myuser -password mypass -nostop
Vous pouvez également utiliser la commande PAX pour sauvegarder tous les fichiers HFS. Pour plus d'informations, voir Using the z/OS UNIX pax command.
- Installez WebSphere Application Server for z/OS
Version 9.0 sur chaque hôte cible.
Pour plus d'informations, reportez-vous à la documentation d'installation.
- Définissez la nouvelle une configuration de migration d'agent d'administration dans l'outil
de gestion des migrations z/OS.
Utilisez cet outil pour créer une définition de migration
et téléchargez les travaux pour la migration de l'agent d'administration.
Eviter les incidents: Le nom de la cellule
Version 9.0 doit correspondre
au nom de la cellule figurant dans la configuration de
Version 7.0 ou ultérieures. Si vous créez un profil
avec un nouveau nom de cellule, la migration échoue.
gotcha
- Remplissez la feuille de travail suivante : Feuille de travail pour la spécification d'une configuration de migration d'un gestionnaire de déploiement dans z/OS Migration Management Tool
- Dans le panneau Sélection d'un type de noeud à migrer, sélectionnez
Migration d'un agent d'administration.
- Renseignez les zones des panneaux suivants en utilisant les valeurs de votre feuille de travail.
- Consultez la définition de migration d'agent d'administration afin de vous assurer que toutes les valeurs sont correctes.
- Dans le tableau des définitions de migration WebSphere Application Server for z/OS , sélectionnez la définition de migration à vérifier.
- Cliquez sur Afficher.
- Pour obtenir des informations sur la définition de migration, cliquez sur Récapitulatif, Instructions ou sur Fichier de réponses.
- Téléchargez les journaux de migration sur le système z/OS cible.
- Vérifiez que tous les travaux en cours sont terminés sur les profils gérés.
Avant d'exécuter la commande WASPreUpgrade sur un serveur
d'applications géré ou un gestionnaire de déploiement, tous les travaux en cours doivent être terminés.
- Si l'agent administratif est enregistré auprès d'un gestionnaire de travaux, cessez d'interroger le gestionnaire de travaux.
Pour plus d'informations sur la façon d'arrêter le gestionnaire de travaux, reportez-vous au groupe de commandes ManagedNodeAgent pour l'objet AdminTask à l'aide du script wsadmin.
- Exécutez les tâches de migration pour l'agent administratif en suivant les instructions dans la vue Instructions de migration de l'outil de gestion de migrations z/OS ou dans le membre BBOMAINS de l'ensemble de données CNTL que vous avez téléchargé sur le système z/OS cible.
Les étapes
CRPROF (profile create), PREUPGRD (preUpgrade) et UPGRADE sont toutes
exécutées lors de ce processus.
- Vérifiez toutes les sorties créées dans le répertoire de
travail de HFS/ZFS (définition dans ZMMT) et toutes les sorties
de travail MVS créées par les travaux par lots.
Assurez-vous d'obtenir des codes retour 0 et consultez les fichiers
journaux dans le répertoire temporaire de migration sur le système de fichiers
de configuration.
Le répertoire temporaire de migration est emplacement_répertoire_temporaire/nnnnn, où emplacement_répertoire_temporaire est la valeur spécifiée pour
l'emplacement du répertoire temporaire et nnnnn est la valeur numérique qui a été générée pour l'identificateur
de migration lorsque vous avez généré vos travaux de migration. L'emplacement du répertoire temporaire par défaut est /tmp/migrate.
- Spécifiez une configuration de migration d'application gérée dans z/OS
Migration Management Tool.
Utilisez z/OS Migration Management Tool pour
créer une définition de migration et télécharger les travaux de migration des
serveurs d'applications de base gérés.
Eviter les incidents: Le nom de la cellule
Version 9.0 doit correspondre
au nom de la cellule figurant dans la configuration de
Version 7.0 ou ultérieures. Si vous créez un profil
avec un nouveau nom de cellule, la migration échoue.
gotcha
- Remplissez la feuille de travail suivante : Feuille de travail pour la spécification d'une configuration de migration de noeud fédéré dans z/OS Migration Management Tool
- Dans le panneau Sélection d'un type de noeud à migrer, sélectionnez l'option
permettant d'exécuter une migration d'un serveur d'applications de base géré.
- Renseignez les zones des panneaux suivants en utilisant les valeurs de votre feuille de travail.
- Consultez la définition de migration de noeud fédéré afin de vous assurer que toutes les valeurs sont correctes.
- Dans le tableau des définitions de migration WebSphere Application Server for z/OS , sélectionnez la définition de migration à vérifier.
- Cliquez sur Afficher.
- Pour obtenir des informations sur la définition de migration, cliquez sur Récapitulatif, Instructions ou sur Fichier de réponses.
- Téléchargez les journaux de migration sur le système z/OS cible.
- Exécutez les tâches de migration pour le serveur d'applications de base géré en suivant les instructions dans la vue Instructions de migration de l'outil de gestion de migrations z/OS ou dans le membre BBOMDINS de l'ensemble de données CNTL que vous avez téléchargé sur le système z/OS cible.
Les étapes
CRPROF (profile create), PREUPGRD (preUpgrade) et UPGRADE sont toutes
exécutées lors de ce processus.
Eviter les incidents: - Assurez-vous que l'agent administratif source est en cours d'exécution afin que le serveur d'applications peut être désenregistré auprès de l'agent administratif.
- Si le serveur d'applications géré est également
enregistré auprès d'un gestionnaire de travaux, vous devez annuler cet enregistrement
avant d'exécuter la migration d'un serveur d'applications géré. Une fois la migration
terminée, effectuez à nouveau l'enregistrement sur l'agent d'administration et le gestionnaire
de travaux.
gotcha
- Vérifiez toutes les sorties créées dans le répertoire de
travail de HFS (définition dans ZMMT) et toutes les sorties
de travail MVS créées par les travaux par lots.
Assurez-vous d'obtenir des codes retour 0 et consultez les fichiers
journaux dans le répertoire temporaire de migration sur le système de fichiers
de configuration.
Le répertoire temporaire de migration est emplacement_répertoire_temporaire/nnnnn, où emplacement_répertoire_temporaire est la valeur spécifiée pour l'emplacement du répertoire temporaire et nnnnn, la valeur numérique qui a été générée pour l'identificateur
de migration lorsque vous avez généré vos travaux de migration. L'emplacement du répertoire temporaire par défaut est /tmp/migrate.
- Accédez au nouvel Version 9.0 agent d'administration migré.
Eviter les incidents: Assurez-vous que tous les serveurs d'applications gérés
enregistrés auprès de l'ancien agent d'administration sont migrés. L'annulation de leur enregistrement doit
avoir été effectuée lors du processus de migration.
gotcha
- Arrêtez l'ancien agent d'administration Version 7.0 ou ultérieures.
- Démarrez le nouvel agent d'administration Version 9.0.
- Démarrez le serveur d'applications géré.
- Démarrez chaque serveur d'applications de base géré.
- Enregistrez chaque serveur d'applications géré auprès du nouvel agent d'administration.
Recherchez les erreurs dans les journaux de l'agent de noeud.
- Démarrez l'interrogration du gestionnaire de travaux.
Pour plus d'informations, reportez-vous à la section relative au groupe de commandes ManagedNodeAgent pour l'objet AdminTask à l'aide du script wsadmin.
Résultats
Vous avez migré un profil d'agent d'administration et ses serveurs d'applications
de base gérés associés de WebSphere
Application Server Version 7.0 ou ultérieures vers Version 9.0 à l'aide des outils de migration.