Chapter 3. Installing the Availability Monitoring Suite

Locate a bare metal system that meets the following minimum specifications:

Allow the system to access the Operational Tools packages:

Open the firewall on the system to allow connections to RabbitMQ and Uchiwa:

# firewall-cmd --zone=public --add-port=5672/tcp --permanent
# firewall-cmd --zone=public --add-port=3000/tcp --permanent
# firewall-cmd --reload

Install the components needed for the monitoring server:

# yum install sensu uchiwa redis rabbitmq-server

Configure RabbitMQ and Redis, which are the backbone services. Start both Redis and RabbitMQ and enable them at boot:

# systemctl start redis
# systemctl enable redis
# systemctl start rabbitmq-server
# systemctl enable rabbitmq-server

Configure a new RabbitMQ virtual host for sensu, with a user name and password combination that can access the host:

# rabbitmqctl add_vhost /sensu
# rabbitmqctl add_user sensu sensu
# rabbitmqctl set_permissions -p /sensu sensu ".*" ".*" ".*"

Now that the base services are running and configured, configure the Sensu monitoring server. Create /etc/sensu/conf.d/rabbitmq.json with the following contents:

{
  "rabbitmq": {
    "port": 5672,
    "host": "localhost",
    "user": "sensu",
    "password": "sensu",
    "vhost": "/sensu"
  }
}

Next, create /etc/sensu/conf.d/redis.json with the following contents:

{
  "redis": {
    "port": 6379,
    "host": "localhost"
  }
}

Finally, create /etc/sensu/conf.d/api.json with the following contents:

{
  "api": {
    "bind": "0.0.0.0",
    "port": 4567,
    "host": "localhost"
  }
}

Start and enable all Sensu services:

# systemctl start sensu-server
# systemctl enable sensu-server
# systemctl start sensu-api
# systemctl enable sensu-api

Configure Uchiwa, which is the web interface for Sensu. To do this, edit /etc/uchiwa/uchiwa.json and replace its default contents with the following:

{
  "sensu": [
    {
      "name": "Openstack",
      "host": "localhost",
      "port": 4567
    }
  ],
  "uchiwa": {
    "host": "0.0.0.0",
    "port": 3000,
    "refresh": 5
  }
}

Start and enable the Uchiwa web interface:

# systemctl start uchiwa
# systemctl enable uchiwa

Enable the Operational Tools repository:

# subscription-manager repos --enable=rhel-7-server-openstack-8-optools-rpms

Install Sensu:

# yum install sensu

Configure the Sensu agent. Edit /etc/sensu/conf.d/rabbitmq.json to have the following content; remember to replace MONITORING_SERVER with the host name or IP address of your monitoring server configured in the previous section:

{
  "rabbitmq": {
    "port": 5672,
    "host": "MONITORING_SERVER",
    "user": "sensu",
    "password": "sensu",
    "vhost": "/sensu"
  }
}

Edit /etc/sensu/conf.d/client.json to include the following content; remember to replace FQDN with the host name of the machine, and ADDRESS with the public IP address of the machine:

{
  "client": {
    "name": "FQDN",
    "address": "ADDRESS",
    "subscriptions": [ "all" ]
  }
}

Finally, start and enable the Sensu client:

# systemctl start sensu-client
# systemctl enable sensu-client