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

Chapitre 8 Dépannage

Ce chapitre comporte des suggestions concernant la résolution des problèmes d'installation et de désinstallation de Sun JavaTM Enterprise System (Java ES).

Il inclut les sections suivantes :

Méthodes générales de dépannage

Cette section fournit des directives générales destinées à permettre l'identification de l'origine d'un problème. Elle traite les points suivants :

Connectivité réseau

L'installation de Java ES n'est pas prise en charge sur un hôte autonome. L'hôte doit être connecté à un réseau pour pouvoir installer Java ES.

Vérification de la connectivité de Directory Server

Si vous installez un composant qui dépend de Directory Server, les causes des problèmes rencontrés peuvent être les suivantes :

Si vous utilisez l'option Configurer manuellement après l'installation, vous devez vous assurer que Directory Server est en cours d'exécution avant de configurer les produits qui dépendent de lui.

Vérification de la configuration post-installation

Si vous rencontrez des problèmes au démarrage des composants, vérifiez que les procédures décrites au Chapitre 5, Exécution de la configuration post-installation ont bien été respectées.

Vérification des ressources et des paramètres

Les problèmes suivants au niveau de l'hôte peuvent entraîner des problèmes d'installation.

Pour vous assurer que toutes les conditions de configuration requises sont satisfaites avant de poursuivre l'installation, reportez-vous à la section Configuration système requise.

Vérification des supports de distribution

Si vous effectuez l'installation à l'aide d'un DVD, examinez le support pour vous assurer qu'il est propre et qu'il ne présente aucun dommage. Les disques endommagés peuvent entraîner des problèmes d'installation.

Consultation des fichiers journaux des composants

Si un problème se produit au démarrage d'un composant, examinez ses fichiers journaux. Plusieurs fichiers journaux de composants sont répertoriés dans la section Informations sur le dépannage des composants.

Consultation des fichiers journaux d'installation

Si un problème survient lors de l'installation ou de la désinstallation d'un produit, examinez le fichier journal approprié dans le répertoire %TEMP%/SunJavaES.log .

%TEMP% représente le dossier TEMP défini par l'utilisateur sur ce système.

L'examen des fichiers journaux du programme d'installation et du programme de désinstallation (ainsi que du fichier de configuration de Java ES) peut aider à identifier la cause des problèmes.

ProcedurePour consulter les fichiers journaux d'installation

  1. Consultez le fichier de résumé de l'installation, qui fournit une description très détaillée de ce qui a été installé et configuré. Ce fichier se trouve dans le répertoire rép-installation-JavaEs\Summary.txt. Si un problème s'est produit, déterminez quel composant en est à l'origine. S'il y a eu plusieurs problèmes, isolez le premier.

  2. Reportez-vous aux fichiers journaux détaillés.

    1. Recherchez le premier message d'erreur ou avertissement généré et tentez de le résoudre. Parfois, lorsqu'une erreur est résolue, il en est de même pour plusieurs erreurs consécutives similaires non associées.

    2. Recherchez le nom du composant à l'origine du problème.

    3. Examinez les fichiers journaux de configuration. Ces fichiers sont stockés dans le répertoire d'installation des composants. Examinez le fichier Summary.txt pour connaître l'emplacement exact des fichiers journaux des composants.

    4. Examinez le fichier journal du programme d'installation pour détecter tout problème d'installation ou de désinstallation. Utilisez les fichiers journaux de configuration pour identifier les éventuels problèmes de configuration.

Suppression des fichiers et du répertoire

Pour éviter la suppression de fichiers personnalisés, comme des fichiers de configuration modifiés, les composants Java ES 5 ne peuvent pas être installés dans leur répertoire respectif si celui-ci contient déjà des fichiers.

Si vous réinstallez Java ES 5, assurez-vous que les répertoires d'installation sont vides. Si ce n'est pas le cas, archivez les fichiers qu'ils contiennent à un autre emplacement et essayez de nouveau d'installer le logiciel.

Vérificationdes mots de passe

