Guide d'installation de Sun Java Enterprise System 5 pour Microsoft Windows

Chapitre 7 Désinstallation des composants Java ES

Ce chapitre contient les instructions de désinstallation des composants Sun Java^TM Enterprise System (Java ES) installés à l'aide du programme d'installation de Java ES.

Il inclut les sections suivantes:

Fonctionnement du programme de désinstallation

Java ES est doté d'un programme de désinstallation qui permet de supprimer de votre système les composants Java ES qui ont été installés par le biais du programme d'installation de Java ES.

Limitations du programme de désinstallation

Tout comme le programme d'installation de Java ES, le programme de désinstallation peut fonctionner en mode graphique ou en mode Silencieux.

Le programme de désinstallation supprime uniquement les composants Java ES installés par le programme d'installation de Java ES. Pour supprimer un composant Java ES qui n'a pas été installé par le biais de ce programme, suivez les instructions se trouvant dans la documentation du composant en question.
Le programme de désinstallation doit être exécuté séparément sur chaque hôte contenant des composants Java ES. La désinstallation distante n'est pas prise en charge. Pour chaque hôte, vous pouvez sélectionner un ou plusieurs composants Java ES à désinstaller.
Le programme de désinstallation peut supprimer des fichiers de données d'utilisateur et de configuration. Ces fichiers varient pour chaque composant.

Une fois la désinstallation terminée, il se peut que vous deviez supprimer certains fichiers et répertoires supplémentaires. Pour obtenir des informations produit par produit, reportez-vous à la section Vérification du comportement de désinstallation des composants Java ES.
Le programme de désinstallation vérifie les dépendances des composants Java ES uniquement sur le système sur lequel il est exécuté et génère un avertissement lorsqu'il découvre une dépendance.

Gestion des interdépendances

Le programme de désinstallation peut réagir différemment selon les composants Java ES installés et les relations qui existent entre eux.

Le programme de désinstallation est capable de détecter les dépendances entre les produits installés sur le même hôte. Si vous tentez de désinstaller un composant Java ES dont plusieurs produits installés sur l'hôte dépendent, ce programme affiche un avertissement.

Par exemple, si vous essayez de désinstaller Access Manager de l'hôte sur lequel Portal Server est également installé, le programme de désinstallation vous avertit que Portal Server ne peut pas fonctionner sans Access Manager.
Dans la plupart des cas, vous pouvez désinstaller un composant Java ES dans la mesure où aucun autre composant ES n'en dépend.

Par exemple, Portal Server dépend d'Access Manager, mais Access Manager ne dépend pas de Portal Server. Si vous tentez de désinstaller Portal Server, le programme de désinstallation ne génère aucun avertissement, car Access Manager peut fonctionner sans Portal Server.

Attention –

Lors de la désinstallation d'un composant Java ES, vous devez identifier les produits configurés pour ce composant (une configuration supplémentaire peut alors être requise). Dans le cas contraire, votre système risquerait de contenir des composants Java ES configurés pour la prise en charge de produits qui ne sont plus installés.

Le programme de désinstallation ne reconnaît pas les interdépendances suivantes :

dépendances concernant des hôtes distants ;
dépendances résultant de la configuration.

Dépendances des composants Java ES installés sur des hôtes distants

Certaines dépendances peuvent être satisfaites grâce à des composants Java ES déployés sur des hôtes distants. Toutefois, le programme de désinstallation ne reconnaît pas ces relations de dépendance.

Par exemple, si vous désinstallez Directory Server, le programme de désinstallation ne vous avertit pas qu'Access Manager dépend de Directory Server, même si les deux produits sont déployés sur le même hôte. Cela est dû au fait qu'une autre instance de Directory Server hébergée sur un autre hôte a pu prendre en charge Access Manager.

Dépendances des composants Java ES résultant de la configuration

Le programme de désinstallation n'est pas capable de détecter une dépendance entre composants Java ES qui résulte d'une configuration post-installation.

Vérification des prérequis

