Effectuez la migration d'un serveur autonome entre une ancienne et une nouvelle version de WebSphere ESB à l'aide des outils de ligne de commande.
Avant de commencer
Remarque : Lorsque vous effectuez une migration à l'aide des outils de ligne de commande, vous pouvez migrer un profil
WebSphere ESB ou un profil
WebSphere Application Server.
Assurez-vous que les
conditions suivantes sont remplies avant de démarrer le processus de migration :
- Vérifiez que votre système est conforme à la configuration matérielle et logicielle requise pour installer WebSphere ESB version 6.2 et qu'il contient un volume d'espace suffisant (y compris d'espace temporaire) pour l'installation à effectuer.
Voir http://www.ibm.com/support/docview.wss?uid=swg27006912 pour
plus de détails.
- Si vous effectuez une migration sur le même ordinateur physique que celui qui héberge
l'ancienne version de WebSphere ESB,
cela signifie que vous avez installé la nouvelle version de WebSphere ESB conjointement à l'ancienne version sur le même système.
- Le profil de l'ancienne version de WebSphere ESB que vous migrez est
autonome (non fédéré dans une cellule).
- L'espace disque disponible est suffisant pour contenir le profil migré et sa sauvegarde. Voir Remarques relatives à la pré-migration pour WebSphere ESB pour 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.
- Arrêtez le serveur version 6.0.x ou 6.1.x si celui-ci est en cours d'exécution sur le noeud à faire migrer. Utilisez la commande stopServer à partir du répertoire rép_profil/bin pour le profil du serveur concerné, ou arrêtez le serveur à partir de la console Premiers pas du profil.
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 commande CL et tapez QSH.
Sur les plateformes i5/OS : racine_profil/bin/stopServer/nom_serveur

Sur les plateformes Linux et UNIX : racine_profil/bin/stopServer.sh nom_serveur
Sur les plateformes Windows : racine_profil\bin\stopServer.bat nom_serveur
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/stopServer nom_serveur -username ID_utilisateur -password mot-de-passe

Sur les plateformes Linux et UNIX : racine_profil/bin/stopServer.sh nom_serveur -username ID_utilisateur -password motdepasse
Sur les plateformes Windows : racine_profil\bin\stopServer.bat nom_serveur -username ID_utilisateur -password motdepasse
Sous Windows, même si la sécurité est activée, il n'est pas nécessaire de spécifier les paramètres -username et -password si le serveur s'exécute en tant que service Windows. Dans ce cas, les paramètres sont transmis automatiquement au script utilisé par le service Windows pour arrêter le système.
Remarque : Arrêtez le serveur avant de commencer le processus de migration. Par défaut, tous les serveurs du
noeud seront arrêtés avant que s'achève la migration.
- 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 l'environnement contenu dans le répertoire de sauvegarde vers la nouvelle installation du serveur autonome WebSphere ESB. 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 nécessaire, effectuez la mise à jour manuelle des bases de données utilisées
par WebSphere ESB. Certaines modifications de base de données requises par de nouvelles versions de WebSphere ESB se font automatiquement. Toutefois, si
Business Space est configuré ou si le serveur ne dispose pas de permissions
suffisantes pour accéder au schéma de base de données ou que d'autres exigences spécifiques aux bases de données ne
sont pas satisfaites, vous devrez mettre à jour la base de données manuellement. Pour plus d'informations,
reportez-vous à la rubrique Mise à niveau des bases de données en vue d'une migration.
Résultats
Vous venez d'effectuer la migration de votre serveur autonome.
Que faire ensuite
Vérifiez que la migration s'est correctement terminée.