WebSphere Enterprise Service Bus, Version 6.2.0 Systèmes d'exploitation: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


Migration des noeuds gérés non groupés à l'aide des outils de ligne de commande

Effectuez la migration des noeuds gérés non groupés d'une ancienne version vers une version plus récente 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 :
  • 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 sur le système où réside la version précédente.
  • Un profil fédéré, 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 les exigences relatives à l'espace disque.
  • Le gestionnaire de déploiement qui administre le noeud géré que vous prévoyez de faire migrer a déjà été migré vers la version plus récente de WebSphere ESB, et est en cours d'exécution.
    Remarque : La migration d'un noeud géré WebSphere ESB version 6.0.x ou 6.1.x vers un noeud géré version 6.2 nécessite la migration préalable du gestionnaire de déploiement version 6.0.x ou 6.1.x vers un gestionnaire de déploiement version 6.2. Voir Migration d'un gestionnaire de déploiement pour obtenir des instructions. Procédez à la migration du gestionnaire de déploiement avant d'exécuter les instructions de la présente rubrique.
Assurez-vous d'avoir exécuté les tâches suivantes avant de lancer la migration :
  • Sauvegarde des bases de données supportant les composants version 6.0.x ou 6.1.x WebSphere ESB.

Pourquoi et quand exécuter cette tâche

