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 includes an integrated/skinned Torrus (like it does RT), providing 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

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

 #or does this need to be after devdiscover/compile?
 torrus bs --global --verbose

Network discovery

Freeside:2.3:Documentation:Torrus_Administration#Adding_new_routers

XXX database config (before collector start)

Cron and init script

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

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