Consignation au journal

Consignation au journal de l'application Web de Geoportal Server

Lorsque des erreurs ou d'autres problèmes se produisent dans l'interface d'Esri Geoportal Server, les fichiers journaux sont le meilleur endroit où rechercher les informations. La consignation au journal de l'application Web de Geoportal Server décrite ici est dans le contexte des implémentations à l'aide d'Apache Tomcat pour la consignation au journal du géoportail ou d'Oracle WebLogic pour la consignation au journal de Geoportal Server comme serveur de l'application Web. Pour les autres logiciels du serveur de l'application Web pris en charge, vous pouvez utiliser les concepts décrits dans ces sections et les appliquer au cadre de consignation au journal java.util.

Consignation au journal de Geoportal Server pour Apache Tomcat

Les fichiers journaux de Tomcat se trouvent par défaut dans le répertoire <Tomcat Installation Directory>\logs. En plus des fichiers standard qui sont créés par Tomcat, le répertoire logs contient également un fichier journal de ArcGIS Server Geoportal Server, nommé gpt.xxxxxx.log où xxxxxx est la date au format aaaa-mm-jj. Ce fichier journal est le premier endroit où rechercher les erreurs. Vous trouverez également d'autres informations sur le mécanisme de consignation sur le site Apache Tomcat 5.5 Servlet/JPS Container.

ArcGIS Server Geoportal Server permet de définir le niveau de consignation au journal pour obtenir plus ou moins de détails dans les fichiers journaux de Geoportal Server. Le niveau de détails écrit dans le fichier gpt.xxxxx.log est défini dans le fichier <Tomcat Installation Directory>\webapps\geoportal\WEB-INF\classes\logging.properties. La variable com.esri.gpt.level détermine le niveau de consignation au journal et est définie à FIN par défaut. Les valeurs de niveau de consignation au journal acceptées sont :

• GRAVE
• AVERTISSEMENT
• INFO
• CONFIG
• FIN
• PLUS FIN
• LE PLUS FIN
• TOUT

Après avoir modifié le niveau de consignation au journal, redémarrez l'application Web de Geoportal Server dans le Gestionnaire Tomcat ou redémarrez Tomcat complètement afin que vos modifications soient prises en compte.

Attention :

Le fait de définir le niveau de journal à FIN, PLUS FIN, LE PLUS FIN ou TOUT est un dépannage approprié, mais le niveau de journal doit être redéfini à son niveau d'origine lorsque le dépannage est terminé. Le fait de laisser la consignation au journal définie à ces niveaux entraîne le développement rapide du fichier journal, qui occupe tout l'espace du disque.

Consignation au journal de Geoportal Server pour Oracle WebLogic

Weblogic ne récupère pas le fichier logging.properties de Geoportal Server par défaut dans le répertoire de classes de Geoportal Server. Afin d'affecter les propriétés de consignation au journal, vous devez modifier le fichier logging.properties principal pour l'exécutable java exécutant WebLogic. Les étapes suivantes présentent la manière d'activer la génération d'un fichier journal pour l'application Web de Geoportal Server et son écriture dans un répertoire en sortie de votre choix. Pour plus d'informations, voir la documentation en ligne Oracle pour la consignation au journal WebLogic.

1. Localisez l'exécutable java exécutant weblogic, et dans ce dossier, ouvrez son fichier logging.properties dans un éditeur de texte.

   Le fichier logging.properties de l'exécutable java WebLogic se trouve dans le dossier \\bea\jrockit\jre\lib ou \\Oracle\Middleware\jdk\jre\lib.

2. Dans le fichier logging.properties, recherchez le paramètre java.util.logging.ConsoleHandler.level et définissez le paramètre INFO par défaut sur FINER.
3. Dans ce même fichier, faites défiler jusqu'à la fin du fichier où # les propriétés spécifiques à la ressource sont définies.
4. Sous la ligne d'exemple pour la ressource com.xyz.foo.level = SEVERE, saisissez ce qui suit : com.esri.gpt.level = FINER
5. Enregistrez le fichier logging.properties.

Les scripts du serveur weblogic consignent au journal tous les messages sur la console du serveur par défaut. Afin de les rediriger vers un fichier journal, vous devez modifier le script de démarrage du serveur WebLogic.

6. Accédez au fichier startWebLogic.cmd et ouvrez-le dans un éditeur de texte.

   Le fichier startWebLogic se trouve souvent dans le dossier \\wlserver_10\samples\domains\wl_server\bin ou un chemin de fichier similaire.

7. Dans le fichier startWebLogic.cmd, recherchez la ligne qui indique : set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%
8. Ajoutez deux paramètres supplémentaires à cette variable JAVA_OPTIONS.

   Les deux paramètres définiront le nom de deux fichiers journaux de Geoportal Server et l'emplacement où ils doivent être écrits. Dans cet exemple, ces deux fichiers journaux sont écrits sur le disque C:\. Les deux paramètres sont -Dweblogic.Stdout="C:\geoportal-stdout" et -Dweblogic.Stderr="C:\geoportal-stderr". La variable JAVA_OPTIONS doit désormais ressembler à l'exemple ci-dessous.set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS% -Dweblogic.Stdout="C:\geoportal-stdout" -Dweblogic.Stderr="C:\geoportal-stderr"

