Install from Package

This section describes how to install the OpenNMS Plugin for Grafana from a package on Debian, Ubuntu, and RPM-based Linux distributions (CentOS, Fedora, and so on).

These instructions assume that you do not have Grafana installed on your target system. If you have an existing Grafana instance that you want to use, see Install OpenNMS Plugin for Grafana Plugin.

Debian & Ubuntu

Follow these steps to install the stable version of the plugin on Debian or Ubuntu.

If the plugin is installed on your Horizon or Meridian server, you can skip steps 1 and 2 in this procedure.

  1. Create a new apt file (for example, /etc/apt/sources.list.d/opennms.list) and add the following code:

    deb https://debian.opennms.org stable main
deb-src https://debian.opennms.org stable main

  2. Import the authentication key:

    wget -O- https://debian.opennms.org/OPENNMS-GPG-KEY | tee -a /etc/apt/trusted.gpg.d/opennms.asc

  3. Install the plugin packages:

    sudo apt-get update
sudo apt-get install opennms-grafana-plugin

RPM-based Linux

Follow these steps to install the stable version of the plugin on an RPM-based Linux distribution.

If the plugin is installed on your Horizon or Meridian server, skip step 1 in this procedure.

  1. Install the package repository:

    sudo yum install https://yum.opennms.org/repofiles/opennms-repo-stable-rhel7.noarch.rpm
sudo rpm --import https://yum.opennms.org/OPENNMS-GPG-KEY

  2. Install the packages:

    sudo yum install opennms-grafana-plugin

Start Grafana

You can start your Grafana server in two ways: using systemd, or using init.d.

systemd

Follow these steps to start your Grafana server using systemd:

  1. Reload all daemons:

    sudo systemctl daemon-reload

  2. Start the Grafana server and check its status:

    sudo systemctl start grafana-server
sudo systemctl status grafana-server

    • This starts the grafana-server process as the grafana user, which is created during package installation.

    • Note that the default HTTP port and username/password combination are set to the following:

      • HTTP port: 3000

      • Username/password: admin/admin

    • For information on customizing the HTTP port or your username and password, see the official Grafana documentation.

  3. Configure the systemd service to start on boot:

    sudo systemctl enable grafana-server.service

init.d

Follow these steps to start your Grafana server using the init.d service:

  1. Start Grafana:

    sudo service grafana-server start

    • This starts the grafana-server process as the grafana user, which is created during package installation.

    • Note that the default HTTP port and username/password combination are set to the following:

      • HTTP port: 3000

      • Username/password: admin/admin

    • For information on customizing the HTTP port or your username and password, see the official Grafana documentation.

  2. Configure your Grafana server to start on boot:

    sudo /sbin/chkconfig --add grafana-server

Next steps

After you install Grafana and the plugin, you can create your first dashboard.