Announcement!
This is a notification for product news or an alert. If you have a question, please start a new discussion

Diagnostiquer la gamme Sage XRT Solutions

Outils d’analyse

Cet article a pour but de vous présenter les différentes manières de générer les traces associées aux logiciels de la gamme Sage XRT Solutions.

En fonction de la difficulté de vos demandes et pour mieux affiner son diagnostic, le support Sage peut être en mesure de vous demander ces fichiers de logs.

La console Sage XRT Common Services :

Dès le démarrage de Sage XRT Common Services, les fichiers traces du DbInstaller et de la console d’administration ou XRTLogin sont systématiquement générés et activés.

Pour les autres composants tels que UMAPI, le service XDLO, XDLO, XDLO Client, XRTLIB ou encore FMTAPI et XRTProt, les fichiers traces peuvent être activés :

  • Soit à partir de l’interface de la console d’administration, menu connexion et action Paramétrage de chaque composant. Pour l’exemple, voici le paramétrage de la Log de UMAPI.

Cochez Activer Log et cliquez sur bouton OK.

 Avant toute modification de la base de registre, nous préconiserons d’en faire une sauvegarde complète, puis de faire une sauvegarde des clés à modifier.

  • Soit créer manuellement dans la registry une clé et une chaîne Debug pour chaque composant dans HKEY_LOCAL_MACHINE\SOFTWARE\XRT\Common et voici la liste des clés :

UMAPI -------   chaîne Debug = Y

XDLO ---------  chaîne Debug = Y (pour service XDLO et XDLO)

                        chaîne DebugRC = Y (pour XDLO CLIENT)

XRTLIB -------  chaîne Debug = Y

APIFMT ------   chaîne Debug = Y

XRTPROT ----  chaîne Debug = Y

Attention, si le système d’exploitation est en 64 bits, l’arborescence dans le registre va différer comme suit :

HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\XRT\Common

Ces fichiers trace sont stockés par défaut sous C:\Documents and settings\<USER_NT>\Application Data\XRT\XCS pour un environnement Windows XP ou 2003 Server.

En revanche, pour les systèmes d’exploitation tel que Windows 7 ou 2008 Server, les fichiers seront accessibles par défaut sous C:\Users\<USER_NT>\AppData\Roaming\XRT\XCS A noter que la référence <USER_NT> fait appel au compte NT ayant réalisé l’installation du logiciel Sage FRP Common Services.

Voici la liste des noms de fichiers trace correspondant à chaque composant

DbInst.log ------         composant Db Inslaller

Xcsmcnet.log ------   composant Console d’administration

UmapiLib.log ------    composant UMAPI

Xdlo_remclient.log ---- composant XDLO CLIENT

XrtLib.log ------           composant XRTLIB (utile pour diagnostiquer les connexions DSN entre applications Sage, exemple entre SBE et XCS)

ApiFmt.log ------        module FORMATS

XrtProt ------               composant Licence

Pour les composants XDLO service et XDLO, les fichiers trace Xdlo_service.log et Xdlo.log peuvent être stockés sous le profil NT démarrant le service XDLO. En effet, certaines plateformes cliente utilisent des comptes NT dit « compte de services » pour démarrer les services XRT.

Les tableaux de ces traces permettent de dérouler pas à pas les actions exécutées par chaque composant. Ils comprennent tous les éléments suivants :

  • Timestamp indique la date et l’heure.
  • Niveau indique le type du message. Il comprend le plus souvent « ALL », « INFO », « DEBUG » et « ERROR ».
  • Message désigne les actions développées et exécutées par les composants ici UMAPI.

Il est possible de trier et filtrer les lignes par élément de colonne. Par exemple, pour afficher la trace UMAPI ayant le niveau DEBUG, cliquez sur l’icône en haut à droite de la colonne « NIVEAU » pour obtenir la liste de tous les niveaux.

Sélectionnez le niveau « DEBUG » et on obtient toutes les lignes de niveau « DEBUG »

Les fichiers trace sont donc générés par machine et par date.

