Air-Gap System Installation
Some scenarios for deploying OpenNMS Horizon require that the installation run in an isolated or "air-gapped" network. This page provides a directions for an offline installation of Horizon into such a network. As with any offline installation of software, the exact steps may vary depending upon the precise environment details. Before attempting, users should be familiar with the basic OpenNMS Horizon installation steps from our Getting Started page.
Basic Process Outline
The basic process involves downloading the RPMs for OpenNMS Horizon and any dependencies, transferring them to the air-gapped host, performing the installation, and then starting the install.
Prerequisites
-
A system with internet access to download packages
-
Target system running a compatible distribution
-
Sufficient disk space for package downloads
-
Administrative privileges on both systems
Part 1: Package Download (Internet-Connected System)
Step 1: Create a Temporary Package Directory
Create a base directory to organize all downloaded packages. This directory will become the base directory and dependencies will be included inside sub-folders to aid in knowing what order to install them.
mkdir ./airgap_rpm_files
Step 2: Install OpenNMS Repository
Add the Horizon repository and import the GPG key:
dnf -y install https://yum.opennms.org/repofiles/opennms-repo-stable-rhel9.noarch.rpm
rpm --import https://yum.opennms.org/OPENNMS-GPG-KEY
Step 3: Download OpenJDK
Download and install OpenJDK packages (OpenJDK 17 here but please refer to system requirements):
dnf install --downloadonly --downloaddir=/tmp/opennms_rpms java-17-openjdk-devel
mv ./tmp/opennms_rpms ./airgap_rpm_files/01-openjdk
dnf install -y java-17-openjdk-devel
Step 4: Download PostgreSQL
Download PostgreSQL server packages (please refer to system requirements for version support):
dnf install --downloadonly --downloaddir=/tmp/opennms_rpms postgresql-server
mv ./tmp/opennms_rpms ./airgap_rpm_files/02-postgresql
dnf install -y postgresql-server
Step 5: Download OpenNMS Core Packages
Download the basic OpenNMS packages. If you need other packages, this would be the step to add them in.
dnf install --downloadonly --downloaddir=/tmp/opennms_rpms opennms-core opennms-webapp-jetty
mv ./tmp/opennms_rpms ./airgap_rpm_files/04-opennms
dnf install -y opennms-core opennms-webapp-jetty
Part 2: Installation on Air-Gapped System
Transfer the files to your air-gapped system via USB, DVD, or secure file transfer.
Post-Installation
After completing the package installation, proceed with OpenNMS configuration as described in our Set up the core instance documentation.
Troubleshooting
Common Issues
-
GPG Key Errors: Ensure the OpenNMS GPG key is properly imported before package installation
-
Dependency Conflicts: Verify all prerequisite packages are installed in the correct order
-
Permission Issues: Ensure you have administrative privileges for all installation steps
-
FIPS Compliance Issues: Reach out to OpenNMS Support for FIPS Compliance issues.