Console d'administration
Page
Principale Table
Pour tout
rapport de bug ou suggestion, envoyez un mèl au
Support ExperLog
- 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.
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.
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.
-
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.
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é.
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)
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.
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".
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.
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:
|