Sun logo      Pr�c�dent      Sommaire      Index      Suivant     

Sun Java Enterprise System 2003Q4 Manuel d'installation

Chapitre 9
R�solution des probl�mes d'installation

Ce chapitre comporte des suggestions concernant la r�solution des probl�mes d'installation. Il se compose des sections suivantes :

Liste de contr�le de r�solution des probl�mes

Cette section comporte des suggestions concernant la recherche de l'origine d'un probl�me. Elle se compose des rubriques 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.

Les fichiers journaux du programme d'installation se trouvent dans le r�pertoire /var/sadm/install/logs. Le tableau ci-apr�s �num�re les fichiers journaux ainsi que leur nom. Pour la plupart des journaux, il existe deux versions :

Certains composants enregistrent les fichiers journaux dans le m�me r�pertoire, notamment Administration Server, Application Server, Directory Server, Portal Server et Identity Server. Pour plus d'informations sur les fichiers journaux des composants, reportez-vous � la section « Informations sur les composants pour la r�solution de probl�mes ».

Pour utiliser les fichiers journaux afin de r�soudre les probl�mes, 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 :

  1. 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�.

    2. 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 ou du package � l'origine du probl�me.

Les fichiers journaux peuvent fournir des pistes qui d�terminent les �tapes suivantes, par exemple :

Examen 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 �num�r�s dans la section « Informations sur les composants pour la r�solution de probl�mes ».

V�rification des d�pendances des produits

Plusieurs 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 contenues dans la section « D�pendances des composants ». V�rifiez ensuite les points suivants :

Pour une br�ve pr�sentation des d�pendances de composants sp�cifiques, reportez-vous � la section « Informations sur les composants pour la r�solution de probl�mes ».

Outre les d�pendances entre composants, certains composants d�pendent de l'existence de packages Solaris qui ne sont peut-�tre pas install�s sur la machine, et leur absence peut faire �chouer l'installation. Reportez-vous � la section relative � la configuration logicielle des notes de mise � jour pour plus d'informations.

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.

Ex�cution des proc�dures de v�rification

Si vous tentez de r�soudre des probl�mes en ex�cutant des composants, assurez vous que les processus de ceux ci sont activ�s et effectuez les v�rifications d�crites dans le chapitre 8, « Configuration et d�marrage apr�s installation ».

V�rification des supports de distribution

Si vous effectuez l'installation � l'aide d'un DVD ou d'un CD-ROM, le support est-il en bon �tat ? 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 :

Les modes interactifs du programme d'installation v�rifient la connectivit� de Directory Server lors de l'installation, contrairement au mode automatis�. Si vous effectuez une installation automatis�e lorsque Directory Server n'est pas disponible, les probl�mes suivants peuvent se produire :

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 machines, vous devez imp�rativement vous assurer que vous fournissez les mots de passe correspondants pour chaque machine.

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 « Nettoyage suite � une installation partielle ».

Utilisation de l'outil prodreg pour v�rifier et d�sinstaller les composants

Si vous avez install� des composants mais que vous rencontrez des probl�mes et que vous ne parvenez pas � effectuer une r�installation ou une d�sinstallation, vous pouvez utiliser l'outil prodreg. Il comporte une interface graphique pour le registre des produits Solaris et propose une interface facile � utiliser pour les composants et leur package, rempla�ant ainsi les utilitaires des packages.

Pour appeler l'outil prodreg, saisissez le nom de la commande dans la ligne de commande. Pour plus d'informations, reportez-vous � la page du manuel de prodreg(1).

Nettoyage suite � une installation partielle

