Console d'administration

Page Principale Table

Pour tout rapport de bug ou suggestion, envoyez un mèl au Support ExperLog

Qu'est-ce que la Console d'Administration ?

Une console d'administration est maintenant disponible pour administrer les applications ExperShop. Cette console est une application ExperShop, et peut donc être administrée de la même façon. Elle permet aujourd'hui de démarrer et d'arrêter une application, de configurer les connexions vers la base de données, de gérer les traces provenant de l'application, de gérer les connexions des clients qui se connectent à l'application, ainsi que de nombreux outils d'analyse.

Installation

Tout d'abord, vous avez besoin du package ExperShop.
Si vous ne l'avez pas encore, téléchargez-le sur le Site Web ExperLog. La console d'administration est normalement installée avec ExperSHOP, et vous pouvez y accéder à l'URL suivante (remplecaz "localhost" par le nom ou l'IP de la machine où ExperSHOP est installé) : http://localhost:8080/expershop/com.expershop.lite.ESConsoleServlet
Le mot de passe est "admin". Attention, il est fortement conseillé de changer le mot de passe de l'administrateur, avant même d'utiliser la console. En effet, un utilisateur mal intentionné, pourrait modifier le fonctionnement de votre serveur d'application. Ce mot de passe est stocké dans le fichier de configuration de la console d'administration.

Pour activer ou désactiver la console d'administration, agissez comme suit :

  • Editez le fichier de configuration principal d'ExperSHOP (généralement : expershop/EShop.cfg), et modifiez les lignes suivante:
    console: true
    admin: /mon_installation/console/shop/SHOP.cfg

    Si on positionne "console" à false (faux), ExperShop ne démarrera pas la console d'administration.

  • Vous devez redémarrer votre serveur web pour que le fichier de configuration soit pris en compte.

Utilisation

  • Entrez votre mot de passe pour vous connecter à la console d'administration.
  • Choisissez l'application que vous souhaitez administrer en sélectionnant une application entre parenthèses.
  • A droite de l'indicateur d'application courante ("current application:"), un lien est proposé pour activer le Garbage Collector. Cette possibilité peut être utilisable dans les cas ou la machine virtuelle de Java pose quelques soucis ("[activate GC]").
  • Les onglets permettent de naviguer dans la console d'administration. Il est possible à ce niveau de:
     - gérer le pool de connexions vers la base de données (Connection pool)
    - administrer la configuration du "Trace Manager" (Trace configuration)
    - adminstrater le fichier de configuration de l'application (Application configuration)
    - visionner la sortie du "Trace Manager" (Trace output)
    - visionner les clients actuellements ou non connectés à l'application (Statistics)
    - arrêter ou démarrer l'application (on | off)
  • La plupart des écrans sont des tableaux de configuration. Certains paramètres sont modifiables, et les changements sont pris en compte lorsqu'on clique sur le bouton "Submit". Attention, tous les paramètres ne sont pas réactifs de la même façon.

[Connection pool]

Ce panneau permet de gérer le pool de connexions vers la base de données, ainsi que d'autres paramètres de connexion. En haut du panneau, est indiqué le nombre de connexions physiques présentement utilisées.
  • reconnect on error: valeurs possibles: true (vrai) ou false (faux). Si égal à true (vrai), les connexions à la base de données sont réouvertes à chaque erreur les concernant (erreurs SQL incluses).
  • number of jdbc query attempts: nombre d'essai pour établir une connexion vers la base de données en cas d'erreur.
  • new: true (vrai) ouvre et ferme une connexion vers la base de données (hack pour certains driver JDBC) avant de commencer à travailler.
  • minimum of jdbc connections: le nombre minimum de connexions physiques à la base de données.
  • maximum of jdbc connections: le nombre maximum de connexions physiques à la base de données.
  • test statement string: la chaîne SQL de test qui permet de tester la connexion JDBC avant de l'utiliser.
  • check level: niveau de vérification des connexions (0 : aucune vérification ... 4: vérification maximum).
  • debug: positionne le flag de debug. true (vrai), le debug est activé, false (faux), le debug est désactivé.
