Forge Home

icingaweb2

Icingaweb2 puppet module

9,840 downloads

9,636 latest version

2.5 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 0.0.2 (latest)
  • 0.0.1
released Mar 3rd 2015

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'talamoig-icingaweb2', '0.0.2'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add talamoig-icingaweb2
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install talamoig-icingaweb2 --version 0.0.2

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

talamoig/icingaweb2 — version 0.0.2 Mar 3rd 2015

icingaweb2

Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with icingaweb2
  4. Usage - Configuration options and additional functionality
  5. Reference - An under-the-hood peek at what the module is doing and how
  6. Limitations - OS compatibility, etc.
  7. Development - Guide for contributing to the module

Overview

The icinga web 2 modules allows you to setup an Icinga Web 2 front end.

Module Description

This modules installs [icinga web 2] (http://docs.icinga.org/icinga2/latest/doc/module/icinga2/chapter/getting-started#setting-up-icingaweb2) front end. It requires to access data generated on a database by an Icinga server backend, not provided by this module.

If you need an Icinga backend you can use this module.

Setup

What icingaweb2 affects

  • configuration files and directory (/etc/icingaweb2)
  • apache configuration (installs /etc/httpd/conf.d/icingaweb2.conf)
  • a new yum repository will be installed by default

The yum repository installation can be disabled passing with_repo => False to the icinga class.

  • Can be in list or paragraph form.

Setup Requirements

An Icinga backend server is required, although it does not need to be on the same host, since the communication will happen through the database.

Beginning with icingaweb2

To install Icinga Web 2 with default parameters

 class {'::icingaweb2': }

In the case you are installing Icinga Web 2 on the same host where is the Icinga2 server, one of the two classes will fail since they will conflict on the management of the repository.

In that case you should install Icinga Web 2 with:

class{'::icingaweb2': with_repo => False, }

Furthermore you will tipically adjust database parameters. An icinga web 2 will need access to two databases:

  • the backend database (icinga2), having informations about host checks, services, etc.;
  • the frontend database (icinga2), where user preferences are stored.

The configuration of both the databases can be passed to the class:

 class { '::icingaweb2':
 ## backend database
 dbhost     => 'icinga-db-server',
 dbtype     => 'mysql',
 dbname     => 'icinga',
 dbuser     => 'icinga',
 dbpasswd   => 'icinga',
 dbame      => 'icinga',
 ## frontend database
    dbwebtype   => 'mysql',
    dbwebhost   => 'localhost',
    dbwebport   => '3306',
    dbwebuser   => 'icinga_web',
    dbwebpasswd => 'icinga_web',
    dbwebname   => 'icinga_web',
 ## modules list
    modules     => ['monitoring']
 }

Furthermore the module parameter contains the list of modules to enable. Actually the only available modules are:

  • monitoring
  • setup, for first installation.

Limitations

This module has been tested on Scientific Linux 6 and CentOS 6 with Puppet 3.1.1 and 3.7.4. It should be compatible with any RedHat 6 based distribution.