Linux

To install PRIS on your Linux system you have to install a current Java Runtime Environment OpenJDK 8 or Oracle 8 JRE

Download and extract the latest stable release from GitHub.

The provided system start scripts assume you install PRIS in /opt/opennms-pris. If you want to install in a different directory, ensure you modify the start scripts to fit your location.

Make sure your java binary is in your search path.

# Create directory for PRIS
mkdir /opt/opennms-pris
cd /opt/opennms-pris

# Download latest release from GitHub
curl -L {{% ghlatesturl "https://api.github.com/repos/OpenNMS/opennms-provisioning-integration-server/releases/latest" ".tar.gz" %}} -o pris-latest.tar.gz

# Extract in current directory
tar xzf pris-latest.tar.gz --strip-components=1

Systemd Start Script

To start PRIS as a system service on a Linux system using Systemd you can use the init script

# Current working directory as root: /opt/opennms-pris

cp opennms-pris.init /etc/init.d/opennms-pris
update-rc.d opennms-pris defaults
service opennms-pris start

SysV Init Script

To start PRIS as a system service on a Linux system using SysV you can use the init script

# Current working directory as root: /opt/opennms-pris

cp opennms-pris.service /etc/systemd/system
systemctl enable opennms-pris.service
systemctl start opennms-pris.service

Run in Foreground

Use this command to start PRIS in foreground:

# Current working directory: /opt/opennms-pris
java -cp ./lib/*:./opennms-pris.jar org.opennms.pris.Starter