Installation Overview

Installing Sensu Enterprise

Sensu Enterprise is supported on RHEL/CentOS and Ubuntu/Debian Linux distributions. Please see the relevant section below for information on installing Sensu Enterprise and its prerequisites.

Prior to working through either the installation or upgrade instructions linked below, you’ll need to create a Sensu Enterprise account and obtain your Sensu Enterprise repository credentials via the Sensu Account Manager portal. These credentials are comprised of a username and password which are required to access Sensu Enterprise software packages.

NOTE: manual installation is recommended for pre-production environments only. Please note that this guide is not intended to provide instructions for deploying Sensu Enterprise into production environments. For information about production deployment strategies – including using automation tools like Chef, Puppet, or Ansible to install and configure Sensu – see the Sensu Core installation summary.

Installing Sensu Enterprise and prerequisites on RHEL/CentOS

Sensu Enterprise builds on the same architecture as Sensu Core.

If you’re a new Sensu user getting started with Sensu Enterprise, please complete the following sections of the Sensu installation guide:

  1. Install and Configure Redis
  2. Install and Configure RabbitMQ
  3. Install Sensu Enterprise
  4. Install Sensu Core (to get Sensu Client)

Installing Sensu Enterprise and prerequisites on Ubuntu/Debian

Sensu Enterprise builds on the same architecture as Sensu Core.

If you’re a new Sensu user getting started with Sensu Enterprise, please complete the following sections of the Sensu installation guide:

  1. Install and Configure Redis
  2. Install and Configure RabbitMQ
  3. Install Sensu Enterprise
  4. Install Sensu Core (to get Sensu Client)

Deploying Sensu Enterprise with Docker

Interested in deploying Sensu Enterprise with Docker? Submit a support request through the Sensu account portal to request access to the official Docker image for Sensu Enterprise.

Upgrading from Sensu Core to Sensu Enterprise

For those already running Sensu Core, Sensu Enterprise is designed to be a drop-in replacement for the Sensu Core server and API. Once installed, no configuration changes are required – first terminate the sensu-server and sensu-api processes, then start the sensu-enterprise process to resume operation of your Sensu instance. Some configuration changes may be required to take advantage of built-in integrations or added-value features like contact routing.

RHEL/CentOS

Upgrading from Sensu Core to Sensu Enterprise

If you’re already a Sensu Core user, the following steps will guide you through a manual upgrade to Sensu Enterprise:

  1. Install the sensu-enterprise package as described in Install Sensu Enterprise.

  2. Stop sensu-server and sensu-api services

    sudo service sensu-server stop && sudo service sensu-api stop

  3. Start sensu-enterprise service

    sudo service sensu-enterprise start

  4. Disable sensu-server and sensu-api services to avoid starting them at boot

    sudo chkconfig sensu-server off
    sudo chkconfig sensu-api off

  5. Enable sensu-enterprise to ensure it is started at boot

    sudo chkconfig --add sensu-enterprise

Upgrading from Uchiwa to Sensu Enterprise Dashboard

Sensu Enterprise Dashboard is built on the popular Uchiwa dashboard for Sensu Core, providing advanced features for managing one or more Sensu Enterprise instances.

The process for upgrading from the open source Uchiwa dashboard to Sensu Enterprise Dashboard is similar:

  1. Stop uchiwa service

    sudo service uchiwa stop

  2. Rename /etc/sensu/uchiwa.json to /etc/sensu/dashboard.json

    sudo mv /etc/sensu/uchiwa.json /etc/sensu/dashboard.json

  3. Remove the Uchiwa package from your system

    sudo yum remove uchiwa

  4. Install the sensu-enterprise-dashboard package as described in Install Sensu Enterprise Dashboard.

  5. Start sensu-enterprise-dashboard service

    sudo service sensu-enterprise-dashboard start

  6. Enable sensu-enterprise-dashboard to ensure it is started at boot

    sudo chkconfig --add sensu-enterprise-dashboard

Ubuntu/Debian

Upgrading from Sensu Core to Sensu Enterprise

If you’re already a Sensu Core user, the following steps will guide you through a manual upgrade to Sensu Enterprise:

  1. Install the sensu-enterprise package as described in Install Sensu Enterprise Dashboard.

  2. Stop sensu-server and sensu-api services

    sudo service sensu-server stop && sudo service sensu-api stop

  3. Start sensu-enterprise service

    sudo service sensu-enterprise start

  4. Disable sensu-server and sensu-api services to avoid starting them at boot

    sudo update-rc.d -f sensu-server remove
    sudo update-rc.d -f sensu-api remove

  5. Enable sensu-enterprise to ensure it is started at boot

    sudo update-rc.d sensu-enterprise defaults

Upgrading from Uchiwa to Sensu Enterprise Dashboard

Sensu Enterprise Dashboard is built on the popular Uchiwa dashboard for Sensu Core, providing advanced features for managing one or more Sensu Enterprise instances.

Please follow these steps to manually upgrade from Uchiwa to Sensu Enterprise Dashboard:

  1. Stop uchiwa service

    sudo service uchiwa stop

  2. Rename /etc/sensu/uchiwa.json to /etc/sensu/dashboard.json

    sudo mv /etc/sensu/uchiwa.json /etc/sensu/dashboard.json

  3. Remove the Uchiwa package from your system

    sudo dpkg --remove uchiwa

  4. Install the sensu-enterprise-dashboard package as described in Install Sensu Enterprise.

  5. Start sensu-enterprise-dashboard service

    sudo service sensu-enterprise-dashboard start

  6. Enable sensu-enterprise to ensure it is started at boot

    sudo update-rc.d sensu-enterprise-dashboard defaults

Getting Started with Sensu Enterprise