Exécutez l'assistant de migration sous AIX, HP-UX, Linux®, Solaris ou Windows®
pour faire migrer WebSphere ESB.
Avant de commencer
Vérifiez que vous avez exécuté les étapes nécessaires qui précèdent l'étape de l'appel de l'assistant de migration. Ces étapes varient selon que vous migrez un serveur autonome, un gestionnaire de déploiement, un noeud non géré n'appartenant pas à un cluster ou un cluster.
Pourquoi et quand exécuter cette tâche
L'exécution de l'assistant de migration est simplement une étape d'une série d'étapes qui doivent être exécutées pour migrer
WebSphere Process Server de la
version 6.0.x ou 6.1.x vers la
version 6.2.
Remarque : Si vous disposez d'un profil WebSphere Application Server
créé dans un environnement WebSphere ESB, vous devez utiliser les outils de ligne de commande WebSphere ESB pour le migrer. Si vous disposez d'un profil WebSphere ESB créé dans un environnement WebSphere ESB, vous pouvez utiliser l'assistant de migration ou les outils de ligne de commande pour le migrer.
Remarque : L'assistant de migration ne fonctionne pas dans les environnements non graphiques La plateforme
i5/OS ou les sessions telnet sont des exemples d'environnements non graphiques. Si vous souhaitez exécuter une migration en environnement non graphique, utilisez les commandes
WBIPreUpgrade et
WBIPostUpgrade.
Procédure
- Sur l'écran Bienvenue dans l'assistant Migration de WebSphere
Process Server, découvrez dans l'écran d'accueil comment fonctionne le processus de migration, puis cliquez sur Suivant.
- Sur l'écran Version détectée de WebSphere Process Server, sélectionnez ou spécifiez une version antérieure de WebSphere ESB à partir de laquelle vous souhaitez effectuer la migration, puis cliquez sur Suivant.
Cochez la case et entrez l'emplacement de l'installation précédente si elle n'apparaît pas dans la liste de sélection.
- Sur l'écran Sélection du profil source, sélectionnez le profil de la version précédente de WebSphere ESB que vous souhaitez faire migrer et cliquez sur Suivant.
- Dans l'écran Sélection du profil cible,
sélectionnez Créer un profile pour créer un profil cible vide pour la migration. Vous pouvez également sélectionner un profil dans la liste des profils valides de l'installation version 6.2,
mais il est recommandé d'utiliser un nouveau profil cible pour la
migration. Pour plus d'informations sur la création de profils cible pour la migration, reportez-vous à Remarques sur les profils cible.
- Si vous avez sélectionné Créer un nouveau profil, entrez
le nom du profil et laissez le nom d'hôte tel que (nom du système sur lequel résidera le profil), puis cliquez sur Suivant.
Remarque : Il est recommandé de ne pas changer le nom d'hôte, mais si vous le changez pour une quelconque raison, après la migration, vous devez le mettre à jour manuellement dans les autres emplacements où il est défini.
- Sauvegardez le profil cible avant de cliquer
sur Suivant. Pour décider si vous souhaitez sauvegarder votre configuration de profil cible, considérez les options suivantes :
- Si vous avez sélectionné un profil existant, sauvegardez la configuration du profil cible. Utilisez la commande backupConfig pour la sauvegarder avant de poursuivre.
- Si vous migrez un noeud géré, la migration aura pour effet de modifier la
configuration du gestionnaire de déploiement. Il convient d'utiliser la commande backupConfig pour sauvegarder la configuration du gestionnaire de déploiement avant de poursuivre.
- Sur l'écran Répertoire de sauvegarde pour migration, spécifiez un répertoire de sauvegarde pour migration dans lequel sera placée une copie de sauvegarde de la configuration de la version précédente. Selon la version WebSphere ESB depuis laquelle vous migrez, les options suivantes apparaissent sur l'écran :
- Migration à partir de version 6.0.2.x :
Au cours d'une
migration de la version 6.0.2.x vers la version 6.2, l'opération de sauvegarde sauvegarde tous les profils créés sous l'installation WebSphere ESB version 6.0.2.x.
- S'il s'agit du premier ou du seul profil que vous migrez pour cette installation de WebSphere ESB,
laissez la case Sauvegarder tous les profils existants cochée. Si le répertoire n'existe pas déjà, il est créé.
Si le répertoire existe, il convient qu'il soit vide, car l'opération de sauvegarde risque de remplacer les fichiers de sauvegarde existants.
- Si vous avez déjà migré un autre profil pour cette installation de WebSphere ESB et que vous n'avez apporté aucune modification à la configuration, vous pouvez choisir de ne pas
sauvegarder la configuration précédente à ce stade de l'assistant de migration. Dans ce cas, vous pouvez décocher la case Sauvegarder tous les profils existants et vous assurer que le nom du répertoire de sauvegarde est le même que celui indiqué lors de la précédente migration.
- Migration à partir de version 6.1.x :
Au cours d'une
migration de la version 6.1.x vers la version 6.2, l'opération de sauvegarde sauvegarde uniquement le profil spécifié devant être migré depuis l'installation WebSphere ESB version 6.1.x.
- Si le répertoire n'existe pas, il est créé au cours de la migration.
- Si le répertoire existe, il convient qu'il soit vide, car l'opération de sauvegarde risque de remplacer les fichiers de sauvegarde existants.
Entrez les informations sur le répertoire principal, puis cliquez sur
Suivant.
- Sur l'écran Paramètres de migration pour les applications, indiquez où les applications migrées doivent être situées, puis cliquez sur Suivant.
Remarque : L'écran Paramètres de migration des applications s'affiche uniquement si vous migrez depuis la version 6.0.2.x vers la version 6.2.
Vous pouvez sélectionner l'une des options suivantes :
- Dans l'écran Option relative au gestionnaire de déploiement, vous pouvez sélectionner éventuellement Ne désactivez pas le gestionnaire de déploiement de la version précédente. Il est recommandé de laisser cette option désélectionnée pour éviter les conflits avec le gestionnaire de déploiement version 6.2.
Remarque : L'écran Option relative au gestionnaire de déploiement apparaît uniquement si vous migrez de la version 6.0.2.x vers la version 6.2.
- Sur l'écran Affectation des valeurs de port, sélectionnez l'une des options pour attribuer les valeurs de port, puis cliquez sur Suivant.
Remarque : L'écran Attribution des valeurs de port apparaît uniquement si vous migrez depuis la version 6.0.2.x vers la version 6.2.
Vous pouvez appliquer l'une des actions suivantes aux valeurs de port :
- Sur l'écran Options supplémentaires de migration,
saisissez les informations suivantes, puis cliquez sur Suivant.
Important : La case Prendre en charge les scripts 6.0.x dans le profil cible ne sera visible que si vous migrez depuis version 6.0.2.x.
- Case Prendre en charge les scripts 6.0.x dans le profil cible : Si vous migrez à partir de version 6.0.2.x,
vous pouvez cocher cette case lorsque vous voulez migrer afin de prendre en charge la compatibilité des scripts. Si vous sélectionnez cette option, l'assistant de migration crée les définitions de configuration
suivantes pour version 6.0.2.x de WebSphere ESB :
- Transport
- ProcessDef
- 6.0.2 SSL
- 6.0.2 ORB service threadpool
au lieu des définitions de configuration
version 6.2 suivantes :
- Channels
- ProcessDefs
- version 6.2 SSL
- version 6.2 pool d'unités d'exécution ORB
Sélectionnez cette option pour réduire l'impact sur les scripts d'administration existants. Si vous disposez de scripts ou programmes wsadmin existants
qui utilisent des API de configuration tierce partie pour créer ou modifier les définitions de configuration existantes, par exemple, vous pouvez spécifier cette option durant la migration.
Remarque : Cet état est transitoire ; il ne dure que jusqu'à ce que tous les noeuds présents dans
l'environnement soient au niveau le plus récent (par exemple
WebSphere ESB
version 6.2). Lorsqu'ils sont au dernier niveau, vous devez accomplir les procédures suivantes :
- Modifiez les scripts d'administration afin d'utiliser tous les paramètres de la nouvelle version (ici, version 6.2).
- Utilisez la commande convertScriptCompatibility
pour convertir vos configurations de manière à ce qu'elles correspondent à tous les paramètres de la nouvelle version.
Voir la rubrique
Commande 'convertScriptCompatibility'.
Remarque : Lorsque vous suivez les indications de ce lien pour utiliser la commande
convertScriptCompatibility,
exécutez la commande WBIPostUpgrade plutôt que WASPostUpgrade.
- Case Saisir les données d'identification de
sécurité : Si la sécurité n'a pas été activée pour la précédente
version de WebSphere ESB, assurez-vous
que cette case est décochée et cliquez sur Suivant.
Si la sécurité
d'administration a été activée pour la version de
WebSphere ESB que vous êtes en train de migrer, la case Saisir les données d'identification de sécurité doit être cochée et les nom d'utilisateur et mot de passe saisis dans les zones correspondantes.
Si l'assistant de migration détecte les nom d'utilisateur et mot de passe
configurés dans la précédente version de WebSphere ESB, la case
Saisir les données d'identification de sécurité sera
automatiquement cochée et les nom d'utilisateur et mot de passe corrects
automatiquement configurés dans les zones correspondantes.
Si cela se produit, vérifiez que le nom
d'utilisateur saisi est correct (le mot de passe sera masqué), puis cliquez sur Suivant.
Si la sécurité a été activée pour la précédente version mais que l'assistant de
migration ne parvient pas à détecter les nom d'utilisateur et mot de passe, il
cochera la case
Saisir les données d'identification de
sécurité en laissant les zones Nom d'utilisateur et Mot de passe
vierges. Si cela se produit, entrez les nom d'utilisateur et mot de passe (les mêmes que ceux qui servaient à la sécurité d'administration dans la précédente version), puis
cliquez sur
Suivant.
Remarque : Le fait que l'assistant puise ou non détecter les nom d'utilisateur et mot de passe dépend de la version de WebSphere ESB depuis laquelle vous effectuez la migration.
- Sur l'écran Récapitulatif de la migration, consultez les informations récapitulatives et assurez-vous qu'elles sont
correctes, puis cliquez sur Suivant pour lancer la migration. Au cours de la migration, les panneaux suivants peuvent apparaître :
- Si vous avez sélectionné l'option de création d'un nouveau profil cible, les écrans afficheront le début et les résultats de cette création.
- Des écrans indiquent la progression du processus de migration.
- Si la migration échoue, l'assistant affiche un écran d'échec. Si la migration aboutit partiellement, l'assistant affiche un écran d'avertissement. Corrigez les problèmes éventuels et reprenez la procédure de migration.
- Si la post-migration aboutit, l'assistant vous en avertit.
- Cliquez sur Terminer pour quitter l'assistant de migration.
Résultats
Vous pouvez maintenant lancer le serveur migré dans l'environnement WebSphere ESB au dernier niveau.