Le programme d'installation requiert la saisie de plusieurs mots de passe pour les composants. Si vous installez différents composants sur plusieurs hôtes, vous devez impérativement vous assurer que vous fournissez les mots de passe correspondants sur chaque hôte.

Pour résoudre les problèmes concernant les mots de passe, vous devrez peut-être effectuer une désinstallation suivie d'une réinstallation. En cas d'échec de la désinstallation, reportez-vous à la section Échec de l'installation suite à la présence de fichiers non supprimés lors de la désinstallation.

Vérification de la dépendance des composants

De nombreux composants sont soumis à des interdépendances lors de l'installation. Les problèmes qui affectent un composant peuvent en affecter d'autres. Pour identifier les interdépendances non satisfaites, familiarisez-vous avec les informations de la section Contrôle de dépendance. Puis, procédez comme suit :

Problèmes d'installation

Cette section aborde les problèmes suivants que vous risquez de rencontrer lors de l'installation :

Échec de l'installation suite à la présence de fichiers non supprimés lors de la désinstallation

En cas d'échec de la désinstallation, des composants qui auraient normalement dû être supprimés peuvent encore être présents sur votre système. Dans ce cas, vous devez supprimer manuellement les composants avant de réinstaller Java ES.

ProcedurePour supprimer les fichiers restants

