Air-Gap System Installation
Some scenarios for deploying OpenNMS Meridian require that the installation run in an isolated or "air-gapped" network. This page provides a directions for an offline installation of Meridian 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 Meridian installation steps from our Getting Started page.
Basic Process Outline
The basic process involves downloading the RPMs for OpenNMS Meridian 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 Meridian repository and import the GPG key:
cat << EOF | sudo tee /etc/yum.repos.d/opennms-meridian.repo
[meridian]
name=Meridian for Red Hat Enterprise Linux and CentOS
baseurl=https://REPO_USER:REPO_PASS@meridian.opennms.com/packages/2024/stable/rhel$releasever
gpgcheck=1
gpgkey=http://yum.opennms.org/OPENNMS-GPG-KEY
EOF
sudo 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 meridian-core meridian-webapp-jetty
mv ./tmp/opennms_rpms ./airgap_rpm_files/04-opennms
dnf install -y meridian-core meridian-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.