Difference between revisions of "Freeside:2.3:Documentation:Torrus Administration"
From Freeside
(→Adding new routers) |
(→Manually) |
||
| (10 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 | ||
| Line 14: | Line 19: | ||
</host> | </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 | ||
| − | |||
| − | |||
| − | |||
= Monitoring new interfaces = | = Monitoring new interfaces = | ||
| Line 24: | 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 34: | 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 == | == Freeside == | ||
| Line 45: | Line 56: | ||
* Order the package for a customer, and provision the Port service. | * Order the package for a customer, and provision the Port service. | ||
* The "Torrus serviceid" dropdown will have a list of the currently monitored serviceids. | * 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 13: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.
