Git Repository of OpenNMS tutorial examples
This is tutorial is version 2025-Horizon33 targeting OpenNMS Horizon 33 / Meridian 2025.
Note The videos with eash session are from a previous version of this tutorial. They are still mostly aligned with the content but new videos will be created for this version once it fully updated.
For previous versions of this tutorial see Version History
The repository contains a number of example projects, exercises and an area called myPracticeCourseWork for you to create and store your own example work during the course. As you work through the sessions, you should copy each example session into your own myPracticeCourseWork space and work on it there. That way you commit save your work in your own repository while still being able to receive updates from the upstream master repository.
Please read and follow the Getting Started instructions below before doing anything else.
Enjoy 😀
session1 Introduction to OpenNMS
session2 Introduction to Provisioning OpenNMS
session3 Introduction to Alarms and Events
session4 Database Event and Alarm Enrichment
session5 Performance Data Collection 1
session6 Performance Data Collection 2
session7 Additional Topics and wrap up
Extra Examples Additional Examples in support of the tutorials
myPracticeCourseWork This is where you should create and save your own practice projects.
pristine-opennms-config-files Untouched OpenNMS configuration files for reference.
Before doing anything else you will need to follow these getting started instructions to install the required software.
All of these examples have been tried on Docker Desktop installed on Windows 11.
They should also work on Docker installed in linux (e.g. Ubuntu 22 running in VirtualBox).
In order to complete these exercises you will need docker and docker-compose for the containerised exercises. The easiest way to get these packages is to install docker-desktop which is available for Windows, Mac or Linux machines.
You will also need Java Open JDK (minimum version 17), An IDE (Eclipse or Intelij), Maven and git installed on your machine.
Eclipse for Enterprise Java developers
You should fork this repository into your own github account and synchronise your fork with this repo. Instructions on how to do this are provided in Getting Started with Git