Difference between revisions of "Freeside:2.3:Documentation:Torrus Installation"
From Freeside
(New page: = 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 int...) |
|||
| (17 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 | + | 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 = | ||
| − | 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 | + | 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 = | ||
| + | |||
| + | * [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 23:30, 9 April 2012
Contents
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