Cet écran permet aussi de gérer les différents datasources déclarés dans le fichier de configuration de l'application. Les datasources sont listés à l'écran. Le nom du datasource est composé du nom de l'application, suivi de "__" et enfin du nom déclaré du datasource. Après avoir cliqué sur un datasource, un écran apparait avec les informations suivantes:
  • number of used jdbc connections: le nombre de connection jdbc qui sont actuellement utilisées.
  • number of connection handles: le nombre de connection actuellement utilisées (physiques + virtuelles).
  • minimum of jdbc connections: le nombre minimum de connexions physiques à la base de données.
  • maximum of jdbc connections: le nombre maximum de connexions physiques à la base de données.
  • number of connection on one physical connection: le nombre de connexions virtuelles sur la même connexion. Exemple: 
              jdbc.MaxConn: 4
          jdbc.Multiplex: 2
    signifie 8 connexions maximum disponibles pour l'application.

[Trace configuration]

Ce panneau permet de gérer le "Trace Manager". Il existe 5 niveaux de debug, :
  • DEBUG: pour tracer tous les messages de debug provenant d'ExperSHOP;
  • INFO: pour tracer les messages de debug ainsi que les messages apportant une information sur le fonctionnement d'ExperSHOP;
  • WARN: pour tracer les messages de debug, d'information, ainsi que les éventuels warning;
  • ERROR: pour tracer les messages de debug, d'information, de warning ainsi que les messages d'erreurs provenant d'ExperSHOP;
  • FATAL: pour tracer tous les messages provenant d'ExperSHOP. Le mode FATAL est utilisé pour tracer les erreurs de comportements du logiciel qui stoppent complètement l'application.

[Application configuration]

Ce panneau permet d'administrer la configuration générale de l'application.
  • min of connection: le nombre min de connexions à la base de données
  • max of connection: le nombre max de connexions à la base de données
  • with GC: true (vrai) utilise le Garbage Collector de la Virtual Machine, sinon false (faux).
  • timeout(s) for next connections: temps d'inactivité autorisé d'une session client (en secondes).
  • off template: template d'erreur en cas de problème avec l'application. Les problèmes peuvent être de raisons diverses, l'application est arrêtée, le nombre maximum de connexions vers la base de donnée est atteint, etc...

[Trace output]

Ce panneau permet de visionner le fichier d'erreurs et de messages de l'application. Ces logs sont visibles uniquement dans le cas où un fichier de logs a été positionné dans la partie "Trace configuration".

[Statistics]

Tous les clients présentement connectés à l'application sont listés. Lorsqu'on clique sur un client, les informations suivantes sont affichées, certaines sont modifiables.
  • is administrator: true (vrai) le client présentement connecté est l'administrateur de l'application, sinon false (faux).
  • sql encode separator: séparateur sql.
  • sql encode rules: règles de substitutions.
  • reconnect on error: valeurs possibles: true (vrai) ou false (faux). Si égal à true (vrai), les connexions à la base de données sont réouvertes à chaque erreur les concernant (erreurs SQL incluses).
  • number of jdbc query attempts: nombre d'essai pour établir une connexion vers la base de données en cas d'erreur.
  • no comment: true (vrai) affiche les commentaires dans les fichiers html générés, sinon false (faux).
Ce panneau permet aussi de connaître les informations contenues dans le Cookie ("Cookies:") ainsi que les paramètres ("Parameters:") qui sont passés à la servlet ExperSHOP.
Un lien vers le caddie est proposé ("[cart]"), et permet de visionner son contenu.

Le fichier de configuration de la console d'administration est presque similaire à celui d'une application ExperShop normale. Les propriétés suivantes sont définies:

[on | off]

Ces panneaux permettent de démarrer et d'arrêter une application. Par défaut, une application est démarrée.
  • [on]: permet de démarrer l'application.
  • [off]: permet d'arrêter l'application. Dans le cas où il y a des clients connectés à l'application, il est possible de force la déconnexion des clients en cours. Une fois l'application arrêtée, il ne sera plus possible à un client de se connecter au site.

    • Turn off all current connections: déconnecte tous les clients connectés à l'application, et n'autorise plus aucune connexion vers l'application.
    • Disable new connection: n'autorise plus aucune connexion vers l'application. Cela permet de terminer les sessions clients en cours, et de ne plus en autoriser d'autres.

[Save configuration]

Ce bouton permet de sauvegarder la configuration dans un fichier, ce fichier est défini dans le fichier de configuration de l'application. Si le fichier n'est pas défini, un fichier par défaut sera créé (/tmp/tmp-delegatefile.cfg).