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

From Freeside
Jump to: navigation, search
(Created page with "= 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, Fr…")
 
 
(One intermediate revision by one other user not shown)
Line 15: Line 15:
 
   make deploy
 
   make deploy
  
   mkdir /srv/torrus/collector_rrd
+
   mkdir -p /srv/torrus/collector_rrd
 
   chown -R freeside:freeside /srv/torrus/collector_rrd /usr/local/etc/torrus/discovery /usr/local/etc/torrus/xmlconfig/
 
   chown -R freeside:freeside /srv/torrus/collector_rrd /usr/local/etc/torrus/discovery /usr/local/etc/torrus/xmlconfig/
  
Line 58: Line 58:
 
= Administration =
 
= Administration =
  
Proceed to [[Freeside:2.3:Documentation:Torrus_Administration]]
+
Proceed to [[Freeside:3:Documentation:Torrus_Administration]]
  
 
= References =
 
= References =

Latest revision as of 20:22, 9 September 2015

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 -p /srv/torrus/collector_rrd
 chown -R freeside:freeside /srv/torrus/collector_rrd /usr/local/etc/torrus/discovery /usr/local/etc/torrus/xmlconfig/

Database configuration

In /usr/local/etc/torrus/conf/torrus-siteconfig.pl, edit the following lines if necessary (the installation process does not yet substitute them in from the Makefile)

 $Torrus::SQL::connections{'Default'}{'dsn'} =
     'DBI:mysql:database=torrus;host=dbhost.example.com';
 $Torrus::SQL::connections{'Default'}{'username'} = 'torrus';
 $Torrus::SQL::connections{'Default'}{'password'} = 'imiF1oih';

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 
 chown freeside routers.ddx
 torrus compile --tree=main --verbose
 torrus bs --global --verbose
 #launch data collector
 /etc/init.d/freeside restart

Cron and init script

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

Freeside

Set the network_monitoring_system configuration setting to "Torrus_Internal".

Administration

Proceed to Freeside:3:Documentation:Torrus_Administration

References