vitrage/doc/source/nagios-devstack-installation.rst

Nagios-for-Devstack Configuration Guide

Overview

This page describes how to manually install and configure Nagios on devstack. After following the steps described here, Nagios will be installed via the OMD package (http://omdistro.org/) and will have a basic set of tests for monitoring the Devstack VM. It will then be possible to sync Nagios into Vitrage.

The following guide is for Ubuntu. With slight modifications should work for other linux flavours. Links for this purpose are added below.

Installation

1. Update your repo to include the OMD key: :

   wget -q "https://labs.consol.de/repo/stable/RPM-GPG-KEY" -O - | sudo apt-key add -

2. Update your repo with the OMD site. For example, for wheezy release: :

   sudo bash -c "echo 'deb http://labs.consol.de/repo/stable/ubuntu trusty main' >> /etc/apt/sources.list"
   sudo apt-get update

For additional distros, see https://labs.consol.de/repo/stable/

3. Install OMD :

   sudo apt-get install omd

4. Create a site for nagios with a name of your choosing, for example "my_host". :

   sudo omd create my_host
   sudo omd config my_host set APACHE_TCP_PORT 54321
   sudo omd config my_host set APACHE_TCP_ADDR 0.0.0.0
   sudo omd start  my_host

   You can now access your Nagios site here: http://<devstack_ip>:54321/my_host/omd. :

   username: omdadmin
   password: omd

Notes:

• The default port is OMD uses is 5000, which is also used by OpenStack Keystone, and so it must be changed. Port 54321 used here is only an example.
• APACHE_TCP_ADDR indicates the address to listen on. Use 0.0.0.0 to listen for all traffic addressed to the specified port. Use a different address to listen on a specific (public) address.

5. Install the Check_MK client on devstack VM: :

   sudo apt-get install check-mk-agent

6. Activate the agent, by editing /etc/xinetd.d/check_mk and setting "disable" to "no", and then run :

   sudo service xinetd restart

7. In your browser, go to http://<devstack_ip>:<selected port>/my_host/omd and follow the instructions at this link to configure the nagios host.

8. Vitrage Support. With Nagios installed, you can now sync it into Vitrage. follow the instructions here.