In this tutorial we will show you how to install and configuration of OpenNMS on your CentOS 7 server. For those of you who didn’t know, OpenNMS is a free open source enterprise level network monitoring and management platform that provides information to allow us to make decisions in regards to future network and capacity planning. OpenNMS designed to manage tens of thousands of devices from a single server as well as manage unlimited devices using a cluster of servers. It includes a discovery engine to automatically configure and manage network devices without operator intervention.
This article assumes you have at least basic knowledge of linux, know how to use the shell, and most importantly, you host your site on your own VPS. The installation is quite simple and assumes you are running in the root account, if not you may need to add ‘sudo’ to the commands to get root privileges. I will show you through the step by step installation OpenNMS on a CentOS 7 server.
Install OpenNMS on CentOS 7
Step 1. First let’s start by ensuring your system is up-to-date.
1 2 | yumcleanall yum-yupdate |
Step 2. Installing Java for OpenNMS.
If you do not have Java installed, you can follow our guide here.
Step 3. Installing PostgreSQL for OpenNMS.
If you do not have PostgreSQL installed, you can follow our guide here. Once you have installed PostgreSQL, now you’ll need to make sure that PostgreSQL is up and active. Let’s run the below command to first initialize the database and then start its services:
1 2 3 | postgresql-setupinitdb systemctlstartpostgresql systemctlenablepostgresql |
Step 4. Configure PostgreSQL
Edit the postgresql.conf, located in /var/lib/pgsql/data directory and Open the postgresql.conf file in text editor and configure the following parameters as shown:
1 2 3 4 5 6 7 8 9 10 | ### nano /var/lib/pgsql/data/postgresql.conf #------------------------------------------------------------------------------ # CONNECTIONS AND AUTHENTICATION #------------------------------------------------------------------------------ listen_addresses='localhost' max_connections=256 #------------------------------------------------------------------------------ # RESOURCE USAGE #------------------------------------------------------------------------------ shared_buffers=1024MB |
Then permit the access to the Database by editing the “pg_hba.conf” file as shown below:
1 2 3 4 5 6 7 8 | ### nano /var/lib/pgsql/data/pg_hba.conf # TYPE DATABASE USER ADDRESS METHOD # "local" is for Unix domain socket connections only localallalltrust # IPv4 local connections: hostallall127.0.0.1/32trust # IPv6 local connections: hostallall::1/128trust |
Saved changes and then restart PostgreSQL services:
1 | systemctlrestartpostgresql |
Step 4. Installing OpenNMS.
First add the OpenNMS RPM Repository:
1 | rpm-ivhhttp://yum.opennms.org/repofiles/opennms-repo-stable-rhel7.noarch.rpm |
Then, install OpenNMS:
1 2 | yumupdate yuminstallopennms |
Once the installation is successfully built, configure JAVA for OpenNMS:
1 | /opt/opennms/bin/runjava-s |
Now it’s time to start the OpenNMS installer that will create and configure the OpenNMS database, while the same command will be used in case we want to update it to the latest version:
1 | /opt/opennms/bin/install-dis |
Finally, start OpenNMS service using command:
1 2 | systemctlstartopennms systemctlenableopennms |
Step 5. Configure firewall for OpenNMS.
Then follow the below instruction to configure firewall for permitting OpenNMS:
1 2 | firewall-cmd--permanent--add-port=8980/tcp firewall-cmd--reload |
Step 6. Accessing OpenNMS.
OpenNMS will be available on HTTP port 8980 by default. Open your favorite browser and navigate to http://yourdomain.com:8980 or http://server-ip:8980. Give the username and password where as the default username and password is admin/admin. If you are using a firewall, please open port 8980 to enable access to the control panel.
Congratulation’s! You have successfully installed OpenNMS. Thanks for using this tutorial for installing OpenNMS Network Monitoring and Management Platform on your CentOS 7 system. For additional help or useful information, we recommend you to check the official OpenNMS web site.
