#Puppet omd Module

####Table of Contents

1. Overview
2. Module Description
3. Setup
   • What omd affects
   • Setup requirements
   • Beginning with omd
4. Usage
5. Limitations
6. TODOs

##Overview

This module installs and configures the Open Monitoring Distirbution on a server. It also installs the corresponding Check_MK agent on client systems.

In the installation (multiple) OMD site(s) can be setup and the client nodes can be exported as monitored hosts. The hosts are gathered in a WATO manageable way.

##Module Description

See Overview for now.

##Setup

###What omd affects

• If enabled, on the OMD server the repository from http://labs.consol.de/ is installed.
• Webserver configuration: In case you are using the puppetlabs-apache module to purge the non-managed configuration, be sure to include the OMD configuration!
• As default the xinetd configuration on the clients is adjusted to allow acces to the check_mk_agent.

###Setup Requirements

For omd::client a specific version of the check_mk_agent must be given, since no generic Packages is downloadable. See the download page of the check_mk_agent. If you add the check_mk_agent package a private repository, you can set this to latest.

###Beginning with omd

Installing the server with a default site:

include omd::server

Installing a client with host export to the default site - into the folder collected_nodes

class { 'omd::client':
  check_mk_version => '1.2.4p5-1',
}

##Usage

Installing server and client see Beginning with omd.

To create additional sites use

omd::site { 'newsite':
  config_hosts_folders => ['important_nodes', 'test_nodes']
}

As default Omd::Site is collecting hosts for all the configured folders!

To export a client as additional host use

omd::host { 'newsite':
  folder => 'important_nodes',
  tags   => ['production', 'important'],
}

This will be collected into the important_nodes folder in the newsite site. It receives two extra tags. This host could be exported to an additional site in an arbitray folder but not to the same site again.

Clusters

For cluster services the nodes in a folder can be put into a cluster - with extra tags specified:

omd::site { 'newsite':
  config_hosts_folders => {
    'important_nodes' => {},
    'clustered_nodes' => {
      'cluster' => true,
      'cluster_tags' => [ 'hacluster', 'web' ],
    },
  },
}

A host has to be defined in the following way, to be actually put into the cluster

omd::host { 'newsite':
  folder         => 'clustered_nodes',
  tags           => ['production', 'important'],
  cluster_member => true,
}

###Remark The best way to create sites and hosts is via the corresponding parameters in omd::server and omd::client!

class { 'omd::server':
  sites => {
    'mysite'    => {},
    'othersite' => {
      'config_hosts_folders' => ['otherfolder'],
    },
  }
}

class { 'omd::client':
  check_mk_version => '1.2.4p5-1',
  hosts            => {
    'mysite'    => {},
    'othersite' => { 'folder' => 'otherfolder' }
  }
}

##Limitations:

Explicitly tested on:

• Debian 7
• CentOS/RHEL 6

Other Debian and RedHat like systems may/should work.

##TODOs:

• ...Suggestions?...

Please open an issue on github if you have any suggestions.