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

Désinstallation du produit à l'aide de l'interface graphique

Cette procédure permet de désinstaller IBM WebSphere ESB et la copie sous-jacente de WebSphere Application Server Network Deployment via l'interface graphique de l'assistant de désinstallation.

Avant de désinstaller WebSphere ESB à l'aide de cette procédure, vérifiez les points suivants :
  • Vous souhaitez désinstaller WebSphere ESB en mode interactif.
  • Vous avez déterminé si vous souhaitiez désinstaller ou non le produit sous-jacent WebSphere Application Server Network Deployment en même temps que WebSphere ESB.
    • Si vous décidez de désinstaller le produit sous-jacent WebSphere Application Server Network Deployment, le programme de désinstallation supprime également tous les profils, y compris toutes les données de configuration et les applications de chaque profil.
    • Si vous choisissez de ne pas désinstaller le produit sous-jacent WebSphere Application Server Network Deployment, tous les profils de WebSphere ESB qui ont été créés ou augmentés subiront une opération unaugment avec les profils WebSphere Application Server Network Deployment, si aucun autre produit n'a augmenté les profils après WebSphere ESB.
  • Vous avez sauvegardé, si nécessaire, les dossiers config, installableApps et installedApps de chaque profil. Sauvegardez toutes les applications qui ne se trouvent à aucun autre emplacement.
  • Vous avez supprimé, dans l'ordre, l'application d'entreprise de messagerie d'événements, la base de données d'événements et la configuration de l'application Common Event Infrastructure. Pour plus d'informations sur la suppression de ces applications et de la base de données, voir Suppression de la configuration de Common Event Infrastructure
  • Vous êtes connecté comme utilisateur root (sous Linux et UNIX) ou comme membre du groupe Administrateur (sous Windows).
Restriction : L'assistant ne permet pas d'effectuer une désinstallation partielle, personnalisée ou incrémentielle.
Restriction : For Windows platforms Sous Windows : les chemins d’accès ne doivent pas dépasser 255 caractères. Si le chemin d'accès d'un répertoire de profil est trop long, l'assistant de désinstallation ne peut pas supprimer ce répertoire. Un chemin d'accès peut être trop long en raison des éléments qu'il contient : nom du répertoire racine_profil, nom des cellules, des serveurs de processus, etc. Bien que les plateformes Windows autorisent la création de longs chemins d'accès, elles ne permettent pas leur suppression, même manuelle. Pour permettre la désinstallation dans ce cas, raccourcissez le nom des répertoires et des sous-répertoires qui n'ont pas été supprimés. Ensuite, supprimez ces répertoires manuellement.

Le programme de désinstallation est créé lors de l'installation du produit. Il est personnalisé en fonction de chaque installation du produit, avec des emplacements de disque spécifiques et des routines pour la suppression des fonctions installées.

Estimation de la durée de la désinstallation : le temps nécessaire à la désinstallation dépend de la vitesse du processeur. La désinstallation de WebSphere ESB, WebSphere Application Server Network Deployment et d'un profil prend une vingtaine de minutes.

