This article is outdated and may not work correctly for current operating systems or software.
OpenNMS is an enterprise-grade open source network management platform that can be used to monitor and manage numerous devices from a single instance. With all kinds of metrics collected by OpenNMS, system administrators can easily discover service outages and latency and then make informed decisions accordingly.
A newly deployed Vultr Ubuntu 16.04 LTS x64 server instance with at least 2GB of memory. Say its IP address is
Ability to log in as root.
The server instance has been updated to the latest stable status using the EPEL YUM repo.
If you are using a low-end machine with lesser memory, you need to setup a swap file before you can properly run OpenNMS on it.
Log in as root, and execute the following.
dd if=/dev/zero of=/swapfile count=2048 bs=1M chmod 600 /swapfile mkswap /swapfile swapon /swapfile echo '/swapfile none swap sw 0 0' >> /etc/fstab
Traditionally, installing OpenNMS is a relatively complicated job because it involves multiple technologies, including Oracle Java 8 JDK, PostgreSQL, OpenNMS, systemd, etc. Thankfully, OpenNMS provides an official quickstart install script for Ubuntu 16.04, which can greatly simplify the procedures.
Warning: This script is for a fresh installation of OpenNMS only. If you have installed an earlier version of OpenNMS on the system, running this script might cause unintended consequences.
cd curl -L https://github.com/opennms-forge/opennms-install/archive/1.1.tar.gz | tar xz cd opennms-install-1.1 bash bootstrap-debian.sh
The script will automatically install all required components for running OpenNMS. During the process, you only need to confirm the installation and provide database credentials as follows.
If you want to proceed, type YES:
Enter database username:
Enter database password:
Remember to replace the username and password above with your own.
Next, when you are brought into the
Configuring opennms-db interface, press
Enter to manually run the OpenNMS installer as required.
When you are brought into the
Configuring oracle-java8-installer interface, press
Enter to confirm your awareness about the Oracle Binary Code License Agreement for the Java SE Platform Products and JavaFX.
When you see the question
Do you accept the Oracle Binary Code license terms?, use the
Left Arrow key to choose
<Yes> and then press
If all went well, you will see the congratulations message.
Congratulations --------------- OpenNMS is up and running. You can access the web application with http://this-systems-ip:8980 ...
Before you access OpenNMS using a web browser, you should modify firewall rules to allow inbound traffic on port 8980.
ufw allow OpenSSH ufw allow 8980 ufw enable
Finally, point your favorite web browser to
http://203.0.113.1:8980, and log in with the default username
admin and the default password
For security purposes, you should change the password immediately. Hover over the main navigation
Admin and then click the
Change Password link.