Difference between revisions of "Freeside:2.3:Documentation:Torrus Administration"
From Freeside
(→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. | + | vi routers.ddx |
| − | + | ||
| − | + | Add a section like this at the bottom, just before the final </snmp-discovery>: | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | 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 | ||
| − | + | = 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 | ||
| − | + | == 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 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.
