Vmware-evaluation
Subscribe

From OpenNMS

Jump to: navigation, search

Contents

OpenNMS Open Virtualization Appliance

Since 1.8.14 the VMware image is also available as OVA template and can be easily imported to Virtual Box or other virtualization platform which supports OVA templates. You find the OVA file in the same directory in Sourceforge files section.

OpenNMS VMWare evaluation

Sometimes it is very helpful to have an additional OpenNMS machine as playground or for preparing updates. For this reason, I've created a VMware Virtual Appliance with a ready-to-run configuration. You can use this machine for a quickshot evaluation or setup a test environment for or prepare a migration. The Virtual Appliance is also listed on Virtual Appliance Marketplace. The latest VM setup contains the following:

  • Ubuntu 10.04.3 LTS Server 32bit
  • OpenNMS 1.8.14 stable
  • Java Version 1.6.0_26
  • PostgreSQL 8.4.8
  • Postfix for local mail delivery
  • Roundcube webmail with preconfigured notification and mailbox access

The files are available on Sourceforge

Deployment guide

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

This guide is also deployed on the virtual machine (http://ip-address)

Hint: This virtual machine is created with VMware Fusion 3.1. I've tested the VM on Windows Vista with VMware Player 3.1. At the first start you will be asked if the machine is "copied" or "moved", I choose "moved it" and question "Take ownership" answer with "yes". If you choose "Copied it" the network mac address will be changed. The network modul will not be loaded. You've to change first /etc/udev/rules.d/70-persistent-net.rules with the correct new MAC address.

Deployment on VMware ESX hosts is also possible. I tested with VMware vCenter Converter. As source I've selected "Virtual VMware Workstation- or other virtual VMware-Machine" and for destination "Virtual VMware Infrastructure-Machine".

Attention: For performance reasons (RAM and I/O) it is not recommended to use this machine in production environment.

Have fun and success with your OpenNMS evaluation or test environment

Hint: If you import the virtual machine to ESX or vsphere a new MAC-address for the network interface will be created. The device policy from Ubuntu will not allow to load the network module with the new MAC-address. You've to modify the following file with the correct new MAC-address: 

/etc/udev/rules.d/70-persistent-net.rules

restart your machine and your module for eth0 will be load correctly.

Hint: If you got a warning that this VMware is already in use, delete the .lck folder, it will be automatically re-created.

Hint: The keyboard layout is german, so sorry for that ;) You can configure your specific keyboard layout with: 

sudo dpkg-reconfigure console-setup

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.

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

Shows 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

--_indigo 17:23, 15 September 2011 (EDT)

Retrieved from "http://www.opennms.org/wiki/Vmware-evaluation"