Restore OpenNMS Horizon

This section describes a basic restore process for a default OpenNMS Horizon installation. OpenNMS Horizon binaries, logs, RRD archives, configurations and the database will be restored.

In this example the backup storage path is /tmp for demonstration purposes. Please be aware that /tmp is not persisted, as most operating systems will delete the content at bootup.

Objectives

  • Restore backup of OpenNMS Horizon components

  • Install PostgreSQL database and restore backup

  • Install OpenJDK

  • Create systemd OpenNMS service unit

Requirements

  • The backups that were made in

  • System user with administrative permissions (sudo)

  • Internet access to download and install OpenJDK and PostgreSQL NOTE: PostgreSQL archive repository provides also older PostgreSQL versions

  • Database password for opennms and postgres user

Restore backups

  • Debian/Ubuntu

Restore user/group definition
sudo cat /tmp/opennms-passwd.txt >> /etc/passwd && /
sudo cat /tmp/opennms-group.txt >> /etc/group
Create log folder
sudo mkdir /var/log/opennms && /
chown opennms. /var/log/opennms
Restore OpenNMS Horizon binaries, RRD archives, configurations
sudo tar -xzf /tmp/opennms-usr-share.tar.gz -C / && \
sudo tar -xzf /tmp/opennms-etc.tar.gz -C / && \
sudo tar -xzf /tmp/opennms-var-lib.tar.gz -C / && \
sudo tar -xzf /tmp/opennms-usr-share-java.tar.gz -C /
Create OpenNMS systemd unit
sudo cp /etc/opennms/opennms.service /lib/systemd/system/ && \
sudo systemctl daemon-reload
Install PostgreSQL database
sudo apt -y install postgresql
Restore OpenNMS database
sudo runuser -l postgres -c 'psql -f /tmp/opennms-postgres.dmp postgres'
Install OpenJDK
apt-get install openjdk-11-jdk
sudo /usr/share/opennms/bin/runjava -s
Run install -dis command
sudo /usr/share/opennms/bin/install -dis
Start OpenNMS service
sudo systemctl start opennms