Difference between revisions of "Freeside:2.3:Documentation:Torrus Administration"
From Freeside
(→Manually) |
|||
(14 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. | + | 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. | ||
− | torrus devdiscover --in=routers.ddx | + | su - freeside |
+ | cd /usr/local/etc/torrus/discovery | ||
+ | torrus devdiscover --in=routers.ddx | ||
torrus compile --tree=main --verbose | 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 == | + | === Manually === |
cd /usr/local/etc/torrus/discovery | cd /usr/local/etc/torrus/discovery | ||
Line 33: | 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 | ||
− | + | == 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 = | = References = |
Latest revision as of 14:42, 16 December 2011
Contents
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.