Le tableau suivant répertorie les tâches à effectuer avant de procéder à la désinstallation. Certaines de ces tâches peuvent ne pas s'appliquer à votre cas.

La colonne de gauche indique l'ordre dans lequel vous devez effectuer les tâches, et la colonne de droite contient des informations utiles, ainsi que l'emplacement des instructions.

Tableau 7–1 Liste de vérifications


Description de la tâche	Instructions ou informations utiles
1. Prenez connaissance des besoins et des comportements de chaque composant Java ES que vous allez désinstaller.	Vérification du comportement de désinstallation des composants Java ES
2. Identifiez les dépendances qui résultent de la configuration et prenez les mesures appropriées, telles que la sauvegarde des données, l'annulation de la configuration du composant Java ES pris en charge ou la désinstallation des composants Java ES dans l'ordre approprié.	Gestion des interdépendances
3. Sauvegardez ou archivez les données utilisateur ou les données de configuration des composants Java ES que vous désinstallez si vous envisagez de réutiliser ces données pour des installations ultérieures.	Vérification du comportement de désinstallation des composants Java ES
4. Assurez-vous que l'instance de Directory Server qui héberge le répertoire de configuration est en cours d'exécution. Remarque : dans la plupart des cas, le conteneur Web et Directory Server doivent être en cours d'exécution, alors que les autres serveurs doivent être arrêtés avant la désinstallation.	Cette instance de Directory Server doit être en cours d'exécution pour permettre au programme de désinstallation de supprimer correctement la configuration des composants que vous désinstallez.

Vérification du comportement de désinstallation des composants Java ES

Consultez les tableaux de cette section pour savoir comment le programme de désinstallation traite les composants Java ES. Planifiez les tâches à effectuer afin d'éviter de perdre des données ou des liens d'interdépendance.

Cette section est composée des sous-sections suivantes :

Comportement de désinstallation d'Access Manager

Tableau 7–2 Détails de la désinstallation d'Access Manager


