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

From Freeside
Jump to: navigation, search
(Manually)
 
(15 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
= Adding new routers =
 
= 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
 
  cd /usr/local/etc/torrus/discovery
  vi routers.txt #space-delimted router ip addresses
+
  vi routers.ddx
torrus genddx \
+
 
  --hostfile=routers.txt \
+
Add a section like this at the bottom, just before the final </snmp-discovery>:
  --domain=example.com \
 
  --community=community_string \
 
  --out=routers.ddx \
 
  --discout=routers.xml
 
  
  torrus devdiscover  --in=routers.ddx  
+
  <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
+
= Monitoring new interfaces =
torrus collector --tree=main
 
  
= 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
 
  cd /usr/local/etc/torrus/discovery
Line 25: 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
+
 
 +
* 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 =
 
= References =

Latest revision as of 14: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