OpenNMS

OpenNMS monitors the network for services and uptimes.

Installation

Installation is a pain and takes forever. OpenNMS requires memory, memory and more memory. It also requires that postgres and tomcat are running. Read the Debian 4 installation guide here This means if for some reason you can't connect to OpenNMS, first stop all three services, then restart postgres, tomcat and opennms.

discovery-configuration.xml

This file specifies which specific IPs or ranges of IPs OpenNMS should watch to see if new machines are discovered on it. If you want to remove a node from OpenNMS it shouldn't be in this file any more as otherwise OpenNMS will re-discover it.

database-schema.xml

This file tells you which variables can be used in making rules. You can use anything defined in the column name.

Connecting to the pgsql database directly

psql -U opennms opennms

gets you into the database. Using /dt you can show all the tables. You can select from tables using normal SQL syntax.

Creating rules for the main display

First edit categories.xml and make sure the rules work by restarting opennms. Then edit viewsdisplay.xml to add the view categories to the webinterface.

Example to add a category created using admin -> manage node categories In categories.xml, to match to the own created category "Zuilen" add the following:

           <category>
               <label><![CDATA[OPS Servers]]></label>
               <comment>Operations Servers</comment>
               <normal>99.99</normal>
               <warning>97</warning>
               <rule><![CDATA[categoryName=="OPS"]]></rule>
          </category>

In viewsdisplay.xml I added a totally new section (which can contain as many categories as you want)

               <section>
                       <section-name><![CDATA[Console]]></section-name>
                       <category><![CDATA[OPS Servers]]></category>
               </section>

NB in categories.xml the categoryName in the <rule> section refers to a field in database-schema.xml. The <label> is arbritary.

The <category> statement in viewsdisplay.xml refers to the <label> in categories.xml.

Because I added the lines in categories.xml to the existing categorygroup, the rule

       <common>
           <rule><![CDATA[ipaddr IPLIKE *.*.*.*]]></rule>
       </common>

(all IP adresses) Allready applies to the <section> added.

After changing viewsdisplay.xml and categories.xml, stop opennms, restart tomcat, then start opennms to update the homepage!

Resources from the mailing list:

http://sourceforge.net/mailarchive/message.php?msg_id=37838863 http://sourceforge.net/mailarchive/message.php?msg_id=37102227 http://sourceforge.net/mailarchive/message.php?msg_id=36854989

Troubleshooting:

Most things can be found at the mailing list on the discuss, doc and install things. http://sourceforge.net/search/?group_id=4141&type_of_search=mlists&ml_name=opennms-discuss&forum_id=40670 http://sourceforge.net/mailarchive/forum.php?forum=opennms-discuss

NB:

OpenNMS only monitors services which are tcp available - so if a host has no services it doesn't appear on the categories list.

OpenNMS

Navigation menu

Search