Copyright © 1999, 2000, 2001 Oculan Corp.
2001
Table of Contents
List of Tables
Copyrights. The following copyrights are relevant to OpenNMS code or documentation:
Copyright (c) 2002 Sortova Consulting Group, Inc. All rights reserved.
Copyright (c) 1999-2001 Oculan Corp. All rights reserved.
Copyright (c) 1996-2001 PostgreSQL, Inc.
Copyright (c) 1994 Regents of California, Inc.
Copyright (c) 1994-2001 Sun Microsystems, Inc
Copyright (c) 1994-2001 IBM Corporation
Copyright (c) 2001 Microsoft Corporation
Copyright (c) 2001 Netscape
Copyright (c) 2001 Red Hat, Inc.
Copyright (c) 1999-2001 ExoLab Group
Copyright (c) 1999-2001 Apache Software Foundation
Copyright (c) 1998-2001 The Mozilla Organization
Useful links for information. The following URLs are relevant to OpenNMS code or documentation:
OpenNMS.org - OpenNMS web site
apache.org - home of Xerces, XML4J etc
Sun - home of JAVA
W3C Organization - home of XSLFO and XML
PostgreSQL - home of PostgreSQL
Sortova Consulting Group - Commercial Services for OpenNMS
Table of Contents
Warning: This document is deprecated and refers to old code. A new document is being developed, but for now the best source of information can be found on Sourceforge. This document may be wrong on a number of important issues, and it will definitely waste your time.
For purposes of this guide, requirements are very specific. While actual requirements may vary, this document's purpose is to guide a user installing and configuring quickly.
Table 1.1. Guide Requirements
Resource | Minimum Requirement | Available Resources |
---|---|---|
OpenNMS Installation Media/File | Version 1.0.0 or greater | www.OpenNMS.org |
Linux Op System | Redhat Linux | www.redhat.com |
JAVA Virtual Machine (JVM) | Version 1.4 or greater | java.sun.com |
Free Disk Space | 25Mb (+8Mb/SNMP Device) in /opt, 25Mb in /tmp | |
Free Memory | 192 MB available (256 suggested) |
Table of Contents
For purposes of this quick start guide, it is assumed that the web installer will be installing and configuring most of your dependencies. you may want to make sure that some packages are not installed prior to beginning the web installer, in order to insure correct configuration.
If you would like to install and configure dependency software on your machine, you may want to use the OpenNMS Installation Guide. Otherwise we will begin by checking for already installed software that may not be configured to run with OpenNMS.
The packages we need to insure are not already installed are listed below, along with a command line to test whether or not the RPMs are currently installed.
PostgreSQL # rpm -qa | grep -i postgres Tomcat # rpm -qa | grep -i tomcat RRDTool # rpm -qa | grep -i rrdtool OpenNMS # rpm -qa | grep -i opennms
The JDK package is necessary for building from source and for running OpenNMS with the Tomcat web interface, because the compiler components of the JDK are used to turn JSP web pages into Java at runtime. The environment variable JAVA_HOME should be set to /usr/java/j2sdk1.4.0 or the directory where it was installed.
Table of Contents
When installed, OpenNMS defaults to the following directories:
Table 3.1. Installation Directories
Location | Directory |
---|---|
OpenNMS Binaries | /opt/OpenNMS/ |
OpenNMS Config Files | /opt/OpenNMS/etc/ |
SQL Libraries | /usr/lib/pgsql/opennms/ |
Boot script | /etc/rc.d/init.d/opennms |
Database Store | /var/ |
To install or upgrade on a supported RPM platform, run, as root:
lynx -source http://install.opennms.org | sh
NOTE: It has been noticed that in some cases, the install script will "hang" after it has completed installing the OpenNMS RPMs. The only thing left to be done at this point is to install the documentation. If you notice this condition during your install you can safely use <ctrl>C to break out of the script.
At that point you can either run the script again, and the documentation will be installed, or simply verify that OpenNMS was installed by typing ...
rpm -qa | grep -i opennms
Table of Contents
Next we must define address(es) to be polled and service(s) to be monitored. The configuration files for OpenNMS are in the $OPENNMS_HOME/etcdirectory. These files can be edited with vi or most any other *nix text editor. Most of the files in the etc directory are in XML format, and should be fairly intuitive. (This is strictly a matter of opinion though I guess.)
The first task is assigning addresses. We will start by setting up a discovery range. This is done in discovery-configuration.xml, and should look similar to the following ...
<include-range retries="2" timeout="3000"> <begin>192.168.0.1</begin> <end>192.168.0.254</end> </include-range>
Next we want to ensure that the pollers are aware of this range of addresses. This is done in poller-configuration.xml.
<include-range begin="192.168.0.1" end="192.168.0.254"/>
Note: you may also want to ensure that your network has a management-policy of managed in capsd-configuration.xml. Default configuration is managed for all non-local, valid ip addresses.
There are many other files in the etc directory that you may wish to make changes to, in order to achieve your desired results. Some of the more common things you may want to configure are as follows.
snmp-config.xml. set snmp community strings
log4j.properties. change default logging levels
views.xml + viewsdisplay.xml. change default catagories and display properties
Table of Contents
Make sure you remembered to start the necessary dependencies.
/sbin/service postgresql start
After those dependencies are started, you can start OpenNMS
/sbin/service opennms start or /opt/OpenNMS/bin/opennms.sh start
You will also want to ensure that the tomcat server is running.
/sbin/service tomcat4 start
You can check the status of OpenNMS using the following command.
# /opt/OpenNMS/bin/opennms.sh status OpenNMS.Poller : running OpenNMS.Eventd : running OpenNMS.OutageManager : running OpenNMS.Discovery : running OpenNMS.Actiond : running OpenNMS.Capsd : running OpenNMS.Dhcpd : running OpenNMS.Notifd : running OpenNMS.RTCViewCategoryManager : running OpenNMS.Trapd : running
If there are any problems or services are not starting correctly, you can check the logs for more information. The log files are located in /var/log/opennms/
NOTE: If you need to stop the current OpenNMS processes you can use one of the following commands.
/opt/OpenNMS/bin/opennms.sh stop /opt/OpenNMS/bin/opennms.sh kill
Once everything is started, you can, in your web browser, go to the following address.
http://127.0.0.1:8080/opennms/
login: admin/admin
After logging in you will be directed to the main OpenNMS view of your network. Although most browsers will work, only the following are officially supported... for Linux: Netscape 4.7+, Netscape 6+, Mozilla 0.8+ and for Windows: Netscape 4.7+, Netscape 6+, IE 5.5+