Working with the BigPanda Agent

Learn how to install, configure, update and uninstall the BigPanda Agent.

Installing the BigPanda Agent

To install the agent, use the following commands based on your OS:

$ sudo wget http://repos.bigpanda.io/config/bigpanda.repo -O /etc/yum.repos.d/bigpanda.repo
$ sudo yum install bigpanda-agent
$ 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

Configuring the Agent Behind a Proxy Server

You can configure the BigPanda agent to work behind a proxy server.

Prerequisites

Install the BigPanda agent on your server by following the installation instructions for the integration.

Procedure

  1. Use ssh to connect to the server where the agent is installed.
  2. Open /etc/bigpanda/bigpanda.conf in a text editor (ie: sudo vim /etc/bigpanda/bigpanda.conf)
  3. Add the proxy configuration under the backend section of the configuration JSON.
    The proxy configuration semantics are based on the semantics of the Python Requests library.
{
  "root": {
    "backend": {
       "proxies": {
         "http": "http://10.10.1.10:3128",
         "https": "http://10.10.1.10:1080"
       }
    }
  }
}
  1. Save the configuration file and restart the agent.

Upgrading the BigPanda Agent

You can upgrade the BigPanda Agent to access the features and fixes available in a newer version.

Prerequisites

  • Review the BigPanda Agent Release Notes.
  • Obtain access to the server where the BigPanda agent is installed.
  • Determine the OS on the server.

Procedure

  1. Stop the BigPanda agent by running one of the following commands.
  • For RHEL 5 and 7, CentOS 5 and 7, Debian, and Ubuntu:
    sudo service bigpanda stop
  • For RHEL 6 and CentOS 6:
    sudo initctl stop bigpanda
  1. Upgrade the agent by running one of the following commands.
  • For RHEL and CentOS:
    sudo yum install bigpanda-agent
  • For Debian and Ubuntu:
    sudo apt-get update
    sudo apt-get install bigpanda-agent
  1. Make sure that the BigPanda agent has started by running one of the following commands.
  • For RHEL 5 and 7, CentOS 5 and 7, Debian, and Ubuntu:
    `sudo service bigpanda start
  • For RHEL 6 and CentOS 6:
    sudo initctl start bigpanda
  1. Verify that the agent version has been upgraded by running the following command.
    sudo grep version /etc/bigpanda/bigpanda.conf

Uninstalling the BigPanda Agent

To fully remove an agent-based integration, you must remove the BigPanda agent from the associated server.

Prerequisites

  • Obtain access to the server where the BigPanda agent is installed
  • Determine the OS on the server.

Uninstalling the Agent from RedHat Enterprise Linux (RHEL) and CentOS

  1. Connect to the server where you want to uninstall the BigPanda agent package. You must have root privileges.
  2. Run the following commands.
  • sudo yum remove bigpanda-agent
  • sudo rm /etc/yum.repos.d/bigpanda.repo

Uninstalling the Agent from Debian and Ubuntu

  1. Connect to the server where you want to uninstall the BigPanda agent package. You must have root privileges.
  2. Run the following commands:
  • sudo apt-get purge bigpanda-agent
  • sudo rm /etc/apt/sources.list.d/bigpanda.list
  • sudo apt-get update

Uninstalling The Agent Manually

❗️

This method does not remove the package from your package manager's database. Consider using this information to verify that the agent files are completely removed.

  1. Stop the BigPanda service by running the following command:
  • sudo service bigpanda stop
  1. Remove the BigPanda python module from the Python2.6 or Python2.7 library.
    This library is usually located in /usr/lib/pythonVERSION/site-packages/bigpanda or /usr/lib/pythonVERSION/dist-packages/bigpanda.
  2. Remove the following files:
  • /usr/bin/bigpanda-agent
  • /usr/bin/bigpanda-config
  • /etc/init/bigpanda.conf
  • /etc/init.d/bigpanda
  • /etc/rc*.d/*bigpanda
  • /etc/bigpanda
  • /var/log/bigpanda
  • /var/lib/bigpanda
  • /var/run/bigpanda
  1. Remove the BigPanda user and group by running the following commands:
  • sudo userdel -r bigpanda
  • sudo groupdel bigpanda