...
- scripts : contient les scripts shell et perl, et les feuilles xsl utilisés utilisées lors de la génération de docuents documents html
- conf : contient les fichiers de configuration : types.map, services.map, db.conf
- lib : contient les librairies extérieurs nécessaires. Pour le moment, juste la librairie java batik, utilisée pour la génération des graphiques
- db : contient les scripts SQL de création de la base des indicateurs, pour mysql et postgree
...
Il s'effectue en affectant des vraiables variables d'environnement dans les 2 scripts env.sh et traiteStatsEsup.sh
...
- Mettre à jour la variable DIR_HOME_INDICATEURS du fichier env.sh
- Mettre à jour les 3 variables indiquées ci-dessus dans le fichier traiteStatsEsup.sh
- Mettre à jour le fichier db.conf si on désire mettre à jour enrichir la base de données
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-".
...
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 :
- xml : contient les résultats xml
- html : contient les fichiers html générés, et les images associées
- logs : contient des fichiers intermédiaires
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 :
- désarchivage du package
- modification du lien symbolique
- recopie de l'ancien fichier env.sh (en controlant qu'il n'y a pas de nouvelles variables)
- ajustement des quelques variables modifiées dans le script traiteStatsEsup.sh