Modification de Torrus mrtg

Note : Torrus s'appelait auparavant RRFW.

==Installation==

Faire un backup de l'existant avant toute installation de nouvelle version :

<pre>
tar -cvf torrus-backup.tar /usr/local/rrfw-x.y
tar -cvf torrus-data-backup.tar /data/collector1
</pre>

Récupérér le tarball dan /usr/local/src, puis :

<pre>
./configure
make install
</pre>

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.

==Références==

[https://torrus.org Site Web de Torrus]

[[Catégorie:Network-Clara]]