Pour désinstaller WebSphere ESB, procédez comme suit :

  1. Connectez-vous en tant qu'utilisateur root (sous Linux ou UNIX) ou en tant qu'administrateur (sous Windows).
  2. Si vous désinstallez aussi le produit sous-jacent WebSphere Application Server Network Deployment, exécutez le programme de désinstallation pour les modules d'extension de serveur Web pour WebSphere Application Server.

    Si le système comprend un serveur Web configuré pour s'exécuter avec WebSphere Application Server Network Deployment, désinstallez les modules d'extension pour supprimer la configuration de ce serveur Web. Reportez-vous à la procédure de désinstallation figurant dans le centre de documentation de WebSphere Application Server Network Deployment à l'adresse http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp.

  3. Si un gestionnaire de déploiement est installé, arrêtez le processus dmgr à l'aide de la commande stopManager.
    Arrêtez tous les processus dmgr actifs sur la machine. Par exemple, exécutez l'une des commandes suivantes, selon la plateforme utilisée (racine_profil est l'emplacement d'installation du profil du gestionnaire de déploiement) :
    • LINUX platforms UNIX platforms Sous Linux et UNIX : racine_profil/bin/stopManager.sh -user ID_utilisateur -password mot_de_passe
    • For Windows platforms Sous Windows : racine_profil\bin\stopManager.bat -user ID_utilisateur -password mot_de_passe
  4. Arrêtez le processus de l'agent de noeud à l'aide de la commande stopNode.
    Si le système comprend des noeuds fédérés dans un gestionnaire de déploiement, arrêtez le processus nodeagent qui pourrait s'exécuter sur chaque machine dotée d'un noeud fédéré. Par exemple, exécutez l'une des commandes suivantes, selon la plateforme utilisée, pour arrêter le processus nodeagent (racine_profil représente le répertoire d'installation du noeud fédéré) :
    • LINUX platforms UNIX platforms Sous Linux et UNIX : racine_profil/bin/stopNode.sh
    • For Windows platforms Sous Windows : racine_profil\bin\stopNode.bat
    Si des serveurs sont actifs et si la sécurité est activée, utilisez l'une des commandes suivantes à la place de celles indiquées ci-dessus :
    • LINUX platforms UNIX platforms Sous Linux et UNIX : racine_profil/bin/stopNode.sh -user ID_utilisateur -password mot_de_passe
    • For Windows platforms Sous Windows : racine_profil\bin\stopNode.bat -user ID_utilisateur -password mot_de_passe
  5. Arrêtez chaque serveur actif à l'aide de la commande stopServer.
    Arrêtez tous les processus serveur dans tous les profils sur la machine. Par exemple, exécutez l'une des commandes suivantes, selon la plateforme utilisée, pour arrêter le serveur server1. Dans cet exemple, racine_profil représente l'emplacement d'installation du profil :
    • LINUX platforms UNIX platforms Sous Linux et UNIX : racine_profil/bin/stopServer.sh server1
    • For Windows platforms Sous Windows : racine_profil\bin\stopServer.bat server1
    Si des serveurs sont actifs et si la sécurité est activée, utilisez l'une des commandes suivantes à la place de celles indiquées ci-dessus :
    • LINUX platforms UNIX platforms Sous Linux et UNIX : racine_profil/bin/stopServer.sh server1 -user ID_utilisateur -password mot_de_passe
    • For Windows platforms Sous Windows : racine_profil\bin\stopServer.bat server1 -user ID_utilisateur -password mot_de_passe
  6. Facultatif : Sauvegardez les fichiers de configuration et les fichiers journaux pour vous y référer ultérieurement, si nécessaire.

    Le programme de désinstallation ne supprime pas les fichiers journaux du répertoire racine_installation. Si vous choisissez de désinstaller le programme sous-jacent WebSphere Application Server Network Deployment, cette opération supprime tous les profils et toutes les données des profils.

    Sauvegardez le dossier config et le dossier logs de chaque profil pour vous y référer ultérieurement, si nécessaire. Il est inutile de sauvegarder l'intégralité des profils, car ceux-ci ne peuvent pas être réutilisés.

  7. Lancez la commande uninstall à partir d'une ligne de commande.
    Entrez l'une des commandes ci-après, en fonction de la plateforme utilisée :
    • LINUX platforms UNIX platforms Sous Linux et UNIX : racine_installation/_uninstwbi/uninstall
    • For Windows platforms Sous Windows : racine_installation\_uninstwbi\uninstall.exe
    L'assistant de désinstallation démarre et le panneau de bienvenue s'affiche.
  8. Indiquez si vous souhaitez désinstaller le produit sous-jacent WebSphere Application Server Network Deployment lors de la désinstallation de WebSphere ESB. Cliquez ensuite sur Suivant. L'un des quatre panneaux suivants s'affiche :
    • Si un ou plusieurs serveurs sont en cours de fonctionnement sur le système, un panneau d'avertissement vous demande de les arrêter et de redémarrer la désinstallation. Dans ce cas, annulez la désinstallation et arrêtez les serveurs en question.
    • Si aucun serveur n'est en fonctionnement, si vous n'avez pas choisi de désinstaller le produit sous-jacent WebSphere Application Server Network Deployment et si le programme de désinstallation détermine que les profils peuvent être de nouveau transformés en profils WebSphere Application Server, le panneau Récapitulatif de la désinstallation s'affiche. Passez à l'étape 10.
    • Si aucun serveur n'est en fonctionnement, si vous n'avez pas choisi de désinstaller le produit sous-jacent WebSphere Application Server Network Deployment et si le programme de désinstallation détermine que les profils ne peuvent pas être de nouveau transformés en profils WebSphere Application Server, un panneau d'avertissement vous informe que les profils WebSphere ESB seront inutilisables. Passez à l'étape 9.
    • Si aucun serveur n'est en fonctionnement et si vous avez choisi de désinstaller WebSphere Application Server Network Deployment, un panneau d'avertissement vous informe que les profils WebSphere ESB vont être supprimés. Passez à l'étape 9.
  9. Dans le panneau d'avertissement, vous pouvez choisir de poursuivre ou d'annuler la désinstallation. Cliquez sur Suivant pour continuer la désinstallation ou sur Précédent pour modifier vos choix. Dans cet exemple de procédure, l'utilisateur poursuit la désinstallation. Le panneau Récapitulatif de la désinstallation s'affiche.
  10. Vérifiez la liste des produits et des fonctions à désinstaller.

    Cliquez sur Suivant pour continuer la désinstallation ou sur Précédent pour modifier vos choix. Dans cet exemple de procédure, l'utilisateur poursuit la désinstallation.

    La désinstallation du produit commence. Si vous avez choisi de désinstaller WebSphere Application Server Network Deployment, le programme de désinstallation effectue les tâches suivantes, dans cet ordre :
    • Reconversion vers une version antérieure des profils augmentés en dernier par WebSphere ESB.
    • Désinstallation de WebSphere ESB.
    • Désinstallation de WebSphere Application Server Network Deployment, qui entraîne la suppression des profils.
    Le panneau Désinstallation terminée s'affiche.
  11. Cliquez sur Terminer pour quitter l'assistant.
  12. Le cas échéant, supprimez les entrées de configuration du noeud géré faisant référence à un gestionnaire de déploiement supprimé.

    Généralement, les fichiers de base du produit sont installés sur plusieurs machines ; un système contient le gestionnaire de déploiement, tandis que les autres contiennent les noeuds gérés créés à partir des profils personnalisés. Si vous supprimez une installation pour laquelle vous avez créé un profil personnalisé et fédéré le noeud dans une cellule du gestionnaire de déploiement sur une autre installation, vous devez supprimer la configuration du gestionnaire de déploiement.

    Selon la déclaration officielle de prise en charge pour les incidents de configuration liés au noeud géré, vous devez utiliser la commande backupConfig après l'installation initiale. Utilisez de nouveau la commande lorsque vous apportez des modifications importantes à la configuration qui doit être enregistrée. Avec une sauvegarde valide de la configuration, vous pourrez toujours utiliser la commande restoreConfig pour revenir à un état de configuration antérieur.

    Vous pouvez également utiliser l'une des commandes suivantes sur le système contenant le noeud géré pour supprimer ce dernier, si le gestionnaire de déploiement n'est pas en cours d'exécution. Dans cet exemple, racine_profil représente le répertoire d'installation du profil de noeud géré :
    • LINUX platforms UNIX platforms Sous Linux et UNIX : racine_profil/bin removeNode.sh -force
    • For Windows platforms Sous Windows : racine_profil\bin removeNode.bat -force

    Si vous devez nettoyer la configuration manuellement sur le noeud géré, vous pouvez essayer la procédure suivante, bien que celle-ci ne soit pas prise en charge :

    1. Si le répertoire nom_cellule du noeud a été renommé, redonnez-lui son nom d'origine.
      Accédez à l'un des répertoires suivants et renommez le répertoire nom_cellule par le nom d'origine. Dans cet exemple, racine_profil représente le répertoire d'installation du profil du noeud :
      • LINUX platforms UNIX platforms Sous Linux et UNIX : racine_profil/config/cells/
      • For Windows platforms Sous Windows : racine_profil\config\cells\
    2. Supprimez le répertoire nom_noeud_dmgr, s'il existe.
      Accédez à l'un des répertoires suivants pour rechercher le répertoire nom_noeud_dmgr à supprimer. Dans cet exemple, racine_profil représente le répertoire d'installation du profil du noeud :
      • LINUX platforms UNIX platforms Sous Linux et UNIX : racine_profil/config/cells/nom_origine_cellule/nodes
      • For Windows platforms Sous Windows : racine_profil\config\cells\nom_origine_cellule\nodes
    3. Editez le fichier setupCmdLine.sh (sous Linux ou UNIX) ou setupCmdLine.bat (sous Windows) et redonnez à la cellule son nom d'origine.
      Le fichier se trouve dans l'un des répertoires suivants, selon la plateforme utilisée. Dans cet exemple, racine_profil représente le répertoire d'installation du profil du noeud :
      • LINUX platforms For Windows platforms Sous Linux et UNIX : racine_profil/bin
      • For Windows platforms Sous Windows : racine_profil\bin
      Modifiez la valeur de la variable WAS_CELL en indiquant le nom d'origine de la cellule.
  13. Le cas échéant, supprimez les entrées de configuration du gestionnaire de déploiement faisant référence à un noeud géré supprimé.

    Ouvrez la console d'administration du gestionnaire de déploiement et cliquez sur Administration du système > Noeuds. Sélectionnez la case à cocher en regard du noeud à supprimer, puis sélectionnez Supprimer un noeud.

    Si la console d'administration ne parvient pas à supprimer le noeud, exécutez la commande suivante lorsque le gestionnaire de déploiement est en cours d'exécution :
    • LINUX platforms UNIX platforms Sous Linux et UNIX : racine_installation/bin/cleanupNode.shnom_noeud
    • For Windows platforms Sous Windows : racine_installation\bin\cleanupNode.batnom_noeud

    Selon la déclaration officielle de prise en charge pour les incidents de configuration liés au gestionnaire de déploiement, vous devez utiliser la commande backupConfig après l'installation initiale. Utilisez de nouveau la commande lorsque vous apportez des modifications importantes à la configuration qui doit être enregistrée. Avec une sauvegarde valide de la configuration, vous pourrez toujours utiliser la commande restoreConfig pour revenir à un état de configuration antérieur.

    Si vous devez nettoyer la configuration manuellement, vous pouvez essayer la procédure suivante, bien que celle-ci ne soit pas prise en charge :

    1. Dans le répertoire nodes du gestionnaire de déploiement, supprimez le répertoire de configuration pour le noeud supprimé.
      Accédez à l'un des répertoires suivants pour rechercher le fichier nom_noeud_supprimé. Dans cet exemple, racine_profil représente le répertoire d'installation du profil de gestionnaire de déploiement :
      • LINUX platforms UNIX platforms Sous Linux et UNIX : racine_profil/config/cells/nom_cellule/nodes
      • For Windows platforms Sous Windows : racine_profil\config\cells\nom_cellule\nodes
    2. Dans le répertoire buses du gestionnaire de déploiement, supprimez le répertoire de configuration du noeud supprimé.
      Accédez à l'un des répertoires suivants pour rechercher le fichier nom_noeud_supprimé. Dans cet exemple, racine_profil représente le répertoire d'installation du profil de gestionnaire de déploiement :
      • LINUX platforms UNIX platforms Sous Linux et UNIX : racine_profil/config/cells/nom_cellule/buses
      • For Windows platforms Sous Windows : racine_profil\config\cells\nom_cellule\buses
    3. Editez le fichier coregroup.xml dans chaque sous-répertoire du répertoire coregroups du gestionnaire de déploiement. Recherchez les éléments du type coreGroupServers. Supprimez les éléments coreGroupServers faisant référence au noeud supprimé.
      Accédez à l'un des répertoires suivants pour rechercher le fichier approprié. Dans cet exemple, racine_profil représente le répertoire d'installation du profil de gestionnaire de déploiement :
      • LINUX platforms UNIX platforms Sous Linux et UNIX : racine_profil/config/cells/nom_cellule/coregroups/nom_noeud_supprimé
      • For Windows platforms Sous Windows : racine_profil\config\cells\nom_cellule\coregroups\nom_noeud_supprimé
    4. Editez le fichier nodegroup.xml dans chaque sous-répertoire situé sous le dossier nodegroups du gestionnaire de déploiement. Recherchez les éléments du type members. Supprimez les éléments members faisant référence au noeud supprimé.
      Accédez à l'un des répertoires suivants pour rechercher le fichier approprié. Dans cet exemple, racine_profil représente le répertoire d'installation du profil de gestionnaire de déploiement :
      • LINUX platforms UNIX platforms Sous Linux et UNIX : racine_profil/config/cells/nom_cellule/coregroups/nom_noeud_supprimé
      • For Windows platforms Sous Windows : racine_profil\config\cells\nom_cellule\coregroups\nom_noeud_supprimé

