Create an App Key

First create an App Key. You'll need a separate App Key for each integrated system.

Select an Install Method:

RedHat

Install the BigPanda Agent on RedHat

Connect to the host where your OpsView server is installed, and install the BigPanda agent package.

$ sudo wget http://repos.bigpanda.io/config/bigpanda.repo -O /etc/yum.repos.d/bigpanda.repo
$ sudo yum install bigpanda-agent

Note: If you run RHEL 5, you will need to install the EPEL repository. Please consult the FAQ for instructions.

Configure OpsView

Open the main OpsView configuration file (usually /usr/local/nagios/etc/nagios.cfg):

$ sudo vim /usr/local/nagios/etc/nagios.cfg

Set log_rotation_method to d (= daily log rotation)
Make sure log_archive_path is configured (= location of old logs)
Test that OpsView (usually nagios user) has write permissions to the log_archive_path folder

Reload the OpsView service for the changes to take effect.

sudo service opsview reload

Configure the BigPanda Agent

Generate the agent's configuration file:

$ sudo bigpanda-config --init --token $TOKEN
$ sudo bigpanda-config --add opsview --app-key $YOUR_APP_KEY

When prompted, specify the locations of nagios.log, status.dat and objects.cache files.

The script output should look like this:

Log File Path: /var/log/nagios/nagios.log
Status Dat Path: /var/cache/nagios/status.dat
Objects Cache Path: /var/cache/nagios/objects.cache

Of course, the actual paths will depend on your installation.

Update Permissions

Give the agent read permissions to the objects.cache, status.dat and log files. A possible way to do it:

$ sudo usermod -a -G "<GROUP OF OBJECT CACHE FILE>,<GROUP OF LOG FILE>,<GROUP OF STATUS DAT FILE>" bigpanda

Start the BigPanda Agent

On RHEL 6:

$ sudo initctl start bigpanda
On RHEL 5 and 7:

$ sudo service bigpanda start

Success

You should be able to see all your active OpsView alerts in the Incidents tab.

CentOS

Install the BigPanda Agent on CentOS

Connect to the host where your OpsView server is installed, and install the BigPanda agent package.

$ sudo wget http://repos.bigpanda.io/config/bigpanda.repo -O /etc/yum.repos.d/bigpanda.repo
$ sudo yum install bigpanda-agent

Note: If you run CentOS 5, you will need to install the EPEL repository. Please consult the FAQ for instructions.

Configure OpsView

Open the main OpsView configuration file (usually /usr/local/nagios/etc/nagios.cfg):

$ sudo vim /usr/local/nagios/etc/nagios.cfg

Set log_rotation_method to d (= daily log rotation)
Make sure log_archive_path is configured (= location of old logs)
Test that OpsView (usually nagios user) has write permissions to the log_archive_path folder

Reload the OpsView service for the changes to take effect.

sudo service opsview reload

Configure the BigPanda Agent

Generate the agent's configuration file:

$ sudo bigpanda-config --init --token $TOKEN
$ sudo bigpanda-config --add opsview --app-key $YOUR_APP_KEY

When prompted, specify the locations of nagios.log, status.dat and objects.cache files.

The script output should look like this:

Log File Path: /var/log/nagios/nagios.log
Status Dat Path: /var/cache/nagios/status.dat
Objects Cache Path: /var/cache/nagios/objects.cache

Of course, the actual paths will depend on your installation.

Update Permissions

Give the agent read permissions to the objects.cache, status.dat and log files. A possible way to do it:

$ sudo usermod -a -G "<GROUP OF OBJECT CACHE FILE>,<GROUP OF LOG FILE>,<GROUP OF STATUS DAT FILE>" bigpanda

Start the BigPanda Agent

On CentOS 6:

$ sudo initctl start bigpanda
On CentOS 5 and 7:

$ sudo service bigpanda start

Success

You should be able to see all your active OpsView alerts in the Incidents tab.

Debian

Install the BigPanda Agent on Debian

Connect to the host where your OpsView server is installed, and install the BigPanda agent package.

$ echo deb http://repos.bigpanda.io/deb `lsb_release -c -s` main | sudo tee /etc/apt/sources.list.d/bigpanda.list
$ curl https://repos.bigpanda.io/config/bigpanda.pub | sudo apt-key add -
$ sudo apt-get update
$ sudo apt-get install bigpanda-agent

Configure OpsView

Open the main OpsView configuration file (usually /usr/local/nagios/etc/nagios.cfg):

$ sudo vim /usr/local/nagios/etc/nagios.cfg

Set log_rotation_method to d (= daily log rotation)
Make sure log_archive_path is configured (= location of old logs)
Test that OpsView (usually nagios user) has write permissions to the log_archive_path folder

Reload the OpsView service for the changes to take effect.

sudo service opsview reload

Configure the BigPanda Agent

Generate the agent's configuration file:

$ sudo bigpanda-config --init --token $TOKEN
$ sudo bigpanda-config --add opsview --app-key $YOUR_APP_KEY

When prompted, specify the locations of nagios.log, status.dat and objects.cache files.

The script output should look like this:

Log File Path: /var/log/nagios/nagios.log
Status Dat Path: /var/cache/nagios/status.dat
Objects Cache Path: /var/cache/nagios/objects.cache

Of course, the actual paths will depend on your installation.

Update Permissions

Give the agent read permissions to the objects.cache, status.dat and log files. A possible way to do it:

$ sudo usermod -a -G "<GROUP OF OBJECT CACHE FILE>,<GROUP OF LOG FILE>,<GROUP OF STATUS DAT FILE>" bigpanda

Start the BigPanda Agent

$ sudo service bigpanda start

Success

You should be able to see all your active OpsView alerts in the Incidents tab.

Ubuntu

Install the BigPanda Agent on Ubuntu

Connect to the host where your OpsView server is installed, and install the BigPanda agent package.

$ echo deb http://repos.bigpanda.io/deb `lsb_release -c -s` main | sudo tee /etc/apt/sources.list.d/bigpanda.list
$ curl https://repos.bigpanda.io/config/bigpanda.pub | sudo apt-key add -
$ sudo apt-get update
$ sudo apt-get install bigpanda-agent

Configure OpsView

Open the main OpsView configuration file (usually /usr/local/nagios/etc/nagios.cfg):

$ sudo vim /usr/local/nagios/etc/nagios.cfg

Set log_rotation_method to d (= daily log rotation)
Make sure log_archive_path is configured (= location of old logs)
Test that OpsView (usually nagios user) has write permissions to the log_archive_path folder

Reload the OpsView service for the changes to take effect.

sudo service opsview reload

Configure the BigPanda Agent

Generate the agent's configuration file:

$ sudo bigpanda-config --init --token $TOKEN
$ sudo bigpanda-config --add opsview --app-key $YOUR_APP_KEY

When prompted, specify the locations of nagios.log, status.dat and objects.cache files.

The script output should look like this:

Log File Path: /var/log/nagios/nagios.log
Status Dat Path: /var/cache/nagios/status.dat
Objects Cache Path: /var/cache/nagios/objects.cache

Of course, the actual paths will depend on your installation.

Update Permissions

Give the agent read permissions to the objects.cache, status.dat and log files. A possible way to do it:

$ sudo usermod -a -G "<GROUP OF OBJECT CACHE FILE>,<GROUP OF LOG FILE>,<GROUP OF STATUS DAT FILE>" bigpanda

Start the BigPanda Agent

$ sudo service bigpanda start

Success

You should be able to see all your active OpsView alerts in the Incidents tab.