torrus/FREESIDE_INSTALL

   1 i should move to the wiki once this is further along
   2
   3 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
   4
   5 # in Makefile, set TORRUS_ENABLED = 1
   6 make configure-torrus
   7 make deploy
   8
   9 set network_monitoring_system config setting to Torrus_Internal
  10
  11 #a little more one-offy from here so far
  12
  13 http://torrus.org/install.pod.html#configuring_torrus :
  14 which isn't enough to start from scratch
  15 http://torrus.org/userguide.pod.html is better
  16 torrus genddx and torrus devdisover
  17
  18 cd /usr/local/etc/torrus/discovery
  19 vi routers.txt #space-delimted router ip addresses
  20 torrus genddx \
  21   --hostfile=routers.txt \
  22   --domain=example.com \
  23   --community=community_string \
  24   --out=routers.ddx \
  25   --discout=routers.xml
  26 torrus devdiscover  --in=routers.ddx
  27
  28 mkdir /srv/torrus/collector_rrd
  29 chown freeside:freeside /srv/torrus/collector_rrd
  30
  31 torrus compile --tree=main --verbose
  32
  33 torrus bs --global --verbose
  34
  35 #XXX database config (before collector start)
  36
  37 #launch data collector
  38 #XXX add to init
  39 torrus collector --tree=main
  40
  41 skip http://torrus.org/install.pod.html#apache_http_server_configuration
  42 and http://torrus.org/install.pod.html#access_control_lists
  43
  44 but do go from http://torrus.org/install.pod.html#cron_job on
  45
  46
  47 #---
  48
  49 http://torrus.org/reporting_setup.pod.html
  50
  51 cd /usr/local/etc/torrus/discovery
  52 vi routers.ddx
  53
  54    <!-- host-specfic parameter  -->
  55    <param name="RFC2863_IF_MIB::external-serviceid">
  56      TESTING_1:TenGigabitEthernet2_1:Both:main,
  57      TESTING_2:TenGigabitEthernet2_2:Both:main,
  58    </param>
  59
  60 torrus devdiscover  --in=routers.ddx
  61 torrus compile --tree=main --verbose
  62
  63 #kill collector, then restart
  64 torrus collector --tree=main
  65
  66 #---
  67
  68 add serviceids
  69
  70 in freeside, setup svc_port service defs, packages with torrus billing types
  71 order the package, provision an svc_port with a valid serviceid
  72