Cette procédure désinstalle WebSphere ESB et, éventuellement, WebSphere Application Server Network Deployment. Une fois la désinstallation effectuée, l'arborescence ne contient plus que quelques répertoires, dont logs.

Le programme de désinstallation laisse les fichiers journaux suivants dans ce répertoire :
  • LINUX platforms UNIX platforms Sous Linux et UNIX : racine_installation/logs/wbi/uninstlog.txt et racine_installation/logs/wbi/uninstconfig.log
  • For Windows platforms Sous Windows : racine_installation\logs\wbi\uninstlog.txt et racine_installation\logs\wbi\uninstconfig.log
Le fichier uninstlog.txt contient les erreurs liées au système de fichiers ou d'autres erreurs. Recherchez l'indicateur de réussite INSTCONFSUCCESS dans le journal :
Uninstall, com.ibm.ws.install.ni.ismp.actions.
   ISMPLogSuccessMessageAction, msg1, 
   INSTCONFSUCCESS
Si vous envisagez de réinstaller le produit dans le même répertoire racine, vous devez effectuer la procédure suivante (en fonction du résultat de la désinstallation) :
  • Si la désinstallation a réussi, vous devez supprimer manuellement le répertoire racine_installation.
    Important : Si vous avez prévu de réinstaller ultérieurement WebSphere ESB dans le même répertoire et afin d'éviter tout incident, vous devez au préalable désinstaller WebSphere ESB et le produit sous-jacent WebSphere Application Server Network Deployment. Le répertoire racine_installation, que vous devez supprimer manuellement, doit être vide.
  • Si la désinstallation a échoué, vous devez désinstaller manuellement les éléments restants du produit. Pour plus d'informations, voir Préparation à la réinstallation après une désinstallation incorrecte.Cette tâche n'est pas nécessaire si vous n'envisagez pas de réinstaller le produit.

Pour plus de détails sur les commandes mentionnées dans cette rubrique, reportez-vous au centre de documentation de WebSphere Application Server Network Deployment, version 6.0 à l'adresse http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp.


Task topic

Conditions d'utilisation | Evaluez cette page

Timestamp iconDernière révision :
../timestamp 4 Mar 2006 http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.websphere.wesb.doc.nl1_6.0.1\doc\tins_gui_uninstall.html

(C) Copyright IBM Corporation 2006. All Rights Reserved. Copyright IBM France, 2006. Tous droits réservés.
Ce centre de documentation a été réalisé grâce à la technologie Eclipse. (http://www.eclipse.org)