Freeside:2.3:Documentation:Torrus Installation

Introduction

Torrus is a network monitoring system (NMS) for discovering and monitoring routers, switches and other network equipment with SNMP. Starting in version 2.3, Freeside integrates Torrus (like the RT ticketing system), providing an integrated system for doing 95th percentile and straight volume billing.

Prerequisites

 aptitude install rrdtool librrds-perl libxml-libxml-perl libberkeleydb-perl libtemplate-perl libproc-daemon-perl \
   libnet-snmp-perl libapache-session-perl libjson-perl libdbix-abstract-perl libdbix-sequence-perl

Installation

In the Makefile, set TORRUS_ENABLED = 1

 make configure-torrus
 make deploy

Network discovery

 cd /usr/local/etc/torrus/discovery
 vi routers.txt #space-delimted router ip addresses
 torrus genddx \
   --hostfile=routers.txt \
   --domain=example.com \
   --community=community_string \
   --out=routers.ddx \
   --discout=routers.xml
 torrus devdiscover  --in=routers.ddx 

 mkdir /srv/torrus/collector_rrd
 chown freeside:freeside /srv/torrus/collector_rrd

 torrus compile --tree=main --verbose

 torrus bs --global --verbose

XXX database config (before collector start)

 #launch data collector
 #XXX add to init
 torrus collector --tree=main

Cron and init script

http://torrus.org/install.pod.html#cron_job 

but do go from http://torrus.org/install.pod.html#cron_job on

Reporing setup

 cd /usr/local/etc/torrus/discovery
 vi routers.ddx
   <param name="RFC2863_IF_MIB::external-serviceid">
     TESTING_1:TenGigabitEthernet2_1:Both:main,
     TESTING_2:TenGigabitEthernet2_2:Both:main,
   </param>

 torrus devdiscover  --in=routers.ddx 
 torrus compile --tree=main --verbose

 #kill collector, then restart
 torrus collector --tree=main

Freeside setup

• add serviceids

• in freeside, setup svc_port service defs, packages with torrus billing types order the package, provision an svc_port with a valid serviceid

References

• Torrus install
• Torrus userguide
• Torrus reporting setup