Zenoss Installation Instructions

How to Integrate Zenoss with BigPanda

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
CentOS
Debian
Ubuntu

RedHat

Install the BigPanda Agent on RedHat

Connect to a host that can access the API endpoints of Zenoss, 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 the BigPanda Agent

Generate the agent's configuration file with your organization token:

$ sudo bigpanda-config --init --token <YOUR TOKEN>

And add the Zenoss plugin with the application key you created in step 1:

$ sudo bigpanda-config --add zenoss --app-key <YOUR APP KEY>

When prompted, enter the base URL of the Zenoss.core web interface and a valid username and password.

Note: You may want to create a dedicated user for BigPanda, the required role is ZenUser.

Set Zenoss Timezone

Zenoss uses the timezone that has been set on the system that Zenoss is installed on. Connect to the server Zenoss is installed on, check its timezone, and select it in the BigPanda app configuration console.

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 Zenoss alerts in the Incidents tab.

CentOS

Install the BigPanda Agent on CentOS

Connect to a host that can access the API endpoints of Zenoss, 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 the BigPanda Agent

Generate the agent's configuration file with your organization token:

$ sudo bigpanda-config --init --token <YOUR TOKEN>

And add the Zenoss plugin with the application key you created in step 1:

$ sudo bigpanda-config --add zenoss --app-key <YOUR APP KEY>

When prompted, enter the base URL of the Zenoss.core web interface and a valid username and password.

Note: You may want to create a dedicated user for BigPanda, the required role is ZenUser.

Set Zenoss Timezone

Zenoss uses the timezone that has been set on the system that Zenoss is installed on. Connect to the server Zenoss is installed on, check its timezone, and select it in the BigPanda app configuration console.

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 Zenoss alerts in the Incidents tab.

Debian

Install the BigPanda Agent on Debian

Connect to a host that can access the API endpoints of Zenoss, 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 the BigPanda Agent

Generate the agent's configuration file with your organization token:

$ sudo bigpanda-config --init --token <YOUR TOKEN>

And add the Zenoss plugin with the application key you created in step 1:

$ sudo bigpanda-config --add zenoss --app-key <YOUR APP KEY>

When prompted, enter the base URL of the Zenoss.core web interface and a valid username and password.

Note: You may want to create a dedicated user for BigPanda, the required role is ZenUser.

Set Zenoss Timezone

Zenoss uses the timezone that has been set on the system that Zenoss is installed on. Connect to the server Zenoss is installed on, check its timezone, and select it in the BigPanda app configuration console.

Start the BigPanda Agent

$ sudo service bigpanda start

Success

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

Ubuntu

Install the BigPanda Agent on Ubuntu

Connect to a host that can access the API endpoints of Zenoss, 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 the BigPanda Agent

Generate the agent's configuration file with your organization token:

$ sudo bigpanda-config --init --token <YOUR TOKEN>

And add the Zenoss plugin with the application key you created in step 1:

$ sudo bigpanda-config --add zenoss --app-key <YOUR APP KEY>

When prompted, enter the base URL of the Zenoss.core web interface and a valid username and password.

Note: You may want to create a dedicated user for BigPanda, the required role is ZenUser.

Set Zenoss Timezone

Zenoss uses the timezone that has been set on the system that Zenoss is installed on. Connect to the server Zenoss is installed on, check its timezone, and select it in the BigPanda app configuration console.

Start the BigPanda Agent

$ sudo service bigpanda start

Success

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


Recommended Reading