How to Install OpenNMS on Arch Linux

OpenNMS is a free, open-source, self-hosted network monitoring and network management solution developed by OpenNMS Group. It helps you to visualize and monitor everything on your local and remote networks. OpenNMS can be integrated with business applications and workflows to monitor your networks. It comes with a web-based interface that allows you to monitor everything from a central place.

In this post, we will show you how to install the OpenNMS monitoring tool with Docker on Arch Linux.

Step 1 – Configure Repository

By default, the default repository is outdated in Arch Linux, so you will need to modify the default mirror list. You can do it by editing the mirror list configuration file:

nano  /etc/pacman.d/mirrorlist

Remove all lines and add the following lines:

## Score: 0.7, United States
Server = http://mirror.us.leaseweb.net/archlinux/$repo/os/$arch
## Score: 0.8, United States
Server = http://lug.mtu.edu/archlinux/$repo/os/$arch
Server = http://mirror.nl.leaseweb.net/archlinux/$repo/os/$arch
## Score: 0.9, United Kingdom
Server = http://mirror.bytemark.co.uk/archlinux/$repo/os/$arch
## Score: 1.5, United Kingdom
Server = http://mirrors.manchester.m247.com/arch-linux/$repo/os/$arch
Server = http://archlinux.dcc.fc.up.pt/$repo/os/$arch
## Score: 6.6, United States
Server = http://mirror.cs.pitt.edu/archlinux/$repo/os/$arch
## Score: 6.7, United States
Server = http://mirrors.acm.wpi.edu/archlinux/$repo/os/$arch
## Score: 6.8, United States
Server = http://ftp.osuosl.org/pub/archlinux/$repo/os/$arch
## Score: 7.1, India
Server = http://mirror.cse.iitk.ac.in/archlinux/$repo/os/$arch
## Score: 10.1, United States
Server = http://mirrors.xmission.com/archlinux/$repo/os/$arch

Save and close the file, then update all the package indexes with the following command:

pacman -Syu

Step 2 – Install Docker

First, you will need to install Docker and Docker Compose on your server. You can install both packages with the following command.

pacman -S docker docker-compose

Once the Docker is installed, enable the Docker service to start at system reboot.

systemctl enable docker

Next, restart your system to apply the system.

reboot

Step 3 – Create a Docker Compose File for OpenNMS

First, create a directory to store OpenNMS configurations.

mkdir opennms

Next, navigate to the OpenNMS directory and create a docker-compose.yml file.

cd opennms
nano docker-compose.yml

Add the following configuration.

version: '3'

volumes:
  data-postgres: {}
  data-opennms: {}

services:
  database:
    image: postgres:12
    container_name: database
    environment:
      - TZ=Europe/Berlin
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
    volumes:
      - data-postgres:/var/lib/postgresql/data
    healthcheck:
      test: [ "CMD-SHELL", "pg_isready -U postgres" ]
      interval: 10s
      timeout: 30s
      retries: 3

  horizon:
    image: opennms/horizon:27.1.1
    container_name: horizon
    environment:
      - TZ=Europe/Berlin
      - POSTGRES_HOST=database
      - POSTGRES_PORT=5432
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
      - OPENNMS_DBNAME=opennms
      - OPENNMS_DBUSER=opennms
      - OPENNMS_DBPASS=opennms
    volumes:
      - data-opennms:/opt/opennms/share/rrd
      - ./overlay:/opt/opennms-overlay
    command: ["-s"]
    ports:
      - "8980:8980/tcp"
      - "8101:8101/tcp"
      - "61616:61616/tcp"
    healthcheck:
      test: [ "CMD", "curl", "-f", "-I", "http://localhost:8980/opennms/login.jsp" ]
      interval: 1m
      timeout: 5s
      retries: 3

Save and close the file when you are done.

Step 4 – Create OpenNMS Container

Your docker-compose.yml file for OpenNMS is now ready to deploy OpenNMS. Run the following command inside the netbox directory to launch the Netbox container.

docker-compose up -d

If everything is fine, you will get the following output.

✔ horizon 12 layers [⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿] 0B/0B Pulled 116.7s
✔ 7a0437f04f83 Pull complete 16.2s
✔ 14e88814ab83 Pull complete 17.1s
✔ 15d4a57fa9b3 Pull complete 38.0s
✔ 48f60c15ef49 Pull complete 39.0s
✔ 40326c4bdfdf Pull complete 80.7s
✔ 8fe30d1fc55f Pull complete 80.9s
✔ a0a9efee3070 Pull complete 81.1s
✔ 736b43559f0f Pull complete 81.2s
✔ fc4845e5d963 Pull complete 81.4s
✔ 0be5443a0ce9 Pull complete 115.5s
✔ bb3010fe38e5 Pull complete 115.6s
✔ 570c6a68cf58 Pull complete 115.7s
✔ database 13 layers [⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿] 0B/0B Pulled 40.3s
✔ f1f26f570256 Pull complete 18.1s
✔ 1c04f8741265 Pull complete 19.4s
✔ dffc353b86eb Pull complete 19.7s
✔ 18c4a9e6c414 Pull complete 20.6s
✔ 81f47e7b3852 Pull complete 23.7s
✔ 5e26c947960d Pull complete 24.5s
✔ a2c3dc85e8c3 Pull complete 24.8s
✔ 17df73636f01 Pull complete 25.1s
✔ 05add2dd64c8 Pull complete 37.9s
✔ f8eca8be8b3c Pull complete 38.2s
✔ cdf9a1dad65d Pull complete 38.4s
✔ 194ad2944d69 Pull complete 38.8s
✔ 66763d72b3d4 Pull complete 39.0s
[+] Running 5/5
✔ Network opennms_default Created 0.1s
✔ Volume "opennms_data-postgres" Created 0.0s
✔ Volume "opennms_data-opennms" Created 0.0s
✔ Container horizon Started 1.5s
✔ Container database Started 1.3s

You can also verify the Netbox container using the following command.

docker-compose ps

You will get the following output.

NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
database postgres:12 "docker-entrypoint.s…" database 21 seconds ago Up 19 seconds (healthy) 5432/tcp
horizon opennms/horizon:27.1.1 "/entrypoint.sh -s" horizon 21 seconds ago Up 18 seconds (health: starting) 0.0.0.0:8101->8101/tcp, :::8101->8101/tcp, 1162/udp, 0.0.0.0:8980->8980/tcp, :::8980->8980/tcp, 10514/udp, 0.0.0.0:61616->61616/tcp, :::61616->61616/tcp

Step 5 – Access OpenNMS Web Interface

At this point, OpenNMS is started and listens on port 8980. Now, open your web browser and access OpenNMS using the URL http://your-server-ip:8980. You should see the OpenNMS login page.

Provide the OpenNMS default admin username and password as admin/admin then click on the Login button. You should see the OpenNMS dashboard on the following page.

Conclusion

Congratulations! You have successfully installed OpenNMS with Docker on Arch Linux. You can now start monitoring your local and remote networks from a central location. You can also try to deploy the OpenNMS monitoring solution on dedicated server hosting from Atlantic.Net!