Les étapes de nettoyage suivantes sont nécessaires avant de réinstaller Java ES après un échec d'installation ou de déconfiguration.

  1. Veillez à ce que tous les services Java ES soient arrêtés et supprimés de la liste des services, accessible en sélectionnant Panneau de configuration > Outils d'administration > Services.

  2. Supprimez tout dossier Sun précédemment créé. Si vous ne pouvez pas le supprimer, redémarrez le système, puis supprimez-le de nouveau.

  3. Localisez toute éventuelle entrée restante de service. Si des entrées de service figurent toujours dans la liste des services, vous devez nettoyer le registre en supprimant ces entrées. Les entrées possibles sont répertoriées dans le tableau ci-dessous.

    Nom du composant  

    Entrée de service  

    Conteneur d'agents communs 

    Common Agent Container 2 (#CRC :par défaut) 

    HADB 

    HADB4.4MgmtAgent

    Message Queue 

    MQ3.7UR1_Broker

    Portal Server 

    sra.gateway.instance-sra

    sra.netletproxy.instance-sra

    sra.rewriterproxy.instance-sra

    WebAdminServer 

    https-admserv70

    Web Console 

    Web Console 3.0.2 console  

    Web Proxy Server 

    Sun Java System Socks Server 4.0.4 (server1)

    Sun Java System Web Proxy Server 4.0.4 (proxy-server1)

    Sun Java System Web Proxy Server 4.0.4 Administration Server  

    Web Server 

    Sun Java System Web Server 7.0 (https-hostname.domainname)

    Sun Java System Web Server 7.0 Administration Server 

  4. Nettoyez l registre.

    Supprimez la clé HKEY_LOCAL_MACHINE\Software\Sun Microsystems\Entsys5\Installer.

  5. Si vous effectuez l'une des étapes précédentes, redémarrez le système avant de commencer l'installation.

Erreurs du programme d'installation Windows

L'échec de l'installation peut être dû à l'erreur suivante du programme d'installation Windows.

Échec de l'installation en mode Silencieux

Si vous avez modifié le fichier réponse, vous avez peut-être introduit des erreurs. Par exemple, vérifiez les points suivants :

Résolvez le problème et générez de nouveau le fichier réponse, conformément aux instructions fournies à la section Création d'un fichier réponse.

Échec de l'installation en mode Silencieux : « Fichier réponse incompatible ou corrompu »

Si vous utilisez un fichier réponse créé sur la même plate-forme que celle sur laquelle vous l'utilisez, le problème peut être dû à une erreur de fichier corrompu inconnue. Générez un nouveau fichier réponse et réinstallez le logiciel.

Pour plus d'informations à ce sujet, reportez-vous à la section Création d'un fichier réponse.

Erreurs externes inattendues

Les causes possibles des erreurs externes sont les suivantes :

Si la défaillance s'est produite lors de l'installation ou de la configuration, il se peut que vous disposiez d'une installation partielle. Exécutez le programme de désinstallation. En cas d'échec de la désinstallation, suivez les instructions fournies à la section Échec de l'installation suite à la présence de fichiers non supprimés lors de la désinstallation.

Base de données Portal introuvable après le redémarrage de Java DB

Cette situation peut se produire si vous déployez un exemple Application Server qui utilise Java DB après avoir exécuté la commande Application Server par défaut pour redémarrer Java DB (asadmin stop-database, puis asadmin start-database). Les exemples Portal Server ne sont plus accessibles.

Solution : Use one of the following workaround:

Informations sur le dépannage des composants

Cette section comporte divers conseils sur le dépannage des composants, avec des références vers une documentation utile.

Conseils de dépannage pour Access Manager

Tableau 8–1 Conseils de dépannage pour Access Manager

Thème 

Détails 

Fichier de configuration 

base-AccessManager\Config\AMConfig.properties

Fichiers journaux et fichiers de débogage 

Répertoire des fichiers journaux : 

base-AccessManager\Logs

Répertoire des fichiers de débogage : 

base-AccessManager\Debug

Mode de débogage 

Reportez-vous au Sun Java System Access Manager Developer’s Guide.

Conseils de dépannage pour Application Server

Tableau 8–2 Conseils de dépannage pour Application Server

Thème 

Détails 

Fichiers journaux 

Répertoire des fichiers journaux : 

rép-installation-JavaES\appserver\domain\domain1 \logs

Nom des fichiers journaux des messages : server.log, pour chaque instance de serveur.

Fichiers de configuration 

Répertoire des fichiers de configuration : base-ApplicationServer\Config.

Dépannage 

Reportez-vous au Sun Java System Application Server Enterprise Edition Troubleshooting Guide.

Conseils de dépannage pour Directory Server

Tableau 8–3 Conseils de dépannage pour Directory Server

Thème 

Détails 

Fichiers journaux 

Le fichier journal d'installation est stocké dans le dossier tmp.

Fichiers journaux de configuration : 

  • base-DirectoryServer.horodatage-A

  • base-DirectoryServer.horodatage-B

Pour plus d'informations sur la gestion des fichiers journaux, reportez-vous au Sun Java System Directory Server Administration Guide

Dépannage 

Consultez le Sun Java System Directory Server Administration Guide.

Conseils de dépannage pour HADB

Tableau 8–4 Conseils de dépannage pour HADB

Thème 

Détails 

Fichiers journaux 

rép-installation-JavaES\Hadb\4.4.3-5\ma\ma.log

Fichiers de configuration 

  • HADB.properties

  • mgt.cfg

Ces fichiers sont stockés dans le répertoire rép-installation-JavaES\Hadb\4.4.3-5\lib\ .

Emplacement de l'exécutable 

rép-installation-JavaES\Hadb\4.4.3-5\bin\

Dépannage 

Consultez le High Availability Session Store Administrator’s Guide.

Conseils de dépannage pour Message Queue

Tableau 8–5 Conseils de dépannage pour Message Queue

Thème  

Détails 

Fichiers journaux 

Fichier journal d'installation : 

base-MessageQueue\var\instances\ nom-instance\log

Consultez le Sun Java System Message Queue 3.7 UR1 Administration Guide.

Dépannage 

Pour les problèmes relatifs aux performances, reportez-vous au Chapitre 11, Analyzing and Tuning a Message Service du Sun Java System Message Queue 3.7 UR1 Administration Guide.

Le dépannage de Message Queue est traité au Chapitre 12, Troubleshooting Problems du Sun Java System Message Queue 3.7 UR1 Administration Guide et sur le forum Message Queue, accessible à l'adresse : http://swforum.sun.com/jive/forum.jspa?forumID=24.

Des articles supplémentaires sont accessibles via la base de connaissance, accessible à l'adresse http://developers.sun.com/prodtech/msgqueue/reference/techart/index.html.

Conseils de dépannage pour Monitoring Console

Tableau 8–6 Conseils de dépannage pour Monitoring Console

Thème 

Détails 

Fichiers de configuration 

Pour Monitoring Console : 

  • base-MonitoringConsole\WEB-INF\web.xml

Pour Monitoring Framework : 

  • rép-installation-JavaES\share\mfwk\config\mfwk.properties

Fichiers journaux 

Pour Monitoring Console : 

  • rép-installation-JavaES\share\webconsole\console\console_config_log

Pour Monitoring Framework : 

  • rép-installation-JavaES\share\mfwk\logs

Dépannage 

Si vous ne pouvez pas accéder à Monitoring Console, reportez-vous à la section Dépannage du composant Monitoring Console du Guide de la fonction de contrôle de Sun Java Enterprise System 5. Pour dépanner Monitoring Console, reportez-vous à la section Dépannage du composant Monitoring Framework du Guide de la fonction de contrôle de Sun Java Enterprise System 5.

Conseils de dépannage pour Portal Server Secure Remote Access

Tableau 8–7 Conseils de dépannage pour Portal Server Secure Remote Access

Thème 

Détails 

Fichiers journaux de débogage 

Les fichiers journaux de débogage de la passerelle Portal Server sont stockés dans le répertoire base-PortalServer\debug.


Remarque –

Les fichiers journaux des services de Portal Server (comme NetFile) se trouvent dans le répertoire base-AccessManager\debug lorsque vous activez la consignation à partir de la console d'administration d'Access Manager.


Conseils de dépannage pour Portal Server

Tableau 8–8 Conseils de dépannage pour Portal Server

Thème  

Détails 

Fichiers journaux et fichiers de débogage 

Les fichiers journaux de Portal Server sont les suivants : 

  • Fichiers journaux psadmin : base-PortalServer\data\admin

  • Fichiers de configurationbase-PortalServer\data\config

  • Fichiers journaux des instances de Portal Server : base-PortalServer\data\portals\ID-portail\logs\ ID-instance

Conseils de dépannage pour Service Registry

Tableau 8–9 Conseils de dépannage pour Service Registry

Thème 

Détails  

Fichiers journaux 

Fichier journal par défaut :base-ServiceRegistry\domains\registry\logs\server.log

Pour plus d'informations à ce sujet, reportez-vous au Service Registry 3.1 Administration Guide.

Dépannage 

Consultez le Service Registry 3.1 Administration Guide.

Conseils de dépannage pour Web Proxy Server

Tableau 8–10 Conseils de dépannage pour Web Proxy Server

Thème 

Détails 

Fichiers journaux 

Fichiers journaux par défaut : 

  • rép-installation-JavaES\ nom-instance\config\logs\errors

  • rép-installation-JavaES\ nom-instance\config\logs\access

  • rép-installation-JavaES\ nom-administrateur\config\logs\errors

  • rép-installation-JavaES\ nom-administrateur\config\logs\access

Pour plus d'informations, reportez-vous au Sun Java System Web Proxy Server Administration Guide.

Dépannage 

Consultez le Sun Java System Web Proxy Administration Guide.

Conseils de dépannage pour Web Server

Tableau 8–11 Conseils de dépannage pour Web Server

Thème  

Détails 

Fichiers journaux 

Les fichiers journaux errors et access se trouvent dans le répertoire base-WebServer\WebServer_Install.log.

Le fichier journal errors répertorie toutes les erreurs rencontrées par le serveur. Le fichier journal access enregistre des informations sur les requêtes destinées au serveur et les réponses de ce dernier. Pour plus d'informations, reportez-vous au Sun Java System Web Server 7.0 Administrator’s Guide.

Dépannage 

Consultez le Sun Java System Web Server 7.0 Troubleshooting Guide.

Répertoire du fichier de configuration 

base-WebServer\https-instance-name\config

Informations supplémentaires sur le dépannage

Les informations suivantes sont également utiles pour le dépannage :