Si le programme de d�sinstallation �choue, il peut toutefois laisser des composants ou des packages install�s. Dans ce cas, vous devez supprimer manuellement les composants ou les packages afin de proc�der � la r�installation. Ce probl�me peut appara�tre de l'une des fa�ons suivantes :

    Pour nettoyer une installation partielle
  1. Saisissez la commande suivante pour savoir si des packages ont d�j� �t� partiellement install�s.

    2. pkginfo -p

    Une liste comportant les packages partiellement install�s appara�t. À l'aide des noms de ces packages, reportez-vous � l'annexe D, « Liste des packages pouvant �tre install�s » pour savoir � quels composants les packages correspondent.

  2. Supprimez les composants ou les packages.
    • Pour Solaris 9, utilisez l'outil prodreg.

      • L'outil prodreg g�re les composants associ�s � des packages qui se trouvent sur votre machine. Vous pouvez afficher les composants et leur package, ainsi que toutes les informations les concernant, notamment leurs interd�pendances. Vous pouvez utiliser l'outil prodreg pour d�sinstaller les composants et supprimer les packages en toute s�curit�. Apr�s avoir supprim� un composant avec l'outil prodreg, vous pouvez le r�installer.

    • Pour Solaris 8, utilisez la commande pkgrm.

      • La commande pkgrm implique que vous supprimiez les composants package par package. Elle ne met pas � jour le registre des produits. En fonction de ce qui s'est pass�, vous pouvez restaurer le fichier de registre des produits archiv�s ou le modifier manuellement afin qu'il ne se r�f�re plus aux composants supprim�s.

      Pour modifier le fichier de registre des produits, ouvrez le fichier /var/sadm/install/productregistry. Ce fichier XML d�crit chaque composant. Chaque description du composant commence par une balise <compid> et termine par une balise </compid>. Supprimez la totalit� de l'entr�e du composant.

  3. Supprimez le r�pertoire d'installation de Web Server, s'il existe.
  4. Ex�cutez � nouveau le programme d'installation.

Le tableau suivant r�pertorie les fichiers et r�pertoires de composants que vous devez supprimer.

Exemples de probl�mes et solutions

Cette section comporte des explications et des suggestions pour r�soudre les probl�mes propos�s � titre d'exemple.

Probl�mes lors de la configuration d'IBM WebSphere comme conteneur Web d'Identity Server

Cause :     WebSphere n'est peut-�tre pas en cours d'ex�cution ou la valeur WebSphere sp�cifi�e ne correspond pas � la configuration d'origine de WebSphere.

Suggestion :     tout d'abord, assurez-vous que WebSphere est actif.

Ensuite, examinez les valeurs de ces deux champs du programme d'installation :

Utilisez les outils WebSphere pour v�rifier la configuration, assurez vous qu'elle correspond aux valeurs saisies et recommencez.

Une autre m�thode consiste � cr�er des instances des entit�s WebSphere et de recommencer :

  1. Utilisez la commande adminclient.sh pour lancer la console WebSphere.
  2. Cr�ez une instance de l'h�te virtuel et un nom d'instance du serveur d'application.
  3. Cliquez sur l'entr�e qui se trouve sous le nœud (en g�n�ral, le nom de l'h�te) et s�lectionnez R�g�n�rer plug-in WebServer.

    4. Ce processus enregistre les nouvelles entr�es dans le fichier de configuration plugin, dans lequel le programme d'installation recherche les noms valides.

  4. Revenez au programme d'installation et entrez les valeurs cr��es.
Une erreur externe inattendue s'est produite

Cause :     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 pour interrompre le programme d'installation.

Suggestion :     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 « Nettoyage suite � une installation partielle ».

Aucune r�ponse du programme d'installation graphique

Cause :     le programme d'installation cr�e parfois une image � l'�cran avant qu'elle ne soit pr�te pour la saisie de donn�es. Vous ne pouvez pas cliquer sur Suivant de fa�on r�p�t�e et sans interruption dans l'assistant d'installation.

Suggestion :     le bouton qui repr�sente le choix par d�faut contient un rectangle bleu. Ce rectangle appara�t parfois apr�s le bouton lui-m�me. Attendez que le rectangle bleu apparaisse avant de cliquer sur un bouton.

�chec de l'installation automatis�e avec une erreur de fichier d'�tat incompatible ou corrompu

Cause :     si vous utilisez un fichier d'�tat 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.

Si vous utilisez un fichier d'�tat cr�� sur une autre plate-forme ou version, le probl�me peut �tre d� au fait que les fichiers d'�tat doivent �tre ex�cut�s sur le m�me type de plate-forme que celle sur laquelle ils ont �t� cr��s. Si vous avez cr�� le fichier d'�tat sur Solaris 9, vous ne pouvez pas l'utiliser sur Solaris 8, et si vous l'avez cr�� sur la plate-forme x86, vous ne pouvez pas l'utiliser sur la plate-forme Sparc.