9. Enregistrez le fichier startWebLogic.cmd.
10. Redémarrez le service WebLogic.

    Après le démarrage du service, les fichiers journaux de Geoportal Server doivent être écrits sur le disque C:\.

Activation de la consignation au journal pour les clients de Geoportal Server

La consignation au journal pour les clients CSW, le client de publication et le client WMC est désactivée par défaut. Pour l'activer, spécifier le chemin en sortie du fichier journal et définir la taille maximale du fichier journal, vous devez configurer les fichiers de propriétés des clients. Ces fichiers de propriétés se trouvent dans le répertoire d'installation ArcGIS Desktop, dans le dossier \\ArcGIS\Desktop<version>\bin et sont installés lorsque le client lui-même est installé. Le fichier de propriétés correspondant pour chaque client est affiché ci-dessous.

Attention :

Si vous accédez au répertoire \\ProgramFiles\ESRI\Geoportal\, vous verrez des sous-dossiers des clients qui contiennent également des fichiers de propriétés. Ces derniers sont les modèles utilisés lors de l'installation du client et ne sont pas référencés pour toute modification de consignation au journal apportée. Veillez à apporter toute modification de consignation au journal aux fichiers de propriétés dans le dossier \\ArcGIS\Desktop<version>\bin à la place.

Nom du client Geoportal Server	Fichier de propriétés dans \\ArcGIS\Desktop10.0\bin
Clients CSW	CswClient.properties
Client de publication	PublishClient.properties
Client WMC	WMCOpener.properties

Chaque fichier de propriétés possède les trois paramètres suivants, qui peuvent être définis selon la description. Après avoir modifié le fichier de propriétés, vous devez relancer ArcGIS Desktop pour que vos modifications soient prises en compte.

Paramètre	Description	Valeurs acceptées
logFolder	Emplacement où les fichiers journaux doivent être écrits	chemin de fichier accessible sur le réseau
maxLogFileSizeInBytes	taille maximale autorisée pour le fichier journal	entier
débogage	active ou désactive la consignation au journal Remarque : Contrairement à la consignation au journal de l'application Web de Geoportal Server, il existe seulement deux niveaux de consignation au journal pour les clients : activé ou désactivé	activé / désactivé la valeur par défaut est désactivé

Le fichier CswClient.log pour les clients CSW

Après avoir activé la consignation au journal pour les clients CSW, vous pouvez rechercher le fichier journal pour voir les requêtes envoyées des clients CSW aux extrémités du catalogue CSW. Pour plus d'informations sur les requêtes et les réponses gérées par le client CSW, reportez-vous à la rubrique Comment les clients CSW fonctionnent. La recherche de la communication dans le fichier CswClient.log peut souvent révéler s'il y a un problème avec l'extrémité, le profil utilisé pour communiquer ou un autre problème de communication.

Le fichier publishMetadata.log pour le client de publication

Après avoir activé la consignation au journal pour le client de publication, vous pouvez rechercher le fichier journal publishMetadata.log pour obtenir des informations sur vos sessions de publication et les résultats des sessions de publication plus en détails.

Voici un fichier journal d'exemple. Vous pouvez voir les autres messages à côté de ce qui est indiqué dans l'exemple, selon la ressource qui est publiée et si la session a été réussie.

************ Metadata Publishing started at   7/28/2010 11:20:38 AM ************
Publication Parameters
============================================================
Metadata Server Url           : http://myserver:8080/geoportal
Publish Metadata Service Name : GPT_Publish_Metadata
Selected Workspace Name       : \\networkServer\C$\Data\districts.shp.xml
Selected container category   : XML Document
============================================================
EndPoint Type : DEFAULT
Publish url : http://myserver:8080/geoportal/rest/manage/document
Publish request : <metadata xml here>
Publish response : 
Publication successful for \\networkServer\C$\Data\districts.shp.xml
************ Metadata Publishing completed at 7/28/2010 11:20:46 AM ************

Ce fichier journal montre l'heure de début et de fin de la session de publication, les paramètres en entrée de la session et la réponse si la session de publication a été réussie ou non. La requête de publication Publish request inclut les métadonnées dans les documents que le client de publication trouve et publie. Le type d'extrémité EndPoint Type indique si l'extrémité de Geoportal Server par défaut, qui est l'extrémité REST, est utilisée ou si l'extrémité CSW ou l'extrémité du servlet est utilisée. L'url de publication Publish url est l'url vers cette extrémité. Dans cet exemple, vous pouvez voir que l'url de l'extrémité REST est indiquée.

Le fichier WMCOpener.log pour le client WMC

Après avoir activé la consignation au journal pour le client WMC, vous pouvez rechercher le fichier journal WMCOpener.log pour obtenir des informations sur les services référencés lorsque vous avez utilisé le client WMC. Le fichier WMCOpener.log donnera les informations de service lues à partir du fichier WMC et signalera si la couche a en réalité été ajoutée à la carte. En cas de problème avec le service et s'il n'est pas ajouté à la carte, les informations de service seront indiquées dans le journal, mais elles ne diront pas s'il a été ajouté.