Installation et paramétrage du package esup-indicateurs


Contenu du package

Le package esup-indicateurs est fourni sous la forme d'une archive "tar.gz".

Le fichier README.txt à la racine donne des indications pour l'installation et le paramétrage.

Il se décompose en plusieurs sous dossiers :

A la racine, un fichier de stats d'exemple est fourni pour tests : stats.sample.log

Installation du package

Prérequis

Pour la génération des documents html, les modules perl "XML::LibXML" et "SVG::TT::Graph" doivent etre installes.

Pour cela en tant que root, faire :

perl -MCPAN -e 'CPAN::Shell->install(XML::LibXML)'
perl -MCPAN -e 'CPAN::Shell->install(SVG::TT::Graph)'

La librairie libxslt doit également être installée, avec  le binaire xsltproc utilisé pour les transformations xslt.

Pour les accès SGBD le module perl DBD::mysql ou DBD::Pg doit être installé, en fonction du moteur sql utilisé.

Installation

Par exemple, pour la version 1.0.0 du package :

tar -xvzf esup-indicateurs-1.0.0.tar.gz

Ceci crée le répertoire racine de l'installation, esup-indicateurs-1.0.0

Dans le sous-dossier scripts, faire

chmod 755 *sh
chmod 755 *pl

Paramétrage du package

Il s'effectue en affectant des variables d'environnement dans les 2 scripts env.sh et traiteStatsEsup.sh

env.sh

 Il contient des paramètres généraux.

Il est nécessaire de paramétrer au moins les variables suivantes :

D'autres paramètres permettent de spécifier les répertoires contenant les fichiers de configuration, les fichiers générés ...

traiteStatsEsup.sh

Les paramètres les plus importants sont les suivants :

Prise en main

 Le package est livré avec un petit jeu d'essai, stats.sample.log, et des fichiers de configuration pré-paramétrés avec ce jeu d'essai.

 Pour dérouler le jeu d'essai, le paramétrage minimum à effectuer est :

Editer le fichier stats.sample.log, afin de modifier le mois. Par exemple, si on est en octobre 2008, remplacer les occurences de "2008-08-" par "2008-10-".

 Si on désire alimenter une base de données, il est nécessaire de l'initialiser.

Un script d'exemple est fourni : DBinit.sample.sh. il suffit de l'adapter, et de l'exécuter.

vous pouvez enfin exécuter le script principal :  traiteStatsEsup.sh

Il va créer par défaut dans le répertoire racine du package les répertoires suivants :

Conseils d'installation en production

 Afin de faciliter des mises à jour ultérieures, il est recommandé d'utiliser des répertoires externes à l'arborescence du package pour les fichiers de configuration et les fichiers résultants.

Voici un exemple d'installation qui facilite les mises à jour ultérieures :

On suppose que le répertoire /home/uportal/stats est utilisé pour traiter les statistiques esup-portail.

Le package esup-indicateurs sera déployé dans ce répertoire ; pour la version 1.0.0 il sera donc installé dans  /home/uportal/stats/esup-indicateurs-1.0.0.

On fera un lien symbolique de /home/uportal/stats/esup-indicateurs vers /home/uportal/stats/esup-indicateurs-1.0.0 afin de rendre indépendant les cron de la version actuelle du package.

La variable  DIR_HOME_INDICATEURS sera donc valuée à /home/uportal/stats/esup-indicateurs

On déposera les fichiers de configuration dans  /home/uportal/stats/conf ; les fichiers intermédiaires seront générés dans /home/uportal/stats/logs, les fichiers xml générés dans /home/uportal/stats/xml et les fichiers html dans l'arborescence du serveur web (par exemple, /var/www/html/stats/$ANNEE).

Pour cela, mettre à jour les variables adéquates dans le fichier env.sh

 Les mises à jour ultérieures devraient être facilitées :