Introduction

This virtual appliance is designed for OpenNMS evaluation and test environments. The System is intalled with Ubuntu 10.04 Server and OpenNMS 1.8.3 stable. For evaluation or testing there is Postfix with Dovecot IMAP and Roundcube webmail installed and pre-configured.

Network and system setup

System	CPU: 1 RAM: 1 GB Swap: 512 MB Harddisk: 32 GB no sound USB available VMware Tools 8.4.3-282344
Netzwerk	Shared network with NAT and dynamic IP address assignment. If you want to configure a static IP address change the following file: vi /etc/network/interfaces Example static IP iface eth0 inet static address <static-ip> netmask <subnetmask> network <networkmask> broadcast <broadcast> gateway <default-gateway> Domain name resolution /etc/resolv.conf Example with default domain search: search <your-domain> nameserver <ip-adresse-1> nameserver <ip-adresse-2> ...
SNMP	The system has a preconfigured SNMP agent with default community set to public. The SNMP agent is bound to local loopback. The snmp community is set to readonly. The configuration files are located in: /etc/default/snmpd <-- bind to loopback /etc/snmp/snmpd.conf <-- generic agent configuration /etc/snmp/snmpd.local.conf <-- host specific config
Postfix	For mail delivery is postix as local mail service configured. Postfix listen on local loopback device. OpenNMS sends mails to local postfix mailserver. Mails are delivered to local system user. Configuration file for postfix is located in /etc/postfix/main.cf
PostgreSQL	All data related to nodes like SNMP-Traps, Syslog or OpenNMS events are stored in PostgreSQL database. The configuration for postgres is located in /etc/postgresql/8.4/main/pg_hba.con /etc/postgresql/8.4/main/postgresql.conf Database files are stored in /var/lib/postgresql/8.4/main Full access to postgres is provided with database user postgres: Login as root and switch to postgres with: su - postgres SQL queries and database access is possible with: psql -h localhost -d opennms

Users, Passwords and URLs

System

Two preconfigured users:

Administration and maintenance

Login: root
Password: evaluation

Local user with mailbox access for notifications:

Login: opennms
Password: evaluation
mail address: opennms@opennms-eval.localdomain

Roundcube Webmail

Webaccess to mailbox with roundcube webmail:

http://<ip-address>/roundcube
Login: opennms
Password: evaluation

Configuration for roundcube is located in

/etc/roundcube

OpenNMS

OpenNMS itself has also two users. The admin user is default and should not be deleted. For notification tests you can use user opennms with preconfigured mail notification and contact informations.

URL: http://<ip-address>:8980/opennms
Login: admin
Password: admin

The user opennms has also administration privileges to add and delete nodes (magic-users.properties):

Login: opennms
Password: evaluation
eMail: opennms@opennms-eval.localdomain

OpenNMS has the following directories:

/usr/share/opennms <-- main directory for OpenNMS
--> bin <-- binary executable
--> contrib <-- Helper scripts, e.g. converting MIBS
--> etc <-- configuration files (link to /etc/opennms)
--> jetty-webapps <-- Application server with OpenNMS webapp
--> lib <-- Libraries and dependencies used in OpenNMS
--> logs <-- OpenNMS log files (link to /var/log/opennms)
--> share <-- JRB performance data (link to /var/lib/opennms)
--> webapps <-- Webapp for other Java Applicationserver

Start and Stop services

Postfix	service postfix start \| stop \| restart \| reload
OpenNMS	service opennms start \| stop opennms -v status Show current status from OpenNMS daemons.
Postgresql	service postgresql-8.4 start \| stop \| reload
Roundcube	service apache2 start \| stop \| reload
Dovecot IMAP	service dovecot start \| stop

Project

Get Support	http://www.opennms.org/get-support/
Get Involved	http://www.opennms.org/get-involved/
Get OpenNMS	http://www.opennms.org/get-opennms/
OpenNMS Wiki	http://www.opennms.org/wiki/Main_Page