Difference between revisions of "Freeside:2.3:Documentation:Torrus Installation"

From Freeside
Jump to: navigation, search
(Network setup and discovery)
Line 17: Line 17:
 
= Network setup and discovery =
 
= Network setup and discovery =
  
cd /usr/local/etc/torrus/discovery
+
  cd /usr/local/etc/torrus/discovery
vi routers.txt #space-delimted router ip addresses
+
  vi routers.txt #space-delimted router ip addresses
torrus genddx \
+
  torrus genddx \
  --hostfile=routers.txt \
+
    --hostfile=routers.txt \
  --domain=example.com \
+
    --domain=example.com \
  --community=community_string \
+
    --community=community_string \
  --out=routers.ddx \
+
    --out=routers.ddx \
  --discout=routers.xml
+
    --discout=routers.xml
torrus devdiscover  --in=routers.ddx  
+
  torrus devdiscover  --in=routers.ddx  
  
mkdir /srv/torrus/collector_rrd
+
  mkdir /srv/torrus/collector_rrd
chown freeside:freeside /srv/torrus/collector_rrd
+
  chown freeside:freeside /srv/torrus/collector_rrd
  
torrus compile --tree=main --verbose
+
  torrus compile --tree=main --verbose
  
torrus bs --global --verbose
+
  torrus bs --global --verbose
  
 
#XXX database config (before collector start)
 
#XXX database config (before collector start)
  
#launch data collector
+
  #launch data collector
#XXX add to init
+
  #XXX add to init
torrus collector --tree=main
+
  torrus collector --tree=main
  
 
= Cron and init script =
 
= Cron and init script =

Revision as of 15:35, 23 January 2011

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 setup and 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
  1. 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