Effectuez la migration d'un gestionnaire de déploiement d'une ancienne version de
WebSphere ESB vers une nouvelle version à l'aide d'outils de ligne de commande.
Avant de commencer
Remarque : Dans une cellule de WebSphere ESB Network Deployment, le gestionnaire de déploiement doit toujours être dans un profil WebSphere ESB.
Remarque : Procédez à la migration du gestionnaire de déploiement
WebSphere ESB version 6.0.x ou 6.1.x vers
version 6.2 avant de faire migrer les noeuds gérés comprenant la cellule. Le gestionnaire de déploiement doit toujours se trouver au niveau d'édition et de correctifs le plus élevé au sein d'une cellule, afin de pouvoir gérer tous les noeuds que celle-ci contient.
Un gestionnaire de déploiement version 6.2 peut gérer des noeuds gérés version 6.1.x et version 6.2. Pour les migrations depuis la version 6.1.x,
les cellules peuvent alors êtres mises à niveau vers la nouvelle édition, noeud par noeud, avec le minimum d'impact sur les applications exécutées au sein de la cellule.. Pour les migrations à partir de version 6.0.2.x, pour maintenir au minimum l'indisponibilité de la cellule, il est nécessaire de migrer vers version 6.2 en deux étapes : d'abord de la version 6.0.2.x vers la version 6.1.x, puis de la version 6.1.x vers la version 6.2. Mais il est également possible d'arrêter entièrement la cellule et de migrer en une seule étape, directement de la version 6.0.2.x vers la version 6.2.
Les membres d'un cluster ne peuvent exécuter des versions différentes (6.0.2.x, 6.1.x, 6.2) de WebSphere ESB.
Si vous avez configuré un cluster contenant des serveurs exécutant des versions différentes, tous les membres exécutant des versions précédentes de WebSphere ESB devront être arrêtés avant que vous ne démarriez le premier membre de cluster de la version 6.2.
En outre, une fois que vous avez démarré un membre de cluster de la version 6.2, ne démarrez pas de membre de cluster version 6.0.x ou 6.1.x appartenant à ce cluster.
Assurez-vous que les
conditions suivantes sont remplies avant de démarrer le processus de migration :
- Votre système répond à toutes les exigences matérielles et logicielles pour la nouvelle
version de WebSphere ESB.
- Vous avez installé la nouvelle version de WebSphere ESB à côté de la version antérieure sur le même système.
- Un profil de gestionnaire de déploiement créé sous l'ancienne version de WebSphere ESB,
réside sur le même système.
- L'espace disque disponible est suffisant pour contenir le profil migré et sa sauvegarde. Voir Remarques relatives à la pré-migration pour WebSphere ESB pour plus de détails sur les exigences relatives à l'espace disque.
Assurez-vous d'avoir exécuté les tâches suivantes avant de lancer la migration :
- Sauvegardez les bases de données prenant en charge les composants version 6.0.2.x ou version 6.1.x WebSphere ESB.
Procédure
- Ouvrir une session par l'une des procédures suivantes, en fonction de votre système d'exploitation.
Sur les plateformes i5/OS : Ouvrez une session sous un
profil utilisateur i5/OS de classe utilisateur *SECOFR ou doté de droits spéciaux *ALLOBJ.

Sur les plateformes Linux® et UNIX® : Connectez-vous en tant que root.
Sur les plateformes Windows® : Connectez-vous en tant que membre du groupe Administrateur.
- Identifiez à l'avance les informations préexistantes requises par l'assistant de migration, comme indiqué ci-après :
- Nom de la cellule
- Nom de la cellule gérée par le gestionnaire de déploiement dont vous effectuez la migration. Le nom de cellule sous la nouvelle version
doit correspondre à celui de la configuration sous l'ancienne version.
- Nom du noeud
- Nom du noeud dont vous effectuez la migration. Le nom de noeud de la nouvelle version doit correspondre à celui figurant dans la configuration de l'ancienne version.
- Arrêtez le gestionnaire de déploiement à migrer. Lancez la commande stopManager à partir du répertoire
rép_profil/bin du gestionnaire de déploiement ou partir de la console Premiers pas de ce gestionnaire.
Pour plus d'informations sur la commande stopServer, voir la rubrique
stopServer. Utilisez la syntaxe suivante :Remarque : Sur les plateformes i5/OS, vous devez exécuter les scripts sous QSHELL. Pour lancer une session QSHELL, ouvrez une invite de ligne de commande et entrez QSH.
Sur les plateformes i5/OS : racine_profil/bin/stopManager