Thème	Détails
Données de configuration	Aucune entrée de Directory Server n'est supprimée (y compris les données spécifiques à Access Manager).
Autres désinstallations requises par ce composant	Directory Server Conteneur Web
Produits nécessitant cette installation	Portal Server (doit résider sur le même hôte qu'Access Manager SDK)
Tâches préalables à la désinstallation	Aucune
Tâches postérieures à la désinstallation	La désinstallation ne permet de supprimer la configuration d'Access Manager du conteneur Web que pour les installations complètes sur Web Server ou Application Server.

Comportement de désinstallation d'Application Server

Tableau 7–3 Détails de la désinstallation d'Application Server


Thème	Détails
Données de configuration et données d'utilisateur	Le domaine par défaut créé au moment de l'installation est supprimé lors de la désinstallation. Les domaines utilisateur, y compris toutes les instances d'Administration Server et d'Application Server, ne sont pas supprimés au cours de la désinstallation. Toutes les instances d'Administration Server et d'Application Server sont arrêtées avant la fin de la désinstallation.
Dépendances	Message Queue doit être installé sur le même système.
Produits nécessitant cette installation	Composants configurés pour utiliser Application Server comme conteneur Web : Access Manager, Portal Server.
Tâches préalables à la désinstallation	Pour conserver les données de configuration, faites une copie des répertoires de domaines d'administration.
Tâches postérieures à la désinstallation	Pour supprimer totalement Application Server du système, supprimez tous les fichiers journaux et répertoires d'Application Server restants. L'emplacement par défaut des répertoires d'Application Server est `\rép-installation-JavaES\appserver`. Reportez-vous à la section Comportement de désinstallation de Message Queue pour obtenir des informations sur les tâches postérieures à la désinstallation à effectuer pour Message Queue.

Comportement de désinstallation de Directory Server

Tableau 7–4 Détails de la désinstallation de Directory Server


Thème	Détails
Données de configuration et données d'utilisateur	Si vous désinstallez l'instance de Directory Server qui héberge les données d'utilisateur, la base de données LDAP de Directory Server est supprimée au cours de la désinstallation. Attention : pour éviter toute perte de données, veillez à sauvegarder les informations sur Directory Server avant de procéder à la désinstallation. Directory Server comporte plusieurs outils et utilitaires permettant de sauvegarder les données Directory Server et de migrer les informations de configuration.
Dépendances	Aucune
Produits nécessitant cette installation	Access Manager Portal Server
Tâches préalables à la désinstallation	Au besoin, sauvegardez la base de données LDAP Directory Server.
Tâches postérieures à la désinstallation	Si vous installez Directory Server ultérieurement au même emplacement, le répertoire d'installation ne doit pas exister. Vous devrez peut-être le supprimer manuellement, ainsi que les fichiers de configuration personnalisés, avant de procéder à une réinstallation au même emplacement.

Comportement de désinstallation de Message Queue

Tableau 7–5 Détails de la désinstallation de Message Queue


Thème	Détails
Données de configuration	Les données de configuration spécifiques à l'instance, le référentiel de l'utilisateur et le fichier de contrôle d'accès sont conservés après la désinstallation et peuvent être réutilisés lors d'une prochaine réinstallation.
Autres installations requises par ce composant	Directory Server (facultatif)
Produits nécessitant cette installation	Application Server (doit résider sur le même hôte que Message Queue)
Tâches préalables à la désinstallation	Arrêtez tous les courtiers en cours d'exécution. Vous serez invité à entrer votre nom d'utilisateur (administrateur) et votre mot de passe :`imqcmd shutdown bkr` [ `-b` `nom-hôte:port`] Si vous ne prévoyez pas de réinstaller Message Queue et souhaitez par conséquent supprimer les données dynamiques, le référentiel de données simples de l'utilisateur et le fichier de contrôle d'accès associés à chaque instance de courtier, supprimez ces données à l'aide de la commande suivante. `imqbrokerd -name` `nom-instance` `-remove` `instance` Si vous mettez à niveau Message Queue à l'aide du script de mise à niveau de Message Queue, notez le processus. Le script de mise à niveau n'écrit pas d'informations d'installation dans le registre Java ES.
Tâches postérieures à la désinstallation	Si vous n'envisagez pas de réinstaller Message Queue, utilisez les commandes indiquées dans la documentation du composant Java ES pour nettoyer votre système.

Comportement de désinstallation de Monitoring Console

Tableau 7–6 Détails de la désinstallation de Monitoring Console


Thème	Détails
Données de configuration	Les données d'utilisateur ne sont pas supprimées lors de la désinstallation. Elles le sont toutefois en cas de réinstallation.
Dépendances	Aucune
Autres produits nécessitant cette installation	Aucun
Tâches préalables à la désinstallation	Aucune
Tâches postérieures à la désinstallation

Comportement de désinstallation de Portal Server

Tableau 7–7 Détails de la désinstallation de Portal Server


Thème	Détails
Données de configuration et données d'utilisateur	Les données de configuration sont supprimées au cours de la désinstallation. La suppression de la configuration implique la suppression des services créés par Portal Server dans Access Manager. Les fournisseurs des canaux utilisateur ne sont pas supprimés lors de la désinstallation et peuvent être réutilisés lors d'une prochaine installation. Le programme de désinstallation ne supprime pas les données de configuration personnalisées (profils d'affichage, fichiers de propriétés, chaînes de ressources et autres personnalisations). Ces données peuvent être réutilisées lors d'une installation ultérieure uniquement si Portal Server est réinstallé sur le même hôte avec la même configuration.
Autres désinstallations requises par ce composant	Directory Server Application Server ou Web Server Access Manager Service Registry
Produits nécessitant cette installation	Aucun
Tâches préalables à la désinstallation	Vérifiez que Directory Server et le conteneur Web sont en cours d'exécution.
Tâches postérieures à la désinstallation	Si vous exécutez Portal Server sur Web Server et que vous choisissez de supprimer uniquement Portal Server, vous devez redémarrer Access Manager. Pour plus d'informations, reportez-vous à la section Comportement de désinstallation d'Access Manager.

Comportement de désinstallation de Portal Server Secure Remote Access

Tableau 7–8 Détails de la désinstallation de Portal Server Secure Remote Access


Thème	Détails
Données de configuration	Toutes les données de configuration du composant Portal Server Secure Remote Access Core sont supprimées lors de la désinstallation. Le déploiement de toutes les applications Web déjà déployées est annulé. Les utilisateurs ne peuvent pas accéder aux données de configuration des sous-composants Portal Server Secure Remote Access Gateway, Netlet Proxy et Rewriter Proxy.
Autres désinstallations requises par ce composant	Portal Server Secure Remote Access dépend de Portal Server et ne peut pas être désinstallé indépendamment de ce composant. Les sous-composants Portal Server, Secure Remote Access Gateway, Netlet Proxy et Rewriter Proxy dépendent d'Access Manager SDK. Portal Server et Portal Server Secure Remote Access Support doivent être installés dans le même répertoire et sur le même hôte. Access Manager SDK doit résider sur le même hôte que les composants Gateway, Netlet Proxy et Rewriter Proxy. Cependant, vous ne pouvez pas placer ces trois derniers composants dans le même répertoire. Vous pouvez supprimer tout composant Portal Server Secure Remote Access sans pour autant devoir supprimer un composant dépendant. Il est également possible de supprimer le composant Gateway et de conserver Access Manager SDK.
Produits nécessitant cette installation	Aucun
Tâches préalables à la désinstallation	Aucune
Tâches postérieures à la désinstallation	Aucune

Si Portal Server Secure Remote Access est configuré, commencez par désinstaller manuellement les composants Portal Server Secure Remote Access à l'aide de la commande psadmin.

Pour désinstaller les composants SRA :

Arrêtez l'instance de Portal Server Secure Remote Access.

stop-sra-instance --adminuser ID-utilisateur --passwordfile nom-fichier-mots-de-passe --name nom-instance-sra --type type-instance --hostname nom-hôte-instance

Supprimez l'instance de Portal Server Secure Remote Access.

psadmin delete-sra-instance --adminuser ID-utilisateur --passwordfile nom-fichier-mots-de-passe --name nom-instance-sra --type type-instance --hostname nom-hôte-instance

Remarque –
Les composants Portal Server Secure Remote Access configurés ne sont pas supprimés par le programme de désinstallation. Vous devez donc désinstaller manuellement les composants Portal Server Secure Remote Access configurés. Dans le cas contraire, des problèmes d'installation peuvent survenir en cas d'installation ultérieure sur le même hôte.

Comportement de désinstallation de Service Registry

Tableau 7–9 Détails de la désinstallation de Service Registry


Thème	Détails
Données de configuration	Le processus de configuration du registre installe le domaine de la base de données du registre et le keystore du serveur dans le répertoire `rép-installation-JavaES`. La désinstallation de Service Registry n'entraîne pas la suppression de ce répertoire. Ainsi, vous pouvez conserver la base de données en vue de l'utiliser dans le cadre d'une installation ou une version ultérieure.
Autres installations requises par ce composant	Application Server (Domain Administration Server et Outil d'administration par ligne de commande) HADB Message Queue
Produits nécessitant cette installation	Aucun
Tâches préalables à la désinstallation	1. Arrêtez le domaine de Service Registry en utilisant la commande suivante : `rép-installation-JavaES\share\ant\bin\ant.bat -f build-install.xml appserver.domain.stop` 2. Supprimez le domaine de Service Registry, en utilisant la commande suivante : `rép-installation-JavaES\share\ant\bin\ant.bat -f build-install.xml appserver.domain.delete` Pour conserver la base de données du domaine en vue d'une utilisation ultérieure, copiez le répertoire `base-ServiceRegistry` à un autre emplacement avant de réinstaller le registre.
Tâches postérieures à la désinstallation	Dans certains cas, la désinstallation ne supprime pas tous les fichiers d'installation. Pour effectuer un dernier nettoyage, supprimez le répertoire `base-ServiceRegistry` et son contenu. La désinstallation du registre n'entraîne pas la suppression du répertoire contenant la base de données, le domaine et les keystores Service Registry. Vous pouvez le supprimer manuellement. Néanmoins, pour conserver la base de données pour une prochaine installation ou une version ultérieure, copiez le répertoire suivant à un autre emplacement avant de réinstaller le registre, puis recopiez-le une fois la réinstallation effectuée. Si vous avez effectué une copie de la base de données du registre avant d'installer Service Registry, recopiez-la après la réinstallation. Après avoir restauré la base de données et les fichiers keystore, exécutez la commande suivante en utilisant les variantes spécifiques à la plate-forme : `rép-installation-JavaES\share\ant\bin\ant.bat -f build-install.xml appserver.domain.stop export.registryOperatorCert install.cacerts appserver.domain.start`

Comportement de désinstallation de Web Proxy Server

Tableau 7–10 Détails de la désinstallation de Web Proxy Server


Thème	Détails
Données de configuration	Seuls les fichiers de la base de données des certificats présents dans le répertoire alias à l'emplacement de l'installation sont conservés. Tous les autres fichiers sont supprimés.
Dépendances	Directory Server (facultatif) si le contrôle d'accès LDAP externe a été sélectionné.
Tâches préalables à la désinstallation	Arrêt de toutes les instances de Web Proxy Server.
Tâches postérieures à la désinstallation	La base de données des certificats est conservée dans le répertoire `base-WebProxyServer\alias`. Vous devrez déplacer la base de données des certificats et supprimer l'ancien répertoire de l'installation avant de procéder à la réinstallation.

Comportement de désinstallation de Web Server

Tableau 7–11 Détails de la désinstallation de Web Server


Thème	Détails
Données de configuration et données d'utilisateur	Le serveur d'administration Web Server et les instances de Web Server sont arrêtés avant l'exécution de la désinstallation. Les répertoires d'installation ou d'instances de Web Server ne peuvent pas être supprimés à l'aide d'un utilitaire autre que le programme de désinstallation.
Autres installations requises par ce composant	Aucune
Produits nécessitant cette installation	Composants configurés pour utiliser Web Server comme conteneur Web : Access Manager et Portal Server. Également le Plug-in d'équilibrage de charge d'Application Server (si Application Server utilise Web Server comme conteneur Web).
Tâches préalables à la désinstallation	Aucune
Tâches postérieures à la désinstallation	Pour conserver les données de configuration, effectuez une sauvegarde des répertoires d'instances d'Administration Server et de Web Server à l'emplacement de l'installation. Si vous installez Web Server ultérieurement au même emplacement, le répertoire d'installation ne doit pas exister. Vous devrez peut-être supprimer manuellement le répertoire d'installation et les fichiers de configuration personnalisés avant de procéder à une réinstallation au même emplacement.

Exécution du programme de désinstallation en mode graphique

Une fois les tâches énumérées à la section Vérification des prérequis effectuées, vous pouvez exécuter le programme de désinstallation.

Pour démarrer le programme de désinstallation en mode graphique/l'assistant Windows

Sélectionnez Démarrage > Paramètres > Panneau de configuration.

Double-cliquez sur Ajout/Suppression de programmes.

Sélectionnez Sun Java Enterprise System.

Cliquez sur Modifier/Supprimer.

La page d'accueil de la fonction de modification ou de suppression de programmes s'affiche.

Pour modifier l'installation existante

Sélectionnez Modifier dans la fenêtre de l'assistant Install Shield pour ajouter de nouvelles fonctionnalités ou supprimer certaines des fonctionnalités déjà installées.

Cliquez sur Suivant.

La page de sélection des composants s'affiche.

Passez en revue les composants.
- Les composants installés sur votre système sont activés et peuvent donc être sélectionnés. Ceux qui ne sont pas installés sur votre système sont désactivés et ne peuvent pas être sélectionnés.
  - Certains composants comportent des sous-composants. Développez-les pour afficher leurs sous-composants.
  - Si vous désélectionnez un composant qui contient des sous-composants, développez-le pour vérifier sa liste de sous-composants.

Sélectionnez les composants à installer et désélectionnez ceux que vous souhaitez désinstaller. Cliquez sur Suivant.

Le programme de désinstallation modifie le logiciel.

Pour supprimer tous les composants installés

Sélectionnez Supprimer dans la fenêtre de l'assistant Install Shield.

Cliquez sur Suivant.

Une boîte de dialogue de confirmation s'affiche.

Cliquez sur Oui pour confirmer la suppression.

La page d'état de l'installation s'affiche, suivie de la boîte de dialogue d'annulation de la configuration.

Cliquez sur Oui pour confirmer l'annulation de la configuration des composants Java ES.

La configuration des produits est annulée et les serveurs sont arrêtés, puis supprimés.

La page Terminer de l'assistant s'affiche. Vous pouvez afficher le résumé des détails de l'installation ou de la désinstallation en cliquant sur Afficher le résumé.

Cliquez sur Terminer pour quitter l'assistant de désinstallation.

Exécution du programme de désinstallation en mode Silencieux

La désinstallation en mode Silencieux permet de désinstaller les composants Java ES installés sur plusieurs hôtes partageant des configurations similaires. La procédure de désinstallation en mode Silencieux est semblable à celle de l'installation, comme cela est indiqué dans le Chapitre 4, Installation en mode Silencieux.

Pour effectuer la désinstallation en mode Silencieux

Changez de répertoire pour celui où se trouve le programme d'installation :

cd rép-installation-JavaES

Utilisez la commande Setup.bat /r pour créer le fichier réponse.

Utilisez l'option /f1 pour indiquer l'emplacement où créer le fichier réponse et spécifier son nom. Pour éviter des résultats inattendus, spécifiez un chemin absolu pour le fichier doté de l'extension .iss. Par exemple, tapez ce qui suit :

Setup.bat /r /f1"C:\Temp\ExempleDesinstallation.iss "

Toutes les données spécifiées et les options sélectionnées sont enregistrées dans le fichier .iss.

Le fichier réponse peut être utilisé pour stocker les options sélectionnées lors de l'enregistrement de la désinstallation. Il peut être modifié manuellement pour changer les options enregistrées.

Vous pouvez à présent utiliser le fichier réponse pour exécuter la désinstallation en mode Silencieux.

Changez de répertoire pour celui où se trouve le programme d'installation :

cd rép-installation-JavaES

Tapez la commande Setup.bat /s pour lancer le processus de désinstallation en mode Silencieux.

Utilisez l'option /f1 pour spécifier l'emplacement du fichier .iss. Pour éviter des résultats inattendus, indiquez un chemin absolu. Par exemple, tapez ce qui suit :

Setup.bat /s /f1"C:\Temp\ExempleDesinstallation.iss" .

(Facultatif) Utilisez l'option /f2 pour spécifier un nom de fichier réponse et un emplacement différents. Pour éviter des résultats inattendus, indiquez un chemin absolu pour le fichier. Par exemple, tapez ce qui suit :

Setup.bat /s /f1"C:\Temp\ExempleDesinstallation.iss /f2" C:\Setup.log".

Au cours de l'exécution du programme de désinstallation, vous pouvez surveiller son évolution en observant les modifications dans le journal d'installation.

Désinstallation de Java ES Reporter

Java ES Reporter n'est pas un composant géré par le programme d'installation de Java ES, vous ne pouvez donc pas utiliser le programme de désinstallation pour supprimer Reporter.

Désinstallation de Java ES Reporter

Désactivez Reporter.

Suivez les instructions fournies à la section Configuration post-installation de Java ES Reporter.

En tant qu'administrateur, supprimez les fichiers suivants :
- commons-codec-1.3.jar
- commons-httpcclient-3.0.jarc
- mfwk_reporter.jar
- config.properties
- job_measurement_reporter
- com.sun.mjwk.reporter
- config_state.properties