Journalisation des événements système

Les messages pour HCL Portal sont enregistrés dans les fichiers suivants :

SystemOut.log

Contient des informations utiles pour contrôler la santé du serveur HCL Portal et de tous les processus en cours d'exécution.

System.err

Contient des informations de trace de pile d'exceptions qui s'avèrent utiles pour l'identification des problèmes.

Les traces peuvent être configurées pour différentes durées :

Temporary

Les traces peuvent être définies pour une durée temporaire à l'aide du portlet d'administration Activation de la fonction de trace ou de WebSphere® Integrated Solutions Console. Pour définir des traces à l'aide du portlet, procédez comme suit :

1. Connectez-vous en tant qu'administrateur.
2. Click the Administration menu icon. Then, click Portal Analysis > Enable Tracing. Le portlet Activation de la trace s'affiche.
3. Cliquez sur Administration du site > Administration avancée > Analyse du portail > Activation de la fonction de trace. Le portlet Activation de la trace s'affiche.
4. Entrez la chaîne de trace requise dans la zone Ajouter ces paramètres de trace :. Cette chaîne peut être par exemple : com.ibm.wps.command.credentialvault.*=finest
5. Cliquez sur l'icône Ajouter. Enable Tracing updates the Current trace settings field.

Remarque : Le redémarrage d'HCL Portal supprime les traces qui ont été définies à l'aide du portlet Administration de la trace.

Pour désactiver la fonction de trace, utilisez une des méthodes suivantes :

• Sélectionnez les paramètres de trace en cours sous Paramètres de trace en cours : puis cliquez sur l'icône Suppression. Le paramètre en cours peut être par exemple : com.ibm.wps.command.credentialvault.*=finest.
• Entrez la chaîne de trace *=info dans le champ Ajouter ces paramètres de trace : puis cliquez sur l'icône Ajout. La chaîne de trace remplace tous les paramètres répertoriés sous Paramètres de trace en cours : et rétablit la valeur par défaut.

Etendue

Pour activer les paramètres de trace pour une période plus longue, c'est-à-dire, pour plus d'une session, activez ces derniers dans la configuration de WebSphere® Application Server. Procédez comme suit :

1. Accédez à WebSphere® Integrated Solutions Console via l'URL suivante : http://hostname:port_number/ibm/console
2. Accédez à Serveurs > Types de serveurs > Serveurs d'applications WebSphere.
3. Sélectionnez le serveur d'applications.
4. Cliquez sur Identification et résolution des problèmes > Modification des niveaux de détail de journalisation.
5. Indiquez les paramètres de trace requis. Par exemple, ce paramètre peut être com.ibm.wps.command.credentialvault.*=finest
6. Enregistrez vos modifications.
7. Redémarrez le serveur WebSphere_Portal.
8. Pour désactiver le traçage, indiquez tracestring: *=info puis redémarrez le serveur WebSphere_Portal.

To change the language that is used for the log file, edit the file log.properties. Ce fichier se trouve dans le chemin HCL Portal suivant :

• AIX® HP-UX Linux™ Solaris: wp_profile_root/PortalServer/config/config
• z/OS® : wp_profile_root/PortalServer/config/config
• IBM® i: wp_profile_root/PortalServer/config/config
• Windows™ : wp_profile_root\PortalServer\config\config

Ajoutez la ligne de commande suivante :

locale=xx 

Where xx is the two-letter abbreviation for the locale. Pour obtenir une liste des abréviations d'environnement local utilisées avec HCL Portal, reportez-vous à la rubrique relative à la structure de répertoire et accédez à la section relative aux répertoires pour les langues. Pour que les informations de journal soient générées en anglais, ajoutez la ligne suivante :

 locale=en 

Les enregistrements de journalisation présentent le format suivant :

     timestamp classification classname method threadID
     messagecode: logmessage

Où :

• L'timestamp correspond à l'heure (à la milliseconde près) où l'enregistrement de journal a été créé.
• La valeur suivante classification correspond à l'une des lettres suivantes :

  E

  Pour les messages d'erreur

  W

  Pour les messages d'avertissement

  I

  Pour les messages d'informations

  l

  Pour les traces (niveau bas de détails)

  min

  Pour les traces (niveau moyen de détails)

  h

  Pour les traces (niveau élevé de détails)

• La valeur classname indique la classe Java contenant le code qui a déclenché l'événement de journalisation.
• La valeur method indique le nom de la méthode Java renfermant le code qui a déclenché l'événement de journalisation.
• La valeur messagecode correspond à un identificateur unique pour ce message, qui identifie de manière unique le message concerné et y fait référence lorsque vous consultez la documentation ou le support. Le code du message est disponible uniquement pour les messages d'erreur, d'avertissement ou d'information, et non pour les traces. Il comprend :
  • Un identificateur à quatre caractères pour le composant qui définit le message.
  • Un nombre à quatre chiffres qui identifie de manière unique le message figurant dans le composant.
  • Un code de classification à une lettre, qui peut être E, W ou I.
• La valeur logmessage indique le message de journalisation réel décrivant l'événement de journalisation. Les messages d'erreur, d'avertissement et d'information sont traduits dans l'environnement local système. Les messages de trace ne sont pas traduits.
• threadID correspond à l'identification de l'unité d'exécution qui a déclenché l'événement à enregistrer.

Voici un exemple d'enregistrement de journal :

2011.05.16 13:36:14.449 W com.ibm.wps.services.datastore.DataStoreServiceImpl init 0000003a
DSTO0063W: The transaction isolation level is not set to READ_COMMITTED.

The current value is TRANSACTION_REPEATABLE_READ.