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.