Intéressons-nous maintenant aux fichiers trace générés lors de la création d’une base de données. Ils se trouvent au même endroit que les autres fichiers trace sous C:\Documents and settings\<NT_USER>\Application Data\XRT\XCS. On les reconnaît par leur extension « .sql ». L’ordre d’exécution des scripts étant importants, ils sont donc triés par leur ordre d’exécution. Ainsi, par exemple, pour la création d’une base XCS en Oracle, les fichiers scripts générés sont les suivants :

  • 20120131-162525-checkinstanceisasm.sql.log
  • 20120131-162529-getlogicalunitdefaultlocation.sql.log
  • 20120131-162530-checkconnection.sql.log
  • 20120131-162530-checkrdbmscompatibility.sql.log
  • 20120131-162530-listavailabledatabases.sql.log
  • 20120131-162531-checkinstanceisasm.sql.log
  • 20120131-162531-listavailabledatabases.sql.log
  • 20120131-162539-createlogicalunits.sql.log
  • 20120131-162540-createdbo.sql.log
  • 20120131-162540-createuser.sql.log
  • 20120131-162542-updatedbo.sql.log
  • 20120131-162543-createxl_configuration.sql.log
  • 20120131-162543-updateuser.sql.log
  • 20120131-162545-registerlogicalunits.sql.log
  • 20120131-162546-xrt_3.1.8.8_newmodel.sql.log

Ouvrez chaque script pour connaître les détails d’exécution.

Et c’est le même processus pour la création ou mise-à-jour des produits de la gamme Sage XRT Treasury.

Sage XRT Communication & XRT Signature :

Les deux interfaces graphiques des logiciels de Communication et de Signature n’offre pas la possibilité d’activer les différentes traces que propose les produits.

 Avant toute modification de la base de registre, nous préconiserons d’en faire une sauvegarde complète, puis de faire une sauvegarde des clés à modifier.

Pour cela, vous devez passer obligatoirement par la registry de votre système d’exploitation et créer une clé et une chaine Debug pour les composants LAD et XMAIL via l’arborescence HKEY_LOCAL_MACHINE\SOFTWARE\XRT\Common.

Il se peut que la clé XMAIL ne soit pas présente, n’hésitez pas à la créer par vous-même.

Pour rappel, attention aux environnements 64 bits.

LAD -----    chaîne Debug = Y

XMAIL ----chaîne Debug = Y

Voici la liste des noms de fichiers trace correspondant à chaque composant :

Xladserver.log ------Service XRT LAD

Xcmonitor.log ------Service XRT Communication

Xsmonitor.log ------Service XRT Signature

Xmail.log ------         composant des notifications

Ces fichiers de traces sont générés par défaut dans le dossier temporaire de votre système (C:\Windows\TEMP) ou dans le dossier temporaire du compte NT démarrant les services XRT LAD, XRT Communication et, XRT Signature.

Sage XRT Treasury :

Sage XRT Treasury dispose par son interface graphique d’activer un fichier de trace sous condition que l’utilisateur dispose des droits pour activer cette fonction.

Une fois connecté au logiciel Sage XRT Treasury, dirigez dans le menu Eléments Communs, dans l’encadré Administration Générale cliquez sur Gestion de la plateforme.

Reprenez le troisième onglet et cochez la case Ecrire dans log.

Validez simplement par le bouton ok.

Le fichier trace contenant l’activité du logiciel sera par défaut disponible via le chemin C:\Documents and Settings\<USER_NT>\Application Data\Sage\FRP_TREASURY pour les environnements Windows XP ou 2003 Server. Autrement, pour les systèmes d’exploitation Windows 7 ou 2008 Server, le chemin sera C:\Users\<USER_NT>\AppData\Roaming\Sage\FRP_TREASURY

Un fichier de trace sera généré lors de toute connexion à l’application et sera intitulé comme suit U2<date><heure>.log.xml.

De cette manière, vous pourrez identifier aisément la session à tracer.

 Avant toute modification de la base de registre, nous préconiserons d’en faire une sauvegarde complète, puis de faire une sauvegarde des clés à modifier.

Cependant, si le compte utilisateur ne possède pas les droits pour pouvoir activer cette trace, vous avez la possibilité de le faire manuellement par la registry selon le chemin HKEY_CURRENT_USER\Software\Sage\FRP_TREASURY\Setting\Specials et par la chaine WriteToLog. Modifiez la valeur à -1 pour que le fichier de trace puisse être généré.

Pour désactiver la trace, définissez la valeur de la chaine à 0.