questionable auto-domaining of username@domain usernames on package import, RT#9117
[freeside.git] / torrus / FREESIDE_INSTALL
index fa49848..130168b 100644 (file)
@@ -1,11 +1,72 @@
 i should move to the wiki once this is further along
 
-aptitude install rrdtool librrds-perl libxml-libxml-perl libberkeleydb-perl libtemplate-perl libproc-daemon-perl libnet-snmp-perl libapache-session-perl libjson-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
 
+# in Makefile, set TORRUS_ENABLED = 1
 make configure-torrus
-make install-torrus
+make deploy
 
-#(and for the apache config)
-# in Makefile, set TORRUS_ENABLED = 1
-make install-apache
+set network_monitoring_system config setting to Torrus_Internal
+
+#a little more one-offy from here so far
+
+http://torrus.org/install.pod.html#configuring_torrus :
+which isn't enough to start from scratch
+http://torrus.org/userguide.pod.html is better
+torrus genddx and torrus devdisover
+
+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
+
+#XXX database config (before collector start)
+
+#launch data collector
+#XXX add to init
+torrus collector --tree=main
+
+skip http://torrus.org/install.pod.html#apache_http_server_configuration
+and http://torrus.org/install.pod.html#access_control_lists
+
+but do go from http://torrus.org/install.pod.html#cron_job on
+
+
+#---
+
+http://torrus.org/reporting_setup.pod.html
+
+cd /usr/local/etc/torrus/discovery
+vi routers.ddx
+
+   <!-- host-specfic parameter  -->
+   <param name="RFC2863_IF_MIB::external-serviceid">
+     TESTING_1:TenGigabitEthernet2_1:Both:main,
+     TESTING_2:TenGigabitEthernet2_2:Both:main,
+   </param>
+
+torrus devdiscover  --in=routers.ddx 
+torrus compile --tree=main --verbose
+
+#kill collector, then restart
+torrus collector --tree=main
+
+#---
+
+add serviceids
+
+in freeside, setup svc_port service defs, packages with torrus billing types
+order the package, provision an svc_port with a valid serviceid