Console d'administration


Page Principale Table

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


Prérequis

  • La dernière version d'ExperShop doit être installée, et doit être fonctionnelle (V2.0 beta 2). Référez vous à l'installation d'ExperShop.

Qu'est-ce ?

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 Lite.
Si vous ne l'avez pas encore, téléchargez-le sur le Site Web ExperLog. Ensuite, vous avez besoin du package " console d'administration" disponible dans la partie download du site. Et enfin:
  • Décompressez le fichier administration-console-0.9.0.tar.gz, et installez les fichiers dans un endroit visible du serveur web : tar tzxf administration-console-0.9.0.tar.gz
  • Modifiez le fichier de configuration de la console. Ce fichier se trouve dans le répertoire /mon_installation/console/shop/SHOP.cfg. Les paramètres à modifier sont :
    • jdbc.Driver: classe_du_driver
    • jdbc.Url: url_de_la_connexion
    • jdbc.User: utilisateur_de_la_base
    • jdbc.Password: mot_de_passe_de_l_utilisateur
    • shop.RootDir: /mon_installation/console/shop/ESRootDir
  • Editez le fichier suivant : ExperShop/EShop.cfg, et rajoutez la ligne suivante:
    console: true
    admin: /mon_installation/console/shop/SHOP.cfg

    Cette option permet d'utiliser la console d'administration. Si on positionne cette option à false, ExperShop n'utilisera pas la console d'administration.

  • Les administrateurs des applications sont stockés en base de données, ces informations seront stockées dans la base décrite ci-dessus. Vous devez créer la table et une principale entrée dans cette base. Vous trouverez ces informations dans le fichier /mon_installation/console/schema.sql.
  • Vous devez redémarrer votre serveur web pour que le fichier de configuration soit pris en compte.
  • Dans votre navigateur Web, accédez :
    http://votre-machine:8080/servlet/com.expershop.lite.ESConsoleServlet

    Le login est "admin" et le password "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.

Utilisation

  • Entrez votre login et password pour vous connectez à la console d'administration.
  • Choisissez l'application que vous souhaitez administrer. Vous pouvez sur cette page "éteindre" la console d'adminstration. Il y a deux raisons principales à vouloir éteindre la console, la première peut être pour des raisons de sécurité. En effet, ouvrir une porte (d'administration), ouvre très probablement des failles, et une personne mal intentionnée pourrait nuire à vos applications. La seconde raison peut être pour des raisons de performances, même si il n'a pas été noté de perte de performances avec l'utilisation de la console d'administration.
  • Le menu de gauche permet 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)
    - arrêter ou démarrer l'application (on | off)
    - et enfin, de visionner les clients actuellement connectés à l'application
  • 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 "Update". 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.
  • 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.
  • 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é.

[Trace configuration]

Ce panneau permet de gérer le "Trace Manager".
  • prefix: prefix (entête) des lignes de logs.
  • out file: fichier de sortie des erreurs et autres logs.
  • debug servlet: true (vrai) affiche les traces concernant les servlets, sinon false (faux).
  • debug client: true (vrai) affiche les traces concernant les clients, sinon false (faux).
  • debug store: true (vrai) affiche les traces concernant l'application (shop), sinon false (faux).
  • debug product: true (vrai) affiche les traces concernant les produits, sinon false (faux).
  • debug order: true (vrai) affiche les traces concernant les commandes, sinon false (faux).
  • debug department: true (vrai) affiche les traces concernant les rayons, sinon false (faux).
  • debug customer: true (vrai) affiche les traces concernant les clients, sinon false (faux).
  • debug cart: true (vrai) affiche les traces concernant le caddie, sinon false (faux).
  • debug pay: true (vrai) affiche les traces concernant le module de paiement, sinon false (faux).
  • debug dyn: true (vrai) affiche les traces concernant le DynHtml, sinon false (faux).
  • debug db: true (vrai) affiche les traces concernant la base de données, sinon false (faux).
  • debug pool: true (vrai) affiche les traces concernant le pool de connexions, sinon false (faux).
  • debug timer: true (vrai) affiche les traces concernant le thread Timer des sessions client, sinon false (faux).
  • debug console: true (vrai) affiche les traces concernant la console d'administration, sinon false (faux).
  • verbose: true (vrai) affiche les traces "verbeuses...", sinon false (faux)
  • header: true (vrai) affiche les entêtes des traces (prefix + date + numéro de thread), sinon false (faux)

[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...
Dans le cas où vous administrez la console d'administration, plusieurs paramètres sont affichés.
  • console/color 1: première couleur pour les tableaux.
  • console/color 2: seconde couleur pour les tableaux.
  • console/application color: couleur de texte.
  • console/properties color: couleur des propriétés.
  • console/background color: couleur de fond.

[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".

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

[Clients for this application]

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 ("Current cookie") ainsi que les paramètres (Current parameters) qui sont passés à la servlet ExperSHOP.
Un lien vers le caddie est proposé ("Link to 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:

Paramètres console
Propriété Description Valeur par défaut
console.mbeanserver nom du serveur MBean utilisé par ExperShop pour la console d'administration. expershop
console.color1 première couleur pour les tableaux. "#ffffe0"
console.color2 seconde couleur pour les tableaux. "#ffcc99"
console.applicationcolor couleur de texte. "#ff1111"
console.propertiescolor couleur des propriétés. "#008000"
console.bgcolor couleur de fond. "#ffffff"