Suggestion :     si vous avez cr�� le fichier d'�tat sur la m�me plate-forme que celle sur laquelle vous l'utilisez, g�n�rez un fichier d'�tat et r�installez-le.

Si la plate-forme sur laquelle vous avez cr�� le fichier d'�tat n'est pas la m�me que celle sur laquelle vous l'utilisez, pour r�soudre le probl�me, cr�ez un ID correspondant � la plate-forme pour le fichier. Pour en savoir plus sur la proc�dure, reportez-vous � la section « Cr�ation d'un ID pour les plates-formes ».

�chec de l'installation automatis�e

Cause :     si vous avez modifi� le fichier d'�tat, vous avez peut-�tre introduit des erreurs. Par exemple, v�rifiez les points suivants :

Suggestion :     r�g�n�rez le fichier d'�tat � l'aide du programme d'installation graphique et en enregistrant ses valeurs, comme indiqu� dans la section « G�n�ration d'un fichier d'�tat ».

Informations sur les composants pour la r�solution de probl�mes

Cette section comporte divers conseils sur les composants, avec des r�f�rences vers une documentation utile.

Les informations suppl�mentaires suivantes sont utiles pour la r�solution des probl�mes :

Administration Server

Fichiers journaux

R�pertoire du fichier journal d'installation :

/var/sadm/install/logs

Fichiers de configuration :

Administration_Server_install.Ahorodatage
Administration_Server_install.Bhorodatage

Pour plus d'informations sur les param�tres de journal, reportez-vous au manuel Sun ONE Server Console 5.2 Server Management Guide (http://docs.sun.com/doc/816-6704-10), chapitre-6 « Administration Server Basics » (Op�rations �l�mentaires sur Administration Server).

Informations sur la r�solution des probl�mes

Reportez-vous au manuel Sun ONE Server Console 5.2 Server Management Guide (http://docs.sun.com/doc/816-6704-10), chapitre 1, « Installing Sun ONE Directory Server » (Installation de Sun ONE Directory Server).

Application Server

Fichiers journaux

R�pertoire du fichier journal :

Nom des fichiers journaux :

R�pertoire du journal de l'instance Application Server (emplacement par d�faut de l'instance initiale) :

Nom des fichiers journaux des messages :

R�pertoire du journal d'Administration Server (emplacement par d�faut du domaine administratif initial) :

Fichier journal d'Administration Server :

Fichiers de configuration

R�pertoire du fichier de configuration : /var

Calendar Server

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.log

R�pertoire par d�faut du fichier journal : /var/opt/SUNWics5/logs

