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

From Freeside
Jump to: navigation, search
(→‎Monitoring new interfaces)
(→‎Manually)
 
(13 intermediate revisions by the same user not shown)
Line 2: Line 2:
  
 
== Web UI ==
 
== Web UI ==
 +
 +
* Go to Network Main -> Routers
 +
* Click on "Add Router"
  
 
== Manually ==
 
== Manually ==
 +
 +
Note: Execute these commands as the freeside user to retain correct permissions and allow the web UI to make changes.
  
 
  cd /usr/local/etc/torrus/discovery
 
  cd /usr/local/etc/torrus/discovery
−
  vi routers.txt #space-delimted router ip addresses
+
  vi routers.ddx
−
torrus genddx \
 
−
  --hostfile=routers.txt \
 
−
  --domain=example.com \
 
−
  --community=community_string \
 
−
  --out=routers.ddx \
 
−
  --discout=routers.xml
 
  
−
  torrus devdiscover  --in=routers.ddx  
+
Add a section like this at the bottom, just before the final </snmp-discovery>:
 +
 
 +
  <host>
 +
    <param name="snmp-host" value="204.26.60.252"/>
 +
  </host>
 +
 
 +
Note: Execute these commands as the freeside user to retain correct permissions.
 +
 
 +
su - freeside
 +
cd /usr/local/etc/torrus/discovery
 +
  torrus devdiscover  --in=routers.ddx
 
  torrus compile --tree=main --verbose
 
  torrus compile --tree=main --verbose
−
 
−
#kill collector, then restart
 
−
torrus collector --tree=main
 
  
 
= Monitoring new interfaces =
 
= Monitoring new interfaces =
Line 25: Line 31:
  
 
=== Web UI ===
 
=== Web UI ===
 +
 +
* Go to the "Interface traffic and error counters" page for an existing router.
 +
* Click the "Monitor for Billing" link next to an interface.
  
 
=== Manually ===
 
=== Manually ===
Line 35: Line 44:
 
   </param>
 
   </param>
  
 +
Note: Execute these commands as the freeside user to retain correct permissions.
 +
 +
su - freeside
 +
cd /usr/local/etc/torrus/discovery
 
  torrus devdiscover  --in=routers.ddx  
 
  torrus devdiscover  --in=routers.ddx  
 
  torrus compile --tree=main --verbose
 
  torrus compile --tree=main --verbose
  
−
#kill collector, then restart
+
== Freeside ==
−
torrus collector --tree=main
 
  
−
== Freeside ==
+
* Setup an svc_port service definition, include it in a package definition with "Bandwidth (volume)" or "Bandwidth (95th percentile)" price plan.
 +
* Order the package for a customer, and provision the Port service.
 +
* The "Torrus serviceid" dropdown will have a list of the currently monitored serviceids.
  
−
* add serviceids
+
= Virtual ports =
  
−
* in freeside, setup svc_port service defs, packages with torrus billing types order the package, provision an svc_port with a valid serviceid
+
* Configuration -> Network Monitoring -> View/Edit virtual ports
 +
* The freeside-torrus-srvderive daemon combines virtual port data from component ports.
 +
* The following delays apply:
 +
** If the virtual port combines existing ports _that are already being monitored for billing_, you will be able to view bandwidth graphs within 1 hour of adding the virtual port
 +
** OR, if the virtual port combines NEW ports that have not yet been monitored for billing until the current day, it will take until the next morning for bandwidth graphs to appear.
  
 
= References =
 
= References =

Latest revision as of 13:42, 16 December 2011

Adding new routers

Web UI

  • Go to Network Main -> Routers
  • Click on "Add Router"

Manually

Note: Execute these commands as the freeside user to retain correct permissions and allow the web UI to make changes. 

cd /usr/local/etc/torrus/discovery
vi routers.ddx

Add a section like this at the bottom, just before the final </snmp-discovery>: 

 <host>
   <param name="snmp-host" value="204.26.60.252"/>
 </host>

Note: Execute these commands as the freeside user to retain correct permissions. 

su - freeside
cd /usr/local/etc/torrus/discovery
torrus devdiscover  --in=routers.ddx
torrus compile --tree=main --verbose

Monitoring new interfaces

Torrus

Web UI

  • Go to the "Interface traffic and error counters" page for an existing router.
  • Click the "Monitor for Billing" link next to an interface.

Manually

cd /usr/local/etc/torrus/discovery
vi routers.ddx
  <param name="RFC2863_IF_MIB::external-serviceid">
    TESTING_1:TenGigabitEthernet2_1:Both:main,
    TESTING_2:TenGigabitEthernet2_2:Both:main,
  </param>

Note: Execute these commands as the freeside user to retain correct permissions. 

su - freeside
cd /usr/local/etc/torrus/discovery
torrus devdiscover  --in=routers.ddx 
torrus compile --tree=main --verbose

Freeside

  • Setup an svc_port service definition, include it in a package definition with "Bandwidth (volume)" or "Bandwidth (95th percentile)" price plan.
  • Order the package for a customer, and provision the Port service.
  • The "Torrus serviceid" dropdown will have a list of the currently monitored serviceids.

Virtual ports

  • Configuration -> Network Monitoring -> View/Edit virtual ports
  • The freeside-torrus-srvderive daemon combines virtual port data from component ports.
  • The following delays apply:
    • If the virtual port combines existing ports _that are already being monitored for billing_, you will be able to view bandwidth graphs within 1 hour of adding the virtual port
    • OR, if the virtual port combines NEW ports that have not yet been monitored for billing until the current day, it will take until the next morning for bandwidth graphs to appear.

References

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