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

From Freeside
Jump to: navigation, search
(Manually)
 
(16 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
 +
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
 
  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  
 
  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 =
  
torrus compile --tree=main --verbose
+
* 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.
  
#kill collector, then restart
+
= References =
torrus collector --tree=main
 
  
= Monitoring new interfaces =
+
* [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 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