Sur les plateformes Linux et UNIX : racine_profil/bin/stopManager.sh
Sur les plateformes Windows : racine_profil\bin\stopManager.bat
Si la sécurité est activée, utilisez plutôt l'une des commandes suivantes.
Le nom d'utilisateur saisi doit être membre du rôle opérateur ou administrateur.
Sur les plateformes i5/OS : racine_profil/bin/stopManager -username ID_utilisateur -password mot_de_passe

Sur les plateformes Linux et UNIX : racine_profil/bin/stopManager.sh -username ID_utilisateur -password mot_de_passe
Sur les plateformes Windows : racine_profil\bin\stopManager.bat -username user_ID -password mot_de_passe
Remarque : Vous devez arrêter le gestionnaire de déploiement de la version précédente avant de démarrer le processus de migration. Si vous ne le faites pas, les modifications de configuration que vous effectuez pendant le processus de migration ne seront pas migrées vers le profil cible.
- Exécutez la commande WBIPreUpgrade,
en spécifiant le nom du répertoire de sauvegarde de la migration et le nom du répertoire WebSphere ESB existant. L'outil WBIPreUpgrade enregistre les fichiers sélectionnés dans les répertoires racine_installation et racine_profil dans le répertoire de sauvegarde que vous avez défini. Voir Utilitaire de ligne de commande WBIPreUpgrade pour
plus de détails.
- Exécutez manuellement la commande WBIPostUpgrade
en spécifiant le nom du répertoire de sauvegarde de la migration. L'outil WBIPostUpgrade restaure la configuration sauvegardée dans le répertoire de sauvegarde vers le nouveau profil WebSphere ESB Deployment Manager. Voir Utilitaire de ligne de commande WBIPostUpgrade pour
plus de détails.
Important : Utilisez le paramètre
-createTargetProfile lorsque
WBIPostUpgrade est appelé. Cette option crée un nouveau profil cible correspondant nécessaire à la migration. Pour plus d'informations sur les profils cible, reportez-vous à
Remarques sur les profils cible.
Remarque : Si vous migrez sur une
plateforme i5/OS, le nom du profil cible doit correspondre au nom du profil source migré.
Si vous migrez depuis version 6.0.2 vers version 6.2.x, vous devez créer la base de données commune.
Pour plus d'informations, voir Creating
the common database and configuring the recovery subsystem when migrating from
version 6.0.2 to version 6.2.x.

- Si vous devez mettre à jour la base de données commune manuellement, faites-le maintenant.
Remarque : Cette tâche ne s'applique qu'à la migration de la version 6.1 vers la version
6.2.
Voir Mise à niveau manuelle de la base de données commune pour obtenir des instructions.
En principe, les modifications de base de données requises par les nouvelles versions de WebSphere ESB ont lieu automatiquement. Lors du premier démarrage du serveur, les tables de base de données sont migrées vers la nouvelle version de schéma. Toutefois, lorsque les droits d'accès au schéma de base de données sont insuffisants, ou lorsque d'autres exigences relatives à la base de données ne sont pas remplies, vous devez mettre à jour la base de données manuellement.
- Démarrez le gestionnaire de déploiement de version 6.2.
ATTENTION :
Au démarrage du gestionnaire de déploiement version 6.2, les noeuds fédérés se synchronisent avec le gestionnaire de déploiement migré. Cette synchronisation entraîne la réinstallation des applications. Si une application est en cours d'exécution sur des serveurs actifs, cette application semblera redémarrer et sera brièvement indisponible.
Pour démarrer le gestionnaire de déploiement, utilisez la commande startManager depuis le répertoire rép_profil/bin de la console Premiers pas. Voir Commande startManager pour plus d'informations sur la commande startManager.
- Facultatif : Désinstallez le gestionnaire de déploiement de version 6.0.x ou 6.1.x.
N'effectuez cette procédure que si vous êtes certain que la
migration de la configuration du gestionnaire de déploiement que vous prévoyez de supprimer a abouti. Pour plus d'informations sur la désinstallation, voir la rubrique Désinstallation du logiciel.
Résultats
La migration du gestionnaire de déploiement est à présent terminée.
Que faire ensuite
Vérifiez que la migration s'est correctement terminée.