Après avoir migré un gestionnaire de déploiement version 6.0.2.x vers une nouvelle version de WebSphere ESB, le gestionnaire de déploiement de la nouvelle version s'exécute par défaut en mode de compatibilité dans lequel il peut gérer l'ancienne et la nouvelle versions de WebSphere ESB. Par exemple, après la migration, un gestionnaire de déploiement version 6.2 peut gérer les noeuds version 6.0.2.x et version 6.2. En d'autres termes, les noeuds gérés version 6.0.2.x peuvent s'exécuter avec le gestionnaire de déploiement version 6.2. Dans un deuxième temps, vous pouvez migrer chaque noeud géré version 6.0.2.x WebSphere ESB (serveur géré par un gestionnaire de déploiement version 6.2) vers un noeud géré version 6.2. Après avoir fait migrer tous les noeuds gérés de la version 6.0.2.x, utilisez le script convertScriptCompatibility pour convertir leur configuration d'un mode prenant en charge la compatibilité des scripts d'administration version 6.0.2.x vers un mode qui soit totalement dans un modèle version 6.2 de configuration. 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.
Procédure
  1. Ouvrir une session par l'une des procédures suivantes, en fonction de votre système d'exploitation.
    • For i5/OS operating system 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.
    • For Linux operating systemFor UNIX operating system Sur les plateformes Linux® et UNIX® : Connectez-vous en tant que root.
    • For Windows operating system Sur les plateformes Windows® : Connectez-vous en tant que membre du groupe Administrateur.
  2. 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.
    • For i5/OS operating system Sur les plateformes i5/OS : racine_profil/bin/stopServer/nom_serveur
    • For Linux operating systemFor UNIX operating system Sur les plateformes Linux et UNIX : racine_profil/bin/stopServer.sh nom_serveur
    • For Windows operating system 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.
    • For i5/OS operating system Sur les plateformes i5/OS : racine_profil/bin/stopServer nom_serveur -username ID_utilisateur -password mot-de-passe
    • For Linux operating systemFor UNIX operating system Sur les plateformes Linux et UNIX : racine_profil/bin/stopServer.sh nom_serveur -username ID_utilisateur -password motdepasse
    • For Windows operating system 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.
  3. Arrêtez l'agent du noeud à faire migrer. Exécutez l'une des commandes suivantes, selon la plateforme utilisée, pour arrêter le processus nodeagent (où racine_profil représente le répertoire d'installation du noeud fédéré) :
    • For i5/OS operating system Sur les plateformes i5/OS : racine_profil/bin/stopNode
    • For Linux operating systemFor UNIX operating system Sur les plateformes Linux et UNIX : racine_profil/bin/stopNode.sh
    • For Windows operating system Sur les plateformes Windows : racine_profil\bin\stopNode.bat
    Si la sécurité est activée, utilisez l'une des commandes suivantes à la place de celles indiquées ci-dessus :
    • For i5/OS operating system Sur les plateformes i5/OS : racine_profil/bin/stopNode -username ID_utilisateur -password mot_de_passe
    • For Linux operating systemFor UNIX operating system Sur des plateformes Linux et UNIX : racine_profil/bin/stopNode.sh -username ID_utilisateur -password mot_de_passe
    • For Windows operating system Sur les plateformes Windows : racine_profil\bin\stopNode.bat -username ID_utilisateur -password mot_de_passe
    Remarque : Vous devez arrêter l'ancien noeud avant de lancer la migration. Il n'est pas nécessaire que le serveur soit actif pour migrer sa configuration. Les outils de migration peuvent extraire toutes les données de configuration alors que le serveur est arrêté.
  4. Identifiez à l'avance les informations préexistantes nécessaires à la migration, comme indiqué ci-dessous :
    Répertoire principal d'installation
    Voir Utilitaire de ligne de commande WBIPreUpgrade pour une description du paramètre currentWebSphereDirectory.
    Nom du répertoire de sauvegarde de la migration
    Voir Utilitaire de ligne de commande WBIPreUpgrade pour une description du paramètre backupDirectory.
    Nom d'utilisateur pour la sécurité administrative (obligatoire si la sécurité administrative est configurée)
    Voir Utilitaire de ligne de commande WBIPostUpgrade pour une description du paramètre -username.
    Mot de passe pour la sécurité administrative (obligatoire si la sécurité administrative est configurée)
    Voir Utilitaire de ligne de commande WBIPostUpgrade pour une description du paramètre -password.
    Nom de profil source
    Voir Utilitaire de ligne de commande WBIPostUpgrade pour une description du paramètre -oldProfile.
    Nom de profil cible
    Voir Utilitaire de ligne de commande WBIPostUpgrade pour une description du paramètre -profileName.
    Attribution des valeurs de port (facultatif)
    Voir Utilitaire de ligne de commande WBIPostUpgrade pour une description des paramètres -replacePorts et -portBlock.
    Remarque : Cela s'applique uniquement si vous migrez depuis la version 6.0.2.x vers la version 6.2.
  5. Assurez-vous que le gestionnaire de déploiement version 6.2 est en cours d'exécution.
  6. 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 de configuration des profils existants dans le répertoire de sauvegarde que vous définissez.
  7. 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 dans le nouveau profil du gestionnaire de déploiement WebSphere ESB.
    Important : Utilisez le paramètre -createTargetProfile pour appeler WBIPostUpgrade. Cette option crée un profil cible nécessaire correspondant pour la migration. Pour plus d'informations sur les profils cible, reportez-vous à Remarques sur les profils cible.
    For i5/OS operating system Remarque : Si vous effectuez la migration sur une plateforme i5/OS, le nom du profil cible doit correspondre à celui du profil source à migrer.
  8. Début de modificationSi 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.

    Fin de modification
  9. Arrêtez le serveur et l'agent de noeud (si cela n'est pas déjà fait). Si le serveur n'a pas encore été arrêté, arrêtez-le comme indiqué à l'étape 2. Si l'agent de noeud n'a pas encore été arrêté, arrêtez-le comme indiqué à l'étape 3.
  10. Redémarrez l'agent de noeud. Pour démarrer un agent de noeud, exécutez la commande racine_profil\bin\startNode (où racine_profil représente le répertoire d'installation du noeud géré).
    • For i5/OS operating system Sur les plateformes i5/OS : racine_profil/bin/startNode
    • For Linux operating systemFor UNIX operating system Sur les plateformes Linux et UNIX : racine_profil/bin/startNode.sh
    • For Windows operating system Sur les plateformes Windows : racine_profil\bin\startNode.bat
  11. Démarrez le ou les serveurs exécutés sur ce noeud. Démarrez chaque serveur via la commande startServer, la console d'administration ou la console Premiers pas du profil. Pour plus d'informations, voir Démarrage d'un serveur d'applications.
  12. Répétez les étapes 1 à 11 pour chaque noeud géré supplémentaire à migrer.
    Remarque : Vous devez ré-exécuter l'étape 6 (lancement de WBIPreUpgrade) uniquement si vous migrez depuis la version 6.1.x ou depuis version 6.0.2.x et que le système version 6.0.2.x a été reconfiguré depuis la première exécution de WBIPreUpgrade.
  13. Si vous avez sélectionné l'option de compatibilité (option par défaut) et que l'ensemble de vos noeuds a été migré vers WebSphere ESB version 6.2, exécutez le script convertScriptCompatibility pour supprimer la compatibilité du gestionnaire de déploiement version 6.2.
    Remarque : Cela s'applique uniquement si vous migrez depuis la version 6.0.2.x.
    Emettez l'une des commandes convertScriptCompatibility à partir du répertoire bin, en fonction de votre système d'exploitation :
    • For i5/OS operating system Sur les plateformes i5/OS : racine_installation/bin/convertScriptCompatibility
    • For Linux operating systemFor UNIX operating system Sur les plateformes Linux/UNIX : racine_profil/bin/convertScriptCompatibility
    • For Windows operating system Sur les plateformes Windows : racine_installation\bin\convertScriptCompatibility.bat

    Voir la rubrique Commande 'convertScriptCompatibility'.

Résultats

La migration des noeuds gérés non groupés est terminée.

Que faire ensuite

Vérifiez que la migration s'est correctement terminée.

task Rubrique relative à une tâche

Conditions d'utilisation | Commentaires en retour


Icône d'horodatage Dernière mise à jour: 07 juillet 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/tmig_vtv_mn_cl.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
Ce centre d'information est mis en service par la technologie Eclipse (http://www.eclipse.org).