Freeside:3:Documentation:Torrus Administration

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

If you add or change interfaces on a router you need to recompile the configuration database with the following commands:

cd /usr/local/etc/torrus/discovery
sudo -u freeside torrus devdiscover --in=routers.ddx
sudo -u freeside 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.

Trouble shooting

• If Networking main displays the text "Error:Error initialzing Renderer" this typically means that the BerkeleyDB backend for Torrus has become corrupted

The database can be repaired with the following procedure:

/etc/init.d/freeside stop
db_recover -h /var/torrus/db
torrus compilexml --verbose --all
/etc/init.d/freeside start

References

• Torrus install
• Torrus userguide
• Torrus reporting setup
• Database troubleshooting