/****************************************************************************//** * * @mainpage Documentation local accounting * @section intro Introduction * Texte d'introduction * * @section installation Installation * @subsection step_1 Premiére étape * Descriptif de l'installation de la base de données * La base de données est créée par le script pbsmaui2mysql.pl * @subsection step_2 Deuxiéme étape * Descriptif de la mise en place des pages Web * L'installation de la partie web se fait par décompression des fichiers dans le répertoire dédié au site Web. * Les bibliothéques jpgraph, les fontes et la gestion des calendrier ont été intégrées dans le fichier compresser * pour simplifier l'installation. * * L'objectif a été de séparer la partie gestion des graphes et gestion mysql, afin d'avoir la possibilité d'utiliser le méme type de graphique * mais avec des données différentes selon le laboratoire. * * Détail des fichiers contenus dans inc/ : * - accdates.inc.php : gestion des dates * - accexception.inc.php : gestion des exceptions (affichage des messages d'erreurs) * - accgraph.inc.php : classe de gestion de création des graphes * - accgraphparam.inc.php : gére les paramétres des graphes * - accparam.inc.php : chargement des paramétres d'environnement (fichier input/accounting.in) * - accsql.inc.php : classe de gestion mysql commune * - accsqliphc.inc.php : classe de gestion mysql spécifique à l'IPHC * - accsqllapp.inc.php : classe de gestion mysql spécifique au LAPP * @subsection step_3 Troisiéme étape * Selector spécifique à l'IPHC * * * Lors de l'utilisation de l'outil accounting en mode IPHC, 2 tables mysql (selector et calendar) et plusieurs vues vont étre créé automatiquement. * * Pour obtenir un apect graphique correct il faudra saisir une couleur spécifique pour chaque champs de la table selector. * Les 2 insert devront étre programmés par un trigger pour mettre à jour la table selector. * * @subsection step_4 Quatriéme étape * Fichier de paramétrage * * Le paramétrage de la solution se fait en modifiant le fichier ./input/accounting.in * * Exemple du fichier accounting.in * ---------------------------------------------- * # Nom du serveur Mysql * 127.0.0.1:3306 * # Nom de la base de donnees * sbgaccounting * # Login pour acces a la base de donnees * root * # Mot de passe pour acces a la base de donnees * root * # Repertoire d'installation de jpgraph * /Users/ekieffer/Documents/Workspace/www/html/acctest/inc/jpgraph/src * # Repertoire Apache * /Users/ekieffer/Documents/Workspace/www * # Repertoire page web de l'accounting * /localacc * # Login pour acces à la page web de l'accounting * toto * # Mot de passe pour acces a la page web de l'accounting * toto * # Repertoire de stockage des graphes * /html/acc2/graph * # Spécifique au laboratoire (IPHC/LAPP) * IPHC * ---------------------------------------------- * @section utilisation Utilisation * @subsection step_1 Utilisation interactive * Descriptif de l'utilisation interactive * Test : * * Dans la version de test, une option "Test Jpgraph" se trouve dans la liste des "types de graphe". * Elle permet de tester la création d'un graphe pour vérifier le bon fonctionnement de jpgraph et des accés fichiers. * Ce test ne prend pas en compte les accés mysql. * * Graphes : * L'ensemble des graphes sont fonctionnels : * - Usage des ressources en pourcentage (% walltime) * - Usage des ressources sans le temps disponible en pourcentage (% walltime) * - Usage des ressources en valeurs absolues (cputime) * - Usage des ressources en valeurs absolues (walltime) * - Usage des ressources sans le temps disponible en valeurs absolues (walltime) * - Occupation des ressources par jour et par groupe * - Nombre de jobs en pourcentage (%) * - Nombre de jobs en valeurs absolues * - Nombre de jobs en valeurs absolues par jour * - Nombre de jobs terminés par jour et durées d'occupation * - Durée moyenne des jobs terminés par groupe * - Mémoire moyenne et maximale utilisée par les jobs terminés * - Distribution de mémoire réelle utilisée par les jobs terminés * - Distribution de mémoire virtuelle utilisée par les jobs terminés * - Efficacité des jobs terminés * Pour chacun de ces graphes il est possible de sélectionner la période et le choix des groupes * Pour les graphes permettant d'afficher les données par jour il est possible de grouper le résultat par jour, par semaine et par mois * * Les options "Type de jobs" et "Surcharge" ne sont pas utilisées à l'IPHC. * * @subsection step_2 Utilisation programmée * Descriptif de l'utilisation programmée * Le script creationimagesaccounting.php permet de générés des graphes en ligne de commande et a page ./fixe/index.php permet * d'afficher ces graphes sur un page statique. * Commande d'éxécution : php creationimagesaccounting.php * * @date 2011-05-26 // Dernière modification * @version 0.8.1 *********************************************************************************/