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

From Freeside
Jump to: navigation, search
 
(16 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
= Introduction =
 
= 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.
+
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 =
 
= Prerequisites =
Line 15: Line 15:
 
   make deploy
 
   make deploy
  
−
= Network setup and discovery =
+
  mkdir /srv/torrus/collector_rrd
 +
  chown -R freeside:freeside /srv/torrus/collector_rrd /usr/local/etc/torrus/discovery /usr/local/etc/torrus/xmlconfig/
  
−
cd /usr/local/etc/torrus/discovery
+
= Database configuration =  
−
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
+
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)
−
chown freeside:freeside /srv/torrus/collector_rrd
 
  
−
torrus compile --tree=main --verbose
+
  $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';
  
−
torrus bs --global --verbose
+
= Network discovery =
  
−
#XXX database config (before collector start)
+
  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
  
−
#launch data collector
+
  chown freeside routers.ddx
−
#XXX add to init
+
 
−
torrus collector --tree=main
+
  torrus compile --tree=main --verbose
 +
 
 +
  torrus bs --global --verbose
 +
 
 +
  #launch data collector
 +
  /etc/init.d/freeside restart
  
 
= Cron and init script =
 
= Cron and init script =
  
−
  http://torrus.org/install.pod.html#cron_job  
+
  http://torrus.org/install.pod.html#cron_job
 +
 
 +
= Freeside =
 +
 
 +
Set the network_monitoring_system configuration setting to "Torrus_Internal".
 +
 
 +
= Administration =
 +
 
 +
Proceed to [[Freeside:2.3:Documentation:Torrus_Administration]]
 +
 
 +
= References =
  
−
but do go from http://torrus.org/install.pod.html#cron_job on
+
* [http://torrus.org/install.pod.html Torrus install]
 +
* [http://torrus.org/userguide.pod.html Torrus userguide]
 +
* [http://torrus.org/reporting_setup.pod.html Torrus reporting setup]

Latest revision as of 22:30, 9 April 2012

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 -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:2.3:Documentation:Torrus_Administration

References

Retrieved from "http://secure.freeside.biz/mediawiki/index.php?title=Freeside:2.3:Documentation:Torrus_Installation&oldid=7012"