Torrus mrtg
Note : Torrus s'appelait auparavant RRFW.
Installation
Faire un backup de l'existant avant toute installation de nouvelle version :
tar -cvf torrus-backup.tar /usr/local/rrfw-x.y tar -cvf torrus-data-backup.tar /data/collector1
Récupérér le tarball dan /usr/local/src, puis :
./configure make install
Changer les droits du répertoire racine de Torrus et du répertoire où sont stockées les archives RRD :
chown torrus:torrus /usr/local/torrus-x.y chown torrus:torrus /data/collector1
Créer un lien de /usr/local/torrus vers /usr/local/torrus-x.y.
Le user sous lequel tourne Apache doit être dans le groupe torrus.
Génération des configurations
Configuration manuelle
Pour les configurations qui ne sont pas générées par genddx et devdiscover, il faut éditer un fichier XML (voir network.xml dans /usr/local/torrus/share/torrus/xml par exemple) et ajouter ce fichier dans la configuration (/usr/local/etc/torrus/conf/torrus-siteconfig.pl).
Génération automatique
La plus grande partie de la configuration Torrus est générée automatiquement. Les machines sont regroupées logiquement (routeurs de backbone, switchs Claranet etc) dans des cibles. Pour chaque cible, il existe un fichier texte qui liste les machines appartenant à cette cible. Quand on ajoute un routeur/switch, il faut l'ajouter dans un des fichiers /usr/local/etc/torrus/templates/hosts/* correspondant à la cible.
Pour connaître les différentes cibles et les fichiers correspondants :
/usr/local/libexec/do-torrus -l
Pour générer les configurations d'une cible (attention, c'est lent) :
/usr/local/libexec/do-torrus nom-de-la-cible
Pour générer la configuration de toutes les cibles (attention, c'est lent) :
/usr/local/libexec/do-torrus
Vérifier que toute la hiérarchie (switchs, routeurs etc) fonctionne correctement après modification.
Pour voir ce que fait la commande do-torrus, utiliser l'option "-s", qui va afficher les commandes sans les exécuter.
Troubleshooting
Torrus loggue dans /var/log/torrus.
On peut mettre torrus en mode debug dans /usr/local/etc/torrus/conf/initscript.siteconf.
Si il y a un problème de corruption des bases (Berkeley DB), la méthode forte consiste à les détruire les (elles seront recréée à partir des configurations XML) :
- /etc/init.d/torrus stop
- vérifier que les process torrus ne tournent plus : ps ax | egrep 'collector|monitor'
- rm -rf /var/torrus/db/*
- /usr/local/libexec/do-torrus -c && /etc/init.d/torrus start && /etc/init.d/apache2 restart
On peut aussi détruire seulement la base qui pose problème et relancer do-torrus pour la cible correspondante sans stopper torrus (méthode moins violente).
Il doit y avoir moyen (à découvrir :) de réparer les bases avec un outil BDB.
