openstack/vitrage
Code Issues Proposed changes
b977d86a22
vitrage/doc/source/nagios-devstack-installation.rst
csatari c9ea8ea4a1 Aligning install guide with the Pike doc structure 
In Pike OpenStack documentation is changed in a way that the project repos
contain most of the documentation material [1]. This affcects how the doc
folder shall be strucutred inside the project repo. With this change I
align the install guide to the new structure and correct the warnings
during the document generation. The overall work is tracked in [2].

[1]: http://specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration.html
[2]: https://etherpad.openstack.org/p/doc-migration-tracking

Change-Id: Ib5400247d2ba5f8dac80ef68a43d06868bd42f1c
Depends-On: Ia750cb049c0f53a234ea70ce1f2bbbb7a2aa9454
Signed-off-by: csatari <gergely.csatari@nokia.com>
2017-07-03 13:22:52 +02:00

2.8 KiB
Raw Blame History

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 configure a Nagios datasource for Vitrage.

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

Prerequisites

Install devstack with vitrage before install Nagios via OMD due to this issue

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 ubuntu trusty release:

    sudo bash -c "echo 'deb https://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/

  1. Install OMD

    sudo apt-get install omd

  2. Create a site for nagios with a name of your choosing, for example my_site.

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

    You can now access your Nagios site here: http://<devstack_ip>:54321/my_site/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.
  • When using devstack, remember to stop omd apache2's sites

  1. Install the Check_MK agent on devstack VM:

    sudo apt-get install check-mk-agent

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

    sudo service xinetd restart

  3. In your browser, go to http://<devstack_ip>:<selected port>/my_site/omd/ and follow the instructions at this link ("Configuring the first host and checks" section) to configure the nagios host.

  4. Vitrage Support. With Nagios installed, you can now configure a datasource for it for Vitrage, by following the instructions here.