Sun Java Enterprise System Guide d�installation pour Microsoft Windows |
Chapitre 11
D�pannageCe chapitre comporte des suggestions concernant la r�solution des probl�mes d’installation et de d�sinstallation de Sun Java Enterprise System (Java ES).
Ce chapitre inclut les sections suivantes :
M�thodes g�n�rales de d�pannageCette section contient des instructions g�n�rales concernant la recherche de l’origine d’un probl�me. Ce chapitre comporte les sections suivantes :
Examen des fichiers journaux d’installation
Si un probl�me se produit durant l’installation ou la d�sinstallation, v�rifiez le fichier journal correspondant
dans le r�pertoire des fichiers journaux :
%TEMP%/SunJavaES.log
o� %TEMP% est le dossier TEMP d�fini par l’utilisateur sur le syst�me.
La consultation des fichiers journaux d’installation et de d�sinstallation, ainsi que des journaux de configuration Java ES, peut permettre de comprendre l’origine des probl�mes.
Pour utiliser les fichiers journaux � des fins de d�pannage, vous devez tenter d’isoler le premier probl�me qui s’est produit. Souvent, le premier probl�me est � l’origine des probl�mes cons�cutifs. Proc�dez comme suit :
- Consultez le fichier 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 <r�p_install>\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.
- Reportez-vous aux fichiers journaux d�taill�s.
- 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.
- Recherchez le nom du composant � l’origine du probl�me.
- Consultez les fichiers journaux de configuration. Ils se trouvent dans le dossier <r�p_install> du produit dans Summary.txt.
- Parcourez les fichiers journaux du programme d’installation pour tout probl�me relatif � l’installation ou � la d�sinstallation, et reportez-vous aux fichiers journaux du programme de configuration pour tout probl�me relatif � la configuration.
Consultation des fichiers journaux des composants
Si un probl�me se produit au d�marrage d’un composant, examinez ses fichiers journaux. La section Informations sur le d�pannage des composants, r�pertorie de nombreux fichiers journaux de composants.
V�rification des d�pendances des produits
De nombreux composants sont soumis � des interd�pendances lors de l’installation. Les probl�mes qui affectent un composant peuvent en affecter un autre. Pour v�rifier les interd�pendances non respect�es, reportez-vous aux informations incluses dans la section Impact des d�pendances entre composants sur l’installation. Proc�dez ensuite comme suit :
- Consultez le fichier r�sum� et les fichiers journaux pour savoir si un �chec a �t� consign� concernant des composants associ�s. Ces fichiers peuvent fournir des indications concernant les probl�mes � r�soudre en priorit�.
- Assurez-vous que les informations de connexion fournies sont correctes. Par exemple :
- Les informations que vous avez fournies lors de la configuration de Directory Server correspondent-elles aux informations de r�pertoire fournies pour les composants qui utilisent Directory Server ?
- Les informations concernant Access Manager fournies pour Portal Server ou Portal Server SRA correspondent-elles � celles fournies pour Access Manager ?
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 :
Reportez-vous � la section �tat des syst�mes pour v�rifier que toutes les configurations minimales requises ont �t� respect�es avant l’installation.
- Ports r�seau : durant la configuration, vous devez fournir des num�ros de port pour les composants de Sun Java Enterprise System. Proc�dez comme suit :
- Examinez les num�ros de port standard dans le fichier.
- Consultez le fichier journal de r�sum� pour comparer vos param�tres avec les param�tres standard. La saisie d’un num�ro de port est-elle incorrecte ou avez-vous d�fini un serveur sur un port g�n�ralement utilis� pour un autre ?
- Saisissez la commande netstat -a pour afficher le port actuel utilis� sur le syst�me. Avez-vous attribu� un num�ro de port d�j� utilis� ?
V�rifiez que vous avez entr� les noms d’h�te et de domaine corrects au cours de la configuration.
V�rification de la configuration post�rieure � l’installation
Si vous rencontrez des probl�mes au d�marrage des composants, v�rifiez que les proc�dures d�crites dans le Chapitre 7, � Configuration apr�s une installation avec configuration ult�rieure �, ont bien �t� respect�es.
V�rification des supports de distribution
Si vous effectuez l’installation � l’aide d’un DVD ou d’un CD-ROM, examinez le support pour savoir s’il a �t� modifi� ou endommag�. Les disques endommag�s peuvent entra�ner des probl�mes d’installation.
V�rification de la connectivit� de Directory Server
Si vous installez un composant qui d�pend de Directory Server, les causes des probl�mes peuvent �tre les suivantes :
En mode Configurer ult�rieurement, vous devez vous assurer que Directory Server est en cours d’ex�cution avant de configurer les produits qui en d�pendent.
Suppression du r�pertoire et des fichiers de Web Server
Pour �viter la suppression de fichiers personnalis�s, tels que des fichiers de configuration modifi�s, Web Server ne peut pas �tre install� dans un r�pertoire qui contient des fichiers.
Si vous r�installez Web Server, assurez-vous que les r�pertoires d’installation sont vides. Si ce n’est pas le cas, archivez les fichiers dans un autre emplacement et recommencez l’installation.
V�rification des 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. Si la d�sinstallation �choue, reportez-vous � la section �chec de l’installation suite � la pr�sence de fichiers non supprim�s apr�s la d�sinstallation.
Probl�mes d’installationCette 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 apr�s la d�sinstallation
Si une d�sinstallation �choue, il arrive que des composants n’aient pas �t� supprim�s. Dans ce cas, vous devez les supprimer manuellement avant de r�installer Java ES.
Nettoyage des fichiers
Si une installation ou une annulation de configuration pr�c�dente a �chou�, vous devez suivre les �tapes de nettoyage suivantes avant d’installer Sun Java Enterprise System.
- Assurez-vous que tous les services Sun Java Enterprise System sont arr�t�s et supprim�s dans Panneau de configuration > Outils d’administration > Services.
- Supprimez tout dossier Sun pr�c�demment install�.
- V�rifiez s’il reste des entr�es de services non supprim�es. S’il en reste dans les services, vous devez nettoyer le registre. La liste des entr�es de services se trouve dans le Tableau 11-1.
- Nettoyage du registre :
- Si vous ex�cutez l’une des �tapes ci-dessus, red�marrez le syst�me avant de proc�der � l’installation.
�chec de l’installation
L’installation peut �chouer suite � une erreur dans Windows Installer.
- Erreur 1603 - Erreur irr�cup�rable lors de l'installation : cette erreur peut �tre provoqu�e par tous les probl�mes mentionn�s sur le site Web de Microsoft http://support.microsoft.com/default.aspx?scid=kb;en-us;834484#kb5
- Erreur 1628 - Impossible de terminer l'installation bas�e sur le script : cette erreur ne survient qu’au moment de l’ex�cution. Elle survient normalement pendant la d�sinstallation, la r�paration ou lors de l’application d’un patch.
Pour r�soudre ces erreurs, reportez-vous au site http://support.installshield.com/kb/view.asp?articleid=Q107319.
Erreurs externes inattendues
Une panne de courant ou une d�faillance du syst�me s’est peut-�tre produite, ou bien vous avez appuy� sur les touches CTRL/C ou interrompu le programme d’installation depuis le gestionnaire des t�ches.
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 du programme de d�sinstallation, suivez les instructions de la section �chec de l’installation suite � la pr�sence de fichiers non supprim�s apr�s la d�sinstallation.
�chec de l’installation en mode silencieux � Le fichier de r�ponses est incompatible ou corrompu �
Si vous utilisez un fichier de r�ponses 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.
Suggestion : Cr�ez un nouveau fichier de r�ponses et recommencez l’installation.
Pour en savoir plus sur la proc�dure, reportez-vous � la section Cr�ation d’un fichier de r�ponses.
�chec de l’installation en mode silencieux
Si vous avez modifi� le fichier de r�ponses, vous avez peut-�tre introduit des erreurs. Par exemple, v�rifiez les points suivants :
Suggestion : R�solvez le probl�me et g�n�rez � nouveau le fichier de r�ponses comme cela est expliqu� dans la section Cr�ation d’un fichier de r�ponses.
Probl�mes de d�sinstallationCette section aborde le probl�me suivant que vous risquez de rencontrer lors de la d�sinstallation :
�chec de la d�sinstallation, certains des fichiers ne sont pas supprim�s
Si un nettoyage manuel est n�cessaire en raison de l’�chec de la d�sinstallation et par cons�quent de la suppression des fichiers ou des entr�es de services, reportez-vous � la section Nettoyage des fichiers.
Informations sur le d�pannage des composantsCette section comporte divers conseils sur les composants, avec des r�f�rences vers une documentation utile.
Elle comprend les sous-sections suivantes :
Outils de d�pannage d’Access Manager
Tableau 11-2 Access Manager Outils de d�pannage
Sujet
D�tails
Fichier de configuration
AMConfig.properties
<R�P_INSTALL>/AccessManager/Config
Fichiers journaux et fichiers de d�bogage
R�pertoire du fichier journal :
<R�P_INSTALL>/AccessManager/Logs
R�pertoire du fichier de d�bogage :
<R�P_INSTALL>/AccessManager/Debug
Mode de d�bogage
Reportez-vous au manuel Sun Java System Access Manager Developer’s Guide (http://docs.sun.com/doc/817-7649).
Outils de d�pannage d’Administration Server
Tableau 11-3 Outils de d�pannage d’Administration Server
Sujet
D�tails
Fichiers journaux
R�pertoire du fichier journal d’installation :
<R�P_INSTALL>/Server-root/admin-serv/logs/
Fichiers journaux de configuration :
Pour plus d’informations sur les param�tres de consignation, reportez-vous au manuel Sun Java System Administration Server Administration Guide (http://docs.sun.com/doc/817-7612).
D�pannage
Reportez-vous au manuel Sun Java System Administration Server Administration Guide (http://docs.sun.com/doc/817-7612).
Outils de d�pannage d’Application Server
Tableau 11-4 Outils de d�pannage d’Application Server
Sujet
D�tails
Fichiers journaux
R�pertoire du fichier journal :
<R�P_INSTALL>/ApplicationServer/Setup/
R�pertoire du journal de l’instance d’Application Server (emplacement par d�faut de l’instance initiale) :
<R�P_INSTALL>/ApplicationServer/
Nom des fichiers journaux des messages :
Fichiers de configuration
R�pertoire du fichier de configuration :
<R�P_INSTALL>/ApplicationServer/ConfigD�pannage
Reportez-vous au manuel Sun Java System Application Server Enterprise Edition Troubleshooting Guide (http://docs.sun.com/doc/819-0086).
Outils de d�pannage de Calendar Server
Tableau 11-5 Outils de d�pannage de Calendar Server
Sujet
D�tails
Fichiers journaux
Service d’administration (csadmind) : admin.log
Service de base de donn�es distribu�e (csdwpd) : dwp.log
Service HTTP (cshttpd) : http.log
Service de notification (csnotifyd) : notify.logR�pertoire par d�faut du fichier journal : <R�P_INSTALL>/CalenderServer/logs
Pour plus d’informations, reportez-vous au manuel Sun Java System Calendar Server Administration Guide (http://docs.sun.com/doc/819-0024).
Fichier de configuration
<R�P_INSTALL>/CalenderServer/bin/config/ics.conf
Mode de d�bogage
Pour utiliser le mode de d�bogage, un administrateur de Calendar Server d�finit le param�tre de configuration logfile.loglevel dans le fichier ics.conf. Par exemple :
logfile.loglevel = "debug"
Pour plus d’informations, reportez-vous au manuel Sun Java System Calendar Server Administration Guide (http://docs.sun.com/doc/819-0024).
D�pannage
Reportez-vous au manuel Sun Java System Calendar Server Administration Guide (http://docs.sun.com/doc/819-0024).
Outils de d�pannage de Communications Express
Tableau 11-6 Outils de d�pannage de Communications Express
Sujet
D�tails
Fichiers journaux
R�pertoire du fichier journal d’installation :
uwc-installed-path/install/uwc.log
D�pend de la valeur donn�e dans le fichier logging.properties d’UWC.
D�pannage
Reportez-vous au chapitre � Troubleshooting � du manuel Sun Java System Communications Express Administration Guide, http://docs.sun.com/doc/819-0115.
Outils de d�pannage de Directory Proxy Server
Tableau 11-7 Outils de d�pannage de Directory Proxy Server
Sujet
D�tails
Fichiers journaux
Fichier journal par d�faut : <R�P INSTALL>/Server-Root/dps- hostname/logs/fwd.log
Pour plus d’informations, reportez-vous au manuel Sun Java System Directory Proxy Server Administration Guide (http://docs.sun.com/doc/817-7615).
D�pannage
Reportez-vous au manuel Sun Java System Directory Proxy Server Administration Guide (http://docs.sun.com/doc/817-7615).
Outils de d�pannage de Directory Server
Tableau 11-8 Outils de d�pannage de Directory Server
Sujet
D�tails
Fichiers journaux
Le fichier journal d’installation se trouve dans le dossier tmp.
Fichiers journaux de configuration :
Pour plus d’informations sur la gestion des fichiers journaux, reportez-vous au manuel Sun Java System Directory Server Administration Guide (http://docs.sun.com/doc/817-7613).
D�pannage
Reportez-vous au manuel Sun Java System Directory Server Administration Guide (http://docs.sun.com/doc/817-7613).
Outils de d�pannage d’Instant Messaging
Tableau 11-9 Outils de d�pannage d’Instant Messaging
Sujet
D�tails
Fichiers journaux
Fichier journal du serveur : xmppd.log
Fichier journal du calendrier de l’agent : agent-calendar.log
R�pertoire par d�faut du fichier journal : <R�P_INSTALL>/Instant Messaging/log
Pour plus d’informations, reportez-vous au manuel Sun Java System Instant messaging Server Administration Guide (http://docs.sun.com/doc/819-0430).
Fichier de configuration
<R�P_INSTALL>/Instant Messaging/config/iim.conf
Mode de d�bogage
Pour utiliser le mode de d�bogage, un administrateur d’Instant Messaging Server d�finit le param�tre de configuration iim.log.iim_server.severity dans le fichier iim.conf. Par exemple :
! Log severity for the server component.
iim.log.iim_server.severity = "DEBUG"! Log severity for the multiplexor component.
iim.log.iim_mux.severity = "DEBUG"Pour plus d’informations, reportez-vous au manuel Sun Java System Instant Messaging Server Administration Guide (http://docs.sun.com/doc/ <n� doc:>).
D�pannage
Reportez-vous au manuel Sun Java System Instant Messaging Server Administration Guide http://docs.sun.com/doc/819-0024
Outils de d�pannage de Message Queue
Tableau 11-10 Outils de d�pannage de Message Queue
Sujet
D�tails
Fichiers journaux
Fichier journal d’installation :
<R�P_INSTALL>/MessageQueue/var/instances/<nom instance>/log
Reportez-vous au manuel Sun Java System Message Queue Administration Guide (http://docs.sun.com/doc/819-0066).
D�pannage
En cas de probl�mes relatifs aux performances, reportez-vous au chapitre � Analyzing and Tuning a Message Service � du manuel Sun Java System Message Queue Administration Guide (http://docs.sun.com/doc/819-0066).
Le d�pannage de Message Queue est abord� dans le chapitre sur la r�solution des probl�mes dans le manuel Sun Java System Message Queue Administration Guide et sur le forum de MQ, � l’adresse suivante : http://swforum.sun.com/jive/forum.jspa?forumID=24.
Vous trouverez des articles suppl�mentaires dans la base de connaissances � l’adresse http://developers.sun.com/prodtech/msgqueue/reference/techart/index.html
Outils de d�pannage de Messaging Server
Tableau 11-11 Outils de d�pannage de Messaging Server
Sujet
D�tails
Emplacement d'ex�cution
<R�P_INSTALL>/Sun/Server-root/sbin
Fichiers journaux
<R�P_INSTALL>/Sun/Server-root/data/log
D�pannage
Reportez-vous au manuel Sun Java System Messaging Server Administration Guide (http://docs.sun.com/doc/819-0105).
Outils de d�pannage de Portal Server
Tableau 11-12 Outils de d�pannage de Portal Server
Sujet
D�tails
Fichiers journaux et fichiers de d�bogage
Portal Server utilise les m�mes fichiers journaux et fichiers de d�bogage qu’Access Manager. Leur r�pertoire est le suivant :
Pour plus d’informations sur la gestion des fichiers journaux et des fichiers de d�bogage de Portal Server, reportez-vous au manuel Sun Java System Portal Server Administration Guide, (http://docs.sun.com/doc/817-5324).
Pour Portal Server Desktop, les fichiers de d�bogage sont :
Pour plus d’informations sur la gestion de ces fichiers, reportez-vous au manuel Sun Java System Portal Server Administration Guide, (http://docs.sun.com/doc/817-5324).
Les utilitaires des lignes de commande Portal Server dpadmin, par, rdmgr et sendrdm disposent d’options qui permettent de g�n�rer des messages de d�bogage. Ces options sont d�crites dans le manuel Portal Server Administrator’s Guide.
Outils de d�pannage de Portal Server Secure Remote Access
Outils de d�pannage de Web Server
Tableau 11-14 Outils de d�pannage de Web Server
Sujet
D�tails
Fichiers journaux
Il existe deux types de fichiers journaux Web Server : le fichier journal errors et le fichier journal access, tous deux situ�s dans le r�pertoire
<R�P_INSTALL>/Web Server>/https-instance-name/logsLe fichier journal d'erreurs 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 manuel Sun One Web Server 6.1 Administrator’s Guide (http://docs.sun.com/doc/817-6247-10).
D�pannage
Reportez-vous au manuel Sun One Web Server 6.1 Installation and Migration Guide (http://docs.sun.com/doc/819-0131).
R�pertoire du fichier de configuration
<R�P_INSTALL>/Web Server>/https-instance-name/config
Mode de d�bogage
Les options suivantes sont disponibles :
- Les r�sultats du journal peuvent �tre utilis�s � des fins de diagnostic et de d�bogage. Vous pouvez affecter les valeurs suivantes � l’attribut loglevel de l’�l�ment LOG dans le fichier /racine_serveur/https-nom_instance/config/server.xml : info, fin, plus fin ou le plus fin. Ces valeurs indiquent le niveau de d�tails des messages de d�bogage, la valeur � le plus fin � fournissant le maximum de d�tails. Pour plus d’informations sur l’�l�ment LOG, reportez-vous au manuel Sun ONE Web Server Administrator’s Configuration File Reference (http://docs.sun.com/doc/817-6248-10).
- Un indicateur de d�bogage peut �tre activ� pour lancer le conteneur Web du serveur en mode de d�bogage en combinaison avec Java Platform Debugger Architecture (programme de d�bogage JPDA). Pour ce faire, param�trez la valeur de l’indicateur jvm.debug de l’attribut JAVA dans le fichier /racine_instance/https-nom_serveur/config/server.xml sur true. Pour plus d’informations, reportez-vous au manuel Sun ONE Web Server Administrator’s Configuration File Reference (http://docs.sun.com/doc/817-6248-10).
- Le plug-in Sun Java System Studio 5, Standard Edition permet le d�bogage d’applications Web. Pour plus d’informations, reportez-vous au manuel Sun ONE Web Server Programmer’s Guide to Web Applications (http://docs.sun.com/doc/817-6251-10).
Outils de d�pannage de Delegated Administrator
Tableau 11-15 Outils de d�pannage de Delegated Administrator
Sujet
D�tails
Fichiers journaux
R�pertoire du fichier journal d’installation :
Emplacement d'ex�cution
[R�P_INSTALL]\DelegatedAdmin\lib
D�pannage
Reportez-vous au manuel Delegated Administrator Guide (http://docs.sun.com/doc/819-0114-10).
Outils de d�pannage de High Availability Session Store
Tableau 11-16 Outils de d�pannage de High Availability Session Store
Sujet
D�tails
Fichiers journaux
Emplacement d'ex�cution
[R�P_INSTALL]\Hadb\4.4.1-7\lib
D�pannage
Reportez-vous au guide de l’administrateur de High Availability Session Store (http://docs.sun.com/doc/819-0216).
Informations suppl�mentaires sur le d�pannageLes informations suppl�mentaires suivantes sont utiles pour le d�pannage :
- Le Chapitre 2, � D�veloppement de la s�quence d’installation � contient des informations sur les interd�pendances de composants. Pour en savoir plus, reportez-vous au Tableau 2-2.