Pour plus d'informations, reportez-vous au manuel Sun ONE Calendar Server Administrator's Guide (http://docs.sun.com/doc/816-6708-10), chapitre 3 « Managing Calendar Server » (Gestion de Calendar Server).

Fichier de configuration :

/opt/SUNWics5/cal/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 ONE Calendar Server Administrator's Guide (http://docs.sun.com/doc/816-6708-10). Consultez les chapitres suivants :

Informations sur la r�solution des probl�mes

Reportez-vous au manuel Sun ONE Calendar Server Administrator's Guide (http://docs.sun.com/doc/816-6708-10). Consultez les chapitres suivants :

Directory Proxy Server

Journalisation

Fichier journal par d�faut : base_svr_dps/dps-nomh�te/logs/fwd.log

Pour plus d'informations, reportez-vous au manuel Directory Proxy Server Administration Guide (http://docs.sun.com/doc/816-6391-10), chapitre 10, « Configuring and Monitoring Logs » (Configuration et gestion des journaux).

R�solution des probl�mes

Reportez-vous au manuel Directory Proxy Server Administration Guide (http://docs.sun.com/doc/816-6391-10), annexe B, « Directory Proxy Server FAQ, Features, and Troubleshooting » (FAQ sur Directory Proxy Server, fonctions et r�solution des probl�mes).

Directory Server

Fichiers journaux

Fichier journal d'installation :

/var/sadm/install/log

Fichiers de configuration :

Directory_Server_install.Ahorodatage
Directory_Server_install.Bhorodatage

Pour plus d'informations sur la gestion des fichiers journaux, reportez-vous au manuel Sun ONE Directory Server Administration Guide (http://docs.sun.com/source/816-6698-10/logs.html), chapitre 12 « Managing Log Files » (Gestion des fichiers journaux).

Pour plus d'informations sur l'outil logconv.ps qui permet d'analyser le journal d'acc�s, reportez-vous au manuel Sun ONE Directory Server Resource Kit Tools Reference (http://docs.sun.com/doc/816-6400-10/logconv.html), chapitre 24, « logconv.pl ».

R�solution des probl�mes

Reportez vous au manuel Directory Server Installation and Tuning Guide (http://docs.sun.com/doc/816-6697-10), chapitre 1, « Installing Sun ONE Directory Server » (Installation de Sun ONE Directory Server).

Identity Server

Fichier de configuration :

/opt/SUNWam/lib/AMConfig.properties

Mode de d�bogage

Pour plus d'informations, reportez-vous au manuel Sun ONE Identity Server 6.1 Customization and API Guide (http://docs.sun.com/doc/816-6774-10). Consultez les sections suivantes :

Instant Messaging

Documentation utile

Reportez-vous au manuel Instant Messaging Administrator's Guide (http://docs.sun.com/doc/817-4113-10).

Message Queue

Fichiers journaux

Reportez-vous au manuel Sun ONE Message Queue Administrator's Guide (http://docs.sun.com/doc/817-0354-10). Consultez les chapitres suivants :

La r�solution des probl�mes de Sun ONE Message Queue fait l'objet d'une discussion dans le forum 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.

Messaging Server

Documentation sur la r�solution des probl�mes

Reportez-vous au manuel Sun ONE Messaging Server Administrator's Guide (http://docs.sun.com/doc/816-6738-10).

Emplacement d'ex�cution

/opt/SUNWmsgsr/lib/

Portal Server

Fichiers journaux et fichiers de d�bogage

Portal Server utilise les m�mes fichiers journaux et fichiers de d�bogage qu'Identity Server. Leur r�pertoire est le suivant :

Fichier journal : /var/opt/SUNWam/logs
Fichier de d�bogage : /var/opt/SUNWam/debug

Pour plus d'informations sur les fichiers journaux et les fichiers de d�bogage de Portal Server, reportez-vous au manuel Portal Server Administrator's Guide (http://docs.sun.com/doc/816-6748-10).

Pour Portal Server Desktop, les fichiers de d�bogage sont :

/var/opt/SUNWam/debug/desktop.debug
/var/opt/SUNWam/debug/desktop.dpadmin.debug

Pour plus d'informations sur la gestion de ces fichiers, reportez-vous au manuel Portal Server Administration Guide, section « Administering the Desktop Service » (Administration du service de bureau).

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.

Portal Server, Secure Remote Access

Fichiers de d�bogage

Les fichiers de d�bogage de Portal Server se trouvent dans les r�pertoires suivants :

/var/opt/SUNWam/debug
/var/opt/SUNWps/debug

Les fichiers de d�bogage de la passerelle Portal se trouvent dans ce r�pertoire : /var/opt/SUNWps/debug

Sun Cluster et Sun Cluster Agents

Pour obtenir des informations sur la configuration du logiciel Sun Cluster et de Sun ONE Agents pour Sun Cluster, reportez-vous au manuel Sun Cluster 3.1 Software Installation Guide, disponible � l'adresse http://docs.sun.com/doc/816-3388.

Web Server

Fichiers journaux

Il existe deux types de canal de services Web simples : le fichier journal d'erreurs et le fichier journal d'acc�s, tous deux install�s dans le r�pertoire /opt/SUNWwbsvr/racine_serveur/https-nom_serveur/logs.

Le fichier journal d'erreurs r�pertorie toutes les erreurs rencontr�es par le serveur. Le fichier journal d'acc�s 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-1831-10), chapitre 10, « Using Log Files » (Utilisation de fichiers journaux).

Informations sur la r�solution des probl�mes

Reportez-vous au manuel Sun ONE Web Server 6.1 Installation and Migration Guide (http://docs.sun.com/doc/817-1830-10).

R�pertoire du fichier de configuration

/opt/SUNWwbsvr/http-nom_instance/config

Mode de d�bogage

Les options suivantes sont disponibles :



Pr�c�dent      Sommaire      Index      Suivant     

Copyright 2003 Sun Microsystems, Inc. Tous droits r�serv�s.