Merge branch 'jenkins' into 'master'

Jenkins See merge request !58
2017-07-27 12:38:37 +02:00
parent 6d09beb8f9 2b24ed6918
commit 78b0b5ec9a
39 changed files with 723 additions and 55 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,6 +8,16 @@ Changelog of Git Changelog.
 <h2> No issue </h2>


+<a href="https://gitlab.puppetsoft.com/12WW1160/git-changelog-lib/commit/0564cc970be1899">0564cc970be1899</a> Jenkins Server <i>2017-07-26 14:27:43</i>
+<p>
+<h3>recommit for updates in build 105</h3>
+
+</p>
+<a href="https://gitlab.puppetsoft.com/12WW1160/git-changelog-lib/commit/12f835aa4ff29bd">12f835aa4ff29bd</a> Arne Teuke <i>2017-07-26 14:27:16</i>
+<p>
+<h3>added and linked base contactgroups</h3>
+
+</p>
 <a href="https://gitlab.puppetsoft.com/12WW1160/git-changelog-lib/commit/af34a0587d9f48e">af34a0587d9f48e</a> Jenkins Server <i>2017-07-26 13:05:02</i>
 <p>
 <h3>recommit for updates in build 104</h3>
--- a/REPOSTRUCTURE.md
+++ b/REPOSTRUCTURE.md
@@ -20,6 +20,7 @@
 |   |   |-- cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Aadd_contact_rules.html
 |   |   |-- cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Acommands.html
 |   |   |-- cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Aconfig.html
+|   |   |-- cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Acontactgroups.html
 |   |   |-- cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Acontacts.html
 |   |   |-- cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Atemplate_rules.html
 |   |   |-- cd_nagios_3A_3Aparams.html
@@ -53,6 +54,8 @@
 |   |   `-- user.pp
 |   |-- nagios
 |   |   `-- objects
+|   |       |-- add_contactgroups.pp
+|   |       |-- add_contactgroups_rules.pp
 |   |       |-- add_contact.pp
 |   |       |-- add_contact_rules.pp
 |   |       |-- commands.pp
@@ -81,7 +84,9 @@
 |   |   `-- nagios_ssl_vhost.erb
 |   |-- nagios
 |   |   |-- cgi_cfg.erb
-|   |   |-- contacts_cfg.erb
+|   |   |-- contactgroups_cfg_head.erb
+|   |   |-- contactgroups_cfg_rule.erb
+|   |   |-- contacts.cfg
 |   |   |-- contacts_cfg_head.erb
 |   |   |-- contacts_cfg_rule.erb
 |   |   |-- htpasswd_rule.erb
@@ -101,4 +106,4 @@
 |-- README.md
 `-- REPOSTRUCTURE.md

-20 directories, 81 files
+20 directories, 86 files
--- a/doc/_index.html
+++ b/doc/_index.html
@@ -113,6 +113,11 @@
      
            </li>
    
+            <li>
+      <span class='object_link'><a href="puppet_classes/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Aadd_contactgroups_rules.html" title="puppet_classes::cd_nagios::nagios::objects::add_contactgroups_rules (puppet_class)">cd_nagios::nagios::objects::add_contactgroups_rules</a></span>
+      
+            </li>
+    
            <li>
      <span class='object_link'><a href="puppet_classes/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Acommands.html" title="puppet_classes::cd_nagios::nagios::objects::commands (puppet_class)">cd_nagios::nagios::objects::commands</a></span>
      
@@ -188,6 +193,11 @@
      
            </li>
    
+            <li>
+      <span class='object_link'><a href="puppet_defined_types/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Aadd_contactgroups.html" title="puppet_defined_types::cd_nagios::nagios::objects::add_contactgroups (puppet_defined_type)">cd_nagios::nagios::objects::add_contactgroups</a></span>
+      
+            </li>
+    
            <li>
      <span class='object_link'><a href="puppet_defined_types/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Atemplates.html" title="puppet_defined_types::cd_nagios::nagios::objects::templates (puppet_defined_type)">cd_nagios::nagios::objects::templates</a></span>
      
@@ -226,7 +236,7 @@
 </div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:33 2017 by
+  Generated on Thu Jul 27 12:41:38 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/file.README.html
+++ b/doc/file.README.html
@@ -352,7 +352,7 @@ environments.</p>
 </div></div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:34 2017 by
+  Generated on Thu Jul 27 12:41:39 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/index.html
+++ b/doc/index.html
@@ -352,7 +352,7 @@ environments.</p>
 </div></div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:34 2017 by
+  Generated on Thu Jul 27 12:41:38 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/puppet_class_list.html
+++ b/doc/puppet_class_list.html
@@ -103,70 +103,77 @@
    </li>
    

-    <li id="object_puppet_classes::cd_nagios::nagios::objects::commands" class="even">
+    <li id="object_puppet_classes::cd_nagios::nagios::objects::add_contactgroups_rules" class="even">
+      <div class="item">
+        <span class='object_link'><a href="puppet_classes/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Aadd_contactgroups_rules.html" title="puppet_classes::cd_nagios::nagios::objects::add_contactgroups_rules (puppet_class)">cd_nagios::nagios::objects::add_contactgroups_rules</a></span>
+      </div>
+    </li>
+    
+
+    <li id="object_puppet_classes::cd_nagios::nagios::objects::commands" class="odd">
      <div class="item">
        <span class='object_link'><a href="puppet_classes/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Acommands.html" title="puppet_classes::cd_nagios::nagios::objects::commands (puppet_class)">cd_nagios::nagios::objects::commands</a></span>
      </div>
    </li>
    

-    <li id="object_puppet_classes::cd_nagios::nagios::objects::config" class="odd">
+    <li id="object_puppet_classes::cd_nagios::nagios::objects::config" class="even">
      <div class="item">
        <span class='object_link'><a href="puppet_classes/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Aconfig.html" title="puppet_classes::cd_nagios::nagios::objects::config (puppet_class)">cd_nagios::nagios::objects::config</a></span>
      </div>
    </li>
    

-    <li id="object_puppet_classes::cd_nagios::nagios::objects::contactgroups" class="even">
+    <li id="object_puppet_classes::cd_nagios::nagios::objects::contactgroups" class="odd">
      <div class="item">
        <span class='object_link'><a href="puppet_classes/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Acontactgroups.html" title="puppet_classes::cd_nagios::nagios::objects::contactgroups (puppet_class)">cd_nagios::nagios::objects::contactgroups</a></span>
      </div>
    </li>
    

-    <li id="object_puppet_classes::cd_nagios::nagios::objects::contacts" class="odd">
+    <li id="object_puppet_classes::cd_nagios::nagios::objects::contacts" class="even">
      <div class="item">
        <span class='object_link'><a href="puppet_classes/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Acontacts.html" title="puppet_classes::cd_nagios::nagios::objects::contacts (puppet_class)">cd_nagios::nagios::objects::contacts</a></span>
      </div>
    </li>
    

-    <li id="object_puppet_classes::cd_nagios::nagios::objects::template_rules" class="even">
+    <li id="object_puppet_classes::cd_nagios::nagios::objects::template_rules" class="odd">
      <div class="item">
        <span class='object_link'><a href="puppet_classes/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Atemplate_rules.html" title="puppet_classes::cd_nagios::nagios::objects::template_rules (puppet_class)">cd_nagios::nagios::objects::template_rules</a></span>
      </div>
    </li>
    

-    <li id="object_puppet_classes::cd_nagios::params" class="odd">
+    <li id="object_puppet_classes::cd_nagios::params" class="even">
      <div class="item">
        <span class='object_link'><a href="puppet_classes/cd_nagios_3A_3Aparams.html" title="puppet_classes::cd_nagios::params (puppet_class)">cd_nagios::params</a></span>
      </div>
    </li>
    

-    <li id="object_puppet_classes::cd_nagios::selinux::config" class="even">
+    <li id="object_puppet_classes::cd_nagios::selinux::config" class="odd">
      <div class="item">
        <span class='object_link'><a href="puppet_classes/cd_nagios_3A_3Aselinux_3A_3Aconfig.html" title="puppet_classes::cd_nagios::selinux::config (puppet_class)">cd_nagios::selinux::config</a></span>
      </div>
    </li>
    

-    <li id="object_puppet_classes::cd_nagios::server::access_rules" class="odd">
+    <li id="object_puppet_classes::cd_nagios::server::access_rules" class="even">
      <div class="item">
        <span class='object_link'><a href="puppet_classes/cd_nagios_3A_3Aserver_3A_3Aaccess_rules.html" title="puppet_classes::cd_nagios::server::access_rules (puppet_class)">cd_nagios::server::access_rules</a></span>
      </div>
    </li>
    

-    <li id="object_puppet_classes::cd_nagios::server::files" class="even">
+    <li id="object_puppet_classes::cd_nagios::server::files" class="odd">
      <div class="item">
        <span class='object_link'><a href="puppet_classes/cd_nagios_3A_3Aserver_3A_3Afiles.html" title="puppet_classes::cd_nagios::server::files (puppet_class)">cd_nagios::server::files</a></span>
      </div>
    </li>
    

-    <li id="object_puppet_classes::cd_nagios::server::service" class="odd">
+    <li id="object_puppet_classes::cd_nagios::server::service" class="even">
      <div class="item">
        <span class='object_link'><a href="puppet_classes/cd_nagios_3A_3Aserver_3A_3Aservice.html" title="puppet_classes::cd_nagios::server::service (puppet_class)">cd_nagios::server::service</a></span>
      </div>
--- a/doc/puppet_classes/cd_nagios.html
+++ b/doc/puppet_classes/cd_nagios.html
@@ -139,7 +139,7 @@ class cd_nagios {
 </div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:35 2017 by
+  Generated on Thu Jul 27 12:41:39 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/puppet_classes/cd_nagios_3A_3Acertbot_3A_3Acerts.html
+++ b/doc/puppet_classes/cd_nagios_3A_3Acertbot_3A_3Acerts.html
@@ -230,7 +230,7 @@ class cd_nagios::certbot::certs (
 </div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:39 2017 by
+  Generated on Thu Jul 27 12:41:43 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/puppet_classes/cd_nagios_3A_3Aclient_3A_3Atarget.html
+++ b/doc/puppet_classes/cd_nagios_3A_3Aclient_3A_3Atarget.html
@@ -368,7 +368,7 @@ class cd_nagios::client::target (
 </div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:39 2017 by
+  Generated on Thu Jul 27 12:41:43 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/puppet_classes/cd_nagios_3A_3Afirewall_3A_3Aiptables.html
+++ b/doc/puppet_classes/cd_nagios_3A_3Afirewall_3A_3Aiptables.html
@@ -207,7 +207,7 @@ class cd_nagios::firewall::iptables (
 </div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:39 2017 by
+  Generated on Thu Jul 27 12:41:43 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/puppet_classes/cd_nagios_3A_3Amain_3A_3Aconfig.html
+++ b/doc/puppet_classes/cd_nagios_3A_3Amain_3A_3Aconfig.html
@@ -195,7 +195,7 @@ class cd_nagios::main::config (
 </div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:39 2017 by
+  Generated on Thu Jul 27 12:41:43 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/puppet_classes/cd_nagios_3A_3Amain_3A_3Adirs.html
+++ b/doc/puppet_classes/cd_nagios_3A_3Amain_3A_3Adirs.html
@@ -468,7 +468,7 @@ class cd_nagios::main::dirs (
 </div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:38 2017 by
+  Generated on Thu Jul 27 12:41:43 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/puppet_classes/cd_nagios_3A_3Amain_3A_3Ainstall.html
+++ b/doc/puppet_classes/cd_nagios_3A_3Amain_3A_3Ainstall.html
@@ -235,7 +235,7 @@ class cd_nagios::main::install (
 </div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:39 2017 by
+  Generated on Thu Jul 27 12:41:43 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/puppet_classes/cd_nagios_3A_3Amain_3A_3Auser.html
+++ b/doc/puppet_classes/cd_nagios_3A_3Amain_3A_3Auser.html
@@ -200,7 +200,7 @@ class cd_nagios::main::user (
 </div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:38 2017 by
+  Generated on Thu Jul 27 12:41:43 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/puppet_classes/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Aadd_contact_rules.html
+++ b/doc/puppet_classes/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Aadd_contact_rules.html
@@ -210,7 +210,7 @@ class cd_nagios::nagios::objects::add_contact_rules (
 </div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:40 2017 by
+  Generated on Thu Jul 27 12:41:44 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/puppet_classes/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Aadd_contactgroups_rules.html
+++ b/doc/puppet_classes/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Aadd_contactgroups_rules.html
@@ -0,0 +1,237 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>
+  Puppet Class: cd_nagios::nagios::objects::add_contactgroups_rules
+  
+    &mdash; Documentation by YARD 0.9.9
+  
+</title>
+
+  <link rel="stylesheet" href="../css/style.css" type="text/css" charset="utf-8" />
+
+  <link rel="stylesheet" href="../css/common.css" type="text/css" charset="utf-8" />
+
+<script type="text/javascript" charset="utf-8">
+  pathId = "puppet_classes::cd_nagios::nagios::objects::add_contactgroups_rules";
+  relpath = '../';
+</script>
+
+
+  <script type="text/javascript" charset="utf-8" src="../js/jquery.js"></script>
+
+  <script type="text/javascript" charset="utf-8" src="../js/app.js"></script>
+
+
+  </head>
+  <body>
+    <div class="nav_wrap">
+      <iframe id="nav" src="../puppet_class_list.html?1"></iframe>
+      <div id="resizer"></div>
+    </div>
+
+    <div id="main" tabindex="-1">
+      <div id="header">
+        <div id="menu">
+  
+    <a href="../_index.html">Index (c)</a> &raquo;
+    <span class='title'><span class='object_link'>Puppet Classes</span></span>
+     &raquo; 
+    <span class="title">cd_nagios::nagios::objects::add_contactgroups_rules</span>
+  
+</div>
+
+        <div id="search">
+  
+    <a class="full_list_link" id="puppet_class_list_link"
+        href="../puppet_class_list.html">
+
+        <svg width="24" height="24">
+          <rect x="0" y="4" width="24" height="4" rx="1" ry="1"></rect>
+          <rect x="0" y="12" width="24" height="4" rx="1" ry="1"></rect>
+          <rect x="0" y="20" width="24" height="4" rx="1" ry="1"></rect>
+        </svg>
+    </a>
+  
+</div>
+        <div class="clear"></div>
+      </div>
+
+      <div id="content"><h1>Puppet Class: cd_nagios::nagios::objects::add_contactgroups_rules</h1>
+<div class="box_info">
+  
+  <dl>
+    <dt>Inherits:</dt>
+    <dd><span class='object_link'><a href="cd_nagios_3A_3Aparams.html" title="puppet_classes::cd_nagios::params (puppet_class)">cd_nagios::params</a></span></dd>
+  </dl>
+  
+  
+  <dl>
+    <dt>Defined in:</dt>
+    <dd>
+      manifests/nagios/objects/add_contactgroups_rules.pp
+    </dd>
+  </dl>
+</div>
+
+  <h2>Summary</h2>
+  Class manages /etc/nagios/conf.d/nagios_add_contactgroups.cfg file
+and populates through define and external puppet rules
+
+<h2>Overview</h2>
+<div class="docstring">
+  <div class="discussion">
+    
+<p>cd_nagios::nagios::objects::add_contactgroups_rules.pp
+Module name:
+cd_nagios
+Author: Arne Teuke (arne_teuke@ConfDroid.com)</p>
+
+<h1 id="label-License%3A">License:</h1>
+
+<p>This file is part of cd_nagios.</p>
+
+<p>cd_nagios is used for providing automatic configuration of Nagios
+
+Copyright (C) 2016 ConfDroid (copyright@ConfDroid.com)
+ This program is
+free software: you can redistribute it and/or modify
+ it under the terms of
+the GNU General Public License as published by
+ the Free Software
+Foundation, either version 3 of the License, or
+ (at your option) any later
+version.</p>
+
+<p>This program is distributed in the hope that it will be useful,
+ but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License
+for more details.</p>
+
+<p>You should have received a copy of the GNU General Public License
+ along
+with this program. If not, see <a
+href="http://www.gnu.org/licenses">www.gnu.org/licenses</a>/.</p>
+
+  </div>
+</div>
+<div class="tags">
+  
+  <div class="examples">
+    <p class="tag_title">Examples:</p>
+    
+      
+      <pre class="example code"><code>cd_nagios::nagios::objects::add_contactgroups { &#39;example_group&#39;:
+  ng_contactgroup_name      =&gt;  &#39;example_group&#39;,
+  ng_contactgroup_alias     =&gt;  &#39;Example Group&#39;,
+  ng_contactgroup_register  =&gt;  &#39;1&#39;,
+}</code></pre>
+    
+  </div>
+
+
+</div><div class="method_details_list">
+  <table class="source_code">
+    <tr>
+      <td>
+        <pre class="lines">
+
+
+30
+31
+32
+33
+34
+35
+36
+37
+38
+39
+40
+41
+42
+43
+44
+45
+46
+47
+48
+49
+50
+51
+52
+53
+54
+55
+56
+57
+58
+59
+60
+61
+62
+63
+64
+65
+66</pre>
+      </td>
+      <td>
+        <pre class="code"><span class="info file"># File 'manifests/nagios/objects/add_contactgroups_rules.pp', line 30</span>
+
+class cd_nagios::nagios::objects::add_contactgroups_rules (
+
+
+) inherits cd_nagios::params {
+
+  if $::fqdn == $ng_nagios_server {
+
+    # manage /etc/nagios/conf.d/nagios_add_contactgroups.cfg
+
+    concat { $ng_tgt_contactgroup_add:
+      ensure    =&gt;  present,
+      path      =&gt;  $ng_tgt_contactgroup_add,
+      owner     =&gt;  $ng_user,
+      group     =&gt;  $ng_user,
+      mode      =&gt;  &#39;0640&#39;,
+      selrange  =&gt;  s0,
+      selrole   =&gt;  object_r,
+      seltype   =&gt;  nagios_etc_t,
+      seluser   =&gt;  system_u,
+      notify    =&gt;  Service[$ng_service],
+    }
+
+    # manage file header
+
+    concat::fragment { &#39;contactgroups_header&#39;:
+      target    =&gt;  $ng_tgt_contactgroup_add,
+      content   =&gt;  template($ng_cntctgrps_head_erb),
+      order     =&gt;  &#39;000&#39;,
+    }
+
+    cd_nagios::nagios::objects::add_contactgroups { &#39;example_group&#39;:
+      ng_contactgroup_name      =&gt;  &#39;example_group&#39;,
+      ng_contactgroup_alias     =&gt;  &#39;Example Group&#39;,
+      ng_contactgroup_register  =&gt;  &#39;1&#39;,
+    }
+  }
+}</pre>
+      </td>
+    </tr>
+  </table>
+</div>
+</div>
+
+      <div id="footer">
+  Generated on Thu Jul 27 12:41:44 2017 by
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.9.9 (ruby-2.0.0).
+</div>
+
+    </div>
+  </body>
+</html>
--- a/doc/puppet_classes/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Acommands.html
+++ b/doc/puppet_classes/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Acommands.html
@@ -595,7 +595,7 @@ class cd_nagios::nagios::objects::commands (
 </div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:39 2017 by
+  Generated on Thu Jul 27 12:41:44 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/puppet_classes/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Aconfig.html
+++ b/doc/puppet_classes/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Aconfig.html
@@ -168,7 +168,7 @@ class cd_nagios::nagios::objects::config (
 </div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:39 2017 by
+  Generated on Thu Jul 27 12:41:44 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/puppet_classes/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Acontactgroups.html
+++ b/doc/puppet_classes/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Acontactgroups.html
@@ -76,6 +76,9 @@
  </dl>
 </div>

+  <h2>Summary</h2>
+  Class manages base contactgroups which always should be there.
+
 <h2>Overview</h2>
 <div class="docstring">
  <div class="discussion">
@@ -118,6 +121,23 @@ href="http://www.gnu.org/licenses">www.gnu.org/licenses</a>/</p>
 </div>
 <div class="tags">
  
+  <div class="examples">
+    <p class="tag_title">Examples:</p>
+    
+      
+      <pre class="example code"><code>@@nagios_contactgroup { &#39;admins&#39;:
+  ensure              =&gt;  present,
+  alias               =&gt;  &#39;Nagios Administrators&#39;,
+  contactgroup_name   =&gt;  &#39;admins&#39;,
+  owner               =&gt;  $ng_user,
+  group               =&gt;  $ng_user,
+  mode                =&gt;  &#39;0640&#39;,
+  register            =&gt;  &#39;1&#39;,
+  target              =&gt;  $ng_tgt_contactgroup_base,
+}</code></pre>
+    
+  </div>
+

 </div><div class="method_details_list">
  <table class="source_code">
@@ -126,18 +146,6 @@ href="http://www.gnu.org/licenses">www.gnu.org/licenses</a>/</p>
        <pre class="lines">


-22
-23
-24
-25
-26
-27
-28
-29
-30
-31
-32
-33
 34
 35
 36
@@ -165,10 +173,22 @@ href="http://www.gnu.org/licenses">www.gnu.org/licenses</a>/</p>
 58
 59
 60
-61</pre>
+61
+62
+63
+64
+65
+66
+67
+68
+69
+70
+71
+72
+73</pre>
      </td>
      <td>
-        <pre class="code"><span class="info file"># File 'manifests/nagios/objects/contactgroups.pp', line 22</span>
+        <pre class="code"><span class="info file"># File 'manifests/nagios/objects/contactgroups.pp', line 34</span>

 class cd_nagios::nagios::objects::contactgroups (

@@ -217,7 +237,7 @@ class cd_nagios::nagios::objects::contactgroups (
 </div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:40 2017 by
+  Generated on Thu Jul 27 12:41:44 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/puppet_classes/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Acontacts.html
+++ b/doc/puppet_classes/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Acontacts.html
@@ -280,7 +280,7 @@ class cd_nagios::nagios::objects::contacts (
 </div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:40 2017 by
+  Generated on Thu Jul 27 12:41:44 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/puppet_classes/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Atemplate_rules.html
+++ b/doc/puppet_classes/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Atemplate_rules.html
@@ -305,7 +305,7 @@ class cd_nagios::nagios::objects::template_rules (
 </div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:40 2017 by
+  Generated on Thu Jul 27 12:41:44 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/puppet_classes/cd_nagios_3A_3Aparams.html
+++ b/doc/puppet_classes/cd_nagios_3A_3Aparams.html
@@ -101,6 +101,8 @@
      
      <span class='object_link'><a href="cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Aadd_contact_rules.html" title="puppet_classes::cd_nagios::nagios::objects::add_contact_rules (puppet_class)">cd_nagios::nagios::objects::add_contact_rules</a></span><br/>
      
+      <span class='object_link'><a href="cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Aadd_contactgroups_rules.html" title="puppet_classes::cd_nagios::nagios::objects::add_contactgroups_rules (puppet_class)">cd_nagios::nagios::objects::add_contactgroups_rules</a></span><br/>
+      
    </dd>
  </dl>
  
@@ -5218,7 +5220,10 @@ up</p>
 983
 984
 985
-986</pre>
+986
+987
+988
+989</pre>
      </td>
      <td>
        <pre class="code"><span class="info file"># File 'manifests/params.pp', line 646</span>
@@ -5556,6 +5561,9 @@ $ng_target_add_contact    = &quot;${ng_conf_d_dir}/nagios_add_contact.cfg&quot;
 $ng_contacts_head_erb     = &#39;cd_nagios/nagios/contacts_cfg_head.erb&#39;
 $ng_contacts_rule_erb     = &#39;cd_nagios/nagios/contacts_cfg_rule.erb&#39;
 $ng_tgt_contactgroup_base = &quot;${ng_conf_d_dir}/nagios_contactgroup_base.cfg&quot;
+$ng_tgt_contactgroup_add  = &quot;${ng_conf_d_dir}/nagios_contactgroup_add.cfg&quot;
+$ng_cntctgrps_head_erb    = &#39;cd_nagios/nagios/contactgroups_cfg_head.erb&#39;
+$ng_cntctgrps_rule_erb    = &#39;cd_nagios/nagios/contactgroups_cfg_rule.erb&#39;
 $ng_target_command        = &quot;${ng_conf_d_dir}/nagios_command.cfg&quot;


@@ -5571,7 +5579,7 @@ $ng_target_command        = &quot;${ng_conf_d_dir}/nagios_command.cfg&quot;
 </div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:38 2017 by
+  Generated on Thu Jul 27 12:41:43 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/puppet_classes/cd_nagios_3A_3Aselinux_3A_3Aconfig.html
+++ b/doc/puppet_classes/cd_nagios_3A_3Aselinux_3A_3Aconfig.html
@@ -249,7 +249,7 @@ class cd_nagios::selinux::config (
 </div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:39 2017 by
+  Generated on Thu Jul 27 12:41:43 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/puppet_classes/cd_nagios_3A_3Aserver_3A_3Aaccess_rules.html
+++ b/doc/puppet_classes/cd_nagios_3A_3Aserver_3A_3Aaccess_rules.html
@@ -195,7 +195,7 @@ class cd_nagios::server::access_rules (
 </div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:39 2017 by
+  Generated on Thu Jul 27 12:41:44 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/puppet_classes/cd_nagios_3A_3Aserver_3A_3Afiles.html
+++ b/doc/puppet_classes/cd_nagios_3A_3Aserver_3A_3Afiles.html
@@ -334,7 +334,7 @@ class cd_nagios::server::files (
 </div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:39 2017 by
+  Generated on Thu Jul 27 12:41:43 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/puppet_classes/cd_nagios_3A_3Aserver_3A_3Aservice.html
+++ b/doc/puppet_classes/cd_nagios_3A_3Aserver_3A_3Aservice.html
@@ -268,7 +268,7 @@ class cd_nagios::server::service (
 </div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:39 2017 by
+  Generated on Thu Jul 27 12:41:43 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/puppet_defined_type_list.html
+++ b/doc/puppet_defined_type_list.html
@@ -47,14 +47,21 @@
    </li>
    

-    <li id="object_puppet_defined_types::cd_nagios::nagios::objects::templates" class="even">
+    <li id="object_puppet_defined_types::cd_nagios::nagios::objects::add_contactgroups" class="even">
+      <div class="item">
+        <span class='object_link'><a href="puppet_defined_types/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Aadd_contactgroups.html" title="puppet_defined_types::cd_nagios::nagios::objects::add_contactgroups (puppet_defined_type)">cd_nagios::nagios::objects::add_contactgroups</a></span>
+      </div>
+    </li>
+    
+
+    <li id="object_puppet_defined_types::cd_nagios::nagios::objects::templates" class="odd">
      <div class="item">
        <span class='object_link'><a href="puppet_defined_types/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Atemplates.html" title="puppet_defined_types::cd_nagios::nagios::objects::templates (puppet_defined_type)">cd_nagios::nagios::objects::templates</a></span>
      </div>
    </li>
    

-    <li id="object_puppet_defined_types::cd_nagios::server::access" class="odd">
+    <li id="object_puppet_defined_types::cd_nagios::server::access" class="even">
      <div class="item">
        <span class='object_link'><a href="puppet_defined_types/cd_nagios_3A_3Aserver_3A_3Aaccess.html" title="puppet_defined_types::cd_nagios::server::access (puppet_defined_type)">cd_nagios::server::access</a></span>
      </div>
--- a/doc/puppet_defined_types/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Aadd_contact.html
+++ b/doc/puppet_defined_types/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Aadd_contact.html
@@ -247,7 +247,7 @@ $ng_contacts_rule_erb   = $::cd_nagios::params::ng_contacts_rule_erb
 </div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:41 2017 by
+  Generated on Thu Jul 27 12:41:45 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/puppet_defined_types/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Aadd_contactgroups.html
+++ b/doc/puppet_defined_types/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Aadd_contactgroups.html
@@ -0,0 +1,227 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>
+  Defined Type: cd_nagios::nagios::objects::add_contactgroups
+  
+    &mdash; Documentation by YARD 0.9.9
+  
+</title>
+
+  <link rel="stylesheet" href="../css/style.css" type="text/css" charset="utf-8" />
+
+  <link rel="stylesheet" href="../css/common.css" type="text/css" charset="utf-8" />
+
+<script type="text/javascript" charset="utf-8">
+  pathId = "puppet_defined_types::cd_nagios::nagios::objects::add_contactgroups";
+  relpath = '../';
+</script>
+
+
+  <script type="text/javascript" charset="utf-8" src="../js/jquery.js"></script>
+
+  <script type="text/javascript" charset="utf-8" src="../js/app.js"></script>
+
+
+  </head>
+  <body>
+    <div class="nav_wrap">
+      <iframe id="nav" src="../puppet_defined_type_list.html?1"></iframe>
+      <div id="resizer"></div>
+    </div>
+
+    <div id="main" tabindex="-1">
+      <div id="header">
+        <div id="menu">
+  
+    <a href="../_index.html">Index (c)</a> &raquo;
+    <span class='title'><span class='object_link'>Defined Types</span></span>
+     &raquo; 
+    <span class="title">cd_nagios::nagios::objects::add_contactgroups</span>
+  
+</div>
+
+        <div id="search">
+  
+    <a class="full_list_link" id="puppet_class_list_link"
+        href="../puppet_class_list.html">
+
+        <svg width="24" height="24">
+          <rect x="0" y="4" width="24" height="4" rx="1" ry="1"></rect>
+          <rect x="0" y="12" width="24" height="4" rx="1" ry="1"></rect>
+          <rect x="0" y="20" width="24" height="4" rx="1" ry="1"></rect>
+        </svg>
+    </a>
+  
+</div>
+        <div class="clear"></div>
+      </div>
+
+      <div id="content"><h1>Defined Type: cd_nagios::nagios::objects::add_contactgroups</h1>
+<div class="box_info">
+  <dl>
+    <dt>Defined in:</dt>
+    <dd>
+      manifests/nagios/objects/add_contactgroups.pp
+    </dd>
+  </dl>
+</div>
+
+  <h2>Summary</h2>
+  Define populates /etc/nagios/conf.d/nagios_add_contactgroups through
+external puppet rules.
+
+<h2>Overview</h2>
+<div class="docstring">
+  <div class="discussion">
+    
+<p>cd_nagios::nagios::objects::add_contactgroups.pp
+Module name:
+cd_nagios
+Author: Arne Teuke (arne_teuke@ConfDroid.com)</p>
+
+<h1 id="label-License%3A">License:</h1>
+
+<p>This file is part of cd_nagios.</p>
+
+<p>cd_nagios is used for providing automatic configuration of Nagios
+
+Copyright (C) 2016 ConfDroid (copyright@ConfDroid.com)
+ This program is
+free software: you can redistribute it and/or modify
+ it under the terms of
+the GNU General Public License as published by
+ the Free Software
+Foundation, either version 3 of the License, or
+ (at your option) any later
+version.</p>
+
+<p>This program is distributed in the hope that it will be useful,
+ but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License
+for more details.</p>
+
+<p>You should have received a copy of the GNU General Public License
+ along
+with this program. If not, see <a
+href="http://www.gnu.org/licenses">www.gnu.org/licenses</a>/</p>
+
+  </div>
+</div>
+<div class="tags">
+  <p class="tag_title">Parameters:</p>
+<ul class="param">
+  
+    <li>
+      
+        <span class='name'>ng_contactgroup_name</span>
+      
+      
+        <span class='type'>(<tt>Any</tt>)</span>
+      
+      
+        <em class="default">(defaults to: <tt>undef</tt>)</em>
+      
+      
+    </li>
+  
+    <li>
+      
+        <span class='name'>ng_contactgroup_alias</span>
+      
+      
+        <span class='type'>(<tt>Any</tt>)</span>
+      
+      
+        <em class="default">(defaults to: <tt>undef</tt>)</em>
+      
+      
+    </li>
+  
+    <li>
+      
+        <span class='name'>ng_contactgroup_register</span>
+      
+      
+        <span class='type'>(<tt>Any</tt>)</span>
+      
+      
+        <em class="default">(defaults to: <tt>&#39;1&#39;</tt>)</em>
+      
+      
+    </li>
+  
+</ul>
+
+
+</div><div class="method_details_list">
+  <table class="source_code">
+    <tr>
+      <td>
+        <pre class="lines">
+
+
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34
+35
+36
+37
+38
+39
+40
+41
+42
+43</pre>
+      </td>
+      <td>
+        <pre class="code"><span class="info file"># File 'manifests/nagios/objects/add_contactgroups.pp', line 24</span>
+
+define cd_nagios::nagios::objects::add_contactgroups (
+
+$ng_contactgroup_name     = undef,
+$ng_contactgroup_alias    = undef,
+$ng_contactgroup_register = &#39;1&#39;,
+
+) {
+
+$ng_nagios_server         = $::cd_nagios::params::ng_nagios_server
+$ng_tgt_contactgroup_add  = $::cd_nagios::params::ng_tgt_contactgroup_add
+
+
+  if $::fqdn == $ng_nagios_server {
+
+    concat::fragment { $name:
+      target    =&gt;  $ng_tgt_contactgroup_add,
+      content   =&gt;  template($ng_contacts_rule_erb),
+    }
+  }
+}</pre>
+      </td>
+    </tr>
+  </table>
+</div>
+</div>
+
+      <div id="footer">
+  Generated on Thu Jul 27 12:41:45 2017 by
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.9.9 (ruby-2.0.0).
+</div>
+
+    </div>
+  </body>
+</html>
--- a/doc/puppet_defined_types/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Atemplates.html
+++ b/doc/puppet_defined_types/cd_nagios_3A_3Anagios_3A_3Aobjects_3A_3Atemplates.html
@@ -935,7 +935,7 @@ $ng_templates_rule_erb  = $::cd_nagios::params::ng_templates_rule_erb
 </div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:41 2017 by
+  Generated on Thu Jul 27 12:41:45 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/puppet_defined_types/cd_nagios_3A_3Aserver_3A_3Aaccess.html
+++ b/doc/puppet_defined_types/cd_nagios_3A_3Aserver_3A_3Aaccess.html
@@ -220,7 +220,7 @@ $ng_service       = $::cd_nagios::params::ng_service
 </div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:40 2017 by
+  Generated on Thu Jul 27 12:41:44 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/doc/top-level-namespace.html
+++ b/doc/top-level-namespace.html
@@ -90,7 +90,7 @@
 </div>

      <div id="footer">
-  Generated on Wed Jul 26 16:27:34 2017 by
+  Generated on Thu Jul 27 12:41:39 2017 by
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
  0.9.9 (ruby-2.0.0).
 </div>
--- a/manifests/nagios/objects/add_contactgroups.pp
+++ b/manifests/nagios/objects/add_contactgroups.pp
@@ -0,0 +1,43 @@
+## cd_nagios::nagios::objects::add_contactgroups.pp
+# Module name: cd_nagios
+# Author: Arne Teuke (arne_teuke@ConfDroid.com)
+# # License:
+#    This file is part of cd_nagios.
+#
+#    cd_nagios is used for providing automatic configuration of Nagios
+#    Copyright (C) 2016  ConfDroid (copyright@ConfDroid.com)
+#    This program is free software: you can redistribute it and/or modify
+#    it under the terms of the GNU General Public License as published by
+#    the Free Software Foundation, either version 3 of the License, or
+#    (at your option) any later version.
+#
+#    This program is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#    GNU General Public License for more details.
+#
+#    You should have received a copy of the GNU General Public License
+#    along with this program.  If not, see <http://www.gnu.org/licenses/>
+# @summary  Define populates /etc/nagios/conf.d/nagios_add_contactgroups through
+#   external puppet rules.
+################################################################################
+define cd_nagios::nagios::objects::add_contactgroups (
+
+$ng_contactgroup_name     = undef,
+$ng_contactgroup_alias    = undef,
+$ng_contactgroup_register = '1',
+
+) {
+
+$ng_nagios_server         = $::cd_nagios::params::ng_nagios_server
+$ng_tgt_contactgroup_add  = $::cd_nagios::params::ng_tgt_contactgroup_add
+
+
+  if $::fqdn == $ng_nagios_server {
+
+    concat::fragment { $name:
+      target    =>  $ng_tgt_contactgroup_add,
+      content   =>  template($ng_contacts_rule_erb),
+    }
+  }
+}
--- a/manifests/nagios/objects/add_contactgroups_rules.pp
+++ b/manifests/nagios/objects/add_contactgroups_rules.pp
@@ -0,0 +1,66 @@
+## cd_nagios::nagios::objects::add_contactgroups_rules.pp
+# Module name: cd_nagios
+# Author: Arne Teuke (arne_teuke@ConfDroid.com)
+# # License:
+#    This file is part of cd_nagios.
+#
+#    cd_nagios is used for providing automatic configuration of Nagios
+#    Copyright (C) 2016  ConfDroid (copyright@ConfDroid.com)
+#    This program is free software: you can redistribute it and/or modify
+#    it under the terms of the GNU General Public License as published by
+#    the Free Software Foundation, either version 3 of the License, or
+#    (at your option) any later version.
+#
+#    This program is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#    GNU General Public License for more details.
+#
+#    You should have received a copy of the GNU General Public License
+#    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+# @summary  Class manages /etc/nagios/conf.d/nagios_add_contactgroups.cfg file
+#   and populates through define and external puppet rules
+# @example
+#   cd_nagios::nagios::objects::add_contactgroups { 'example_group':
+#     ng_contactgroup_name      =>  'example_group',
+#     ng_contactgroup_alias     =>  'Example Group',
+#     ng_contactgroup_register  =>  '1',
+#   }
+################################################################################
+class cd_nagios::nagios::objects::add_contactgroups_rules (
+
+
+) inherits cd_nagios::params {
+
+  if $::fqdn == $ng_nagios_server {
+
+    # manage /etc/nagios/conf.d/nagios_add_contactgroups.cfg
+
+    concat { $ng_tgt_contactgroup_add:
+      ensure    =>  present,
+      path      =>  $ng_tgt_contactgroup_add,
+      owner     =>  $ng_user,
+      group     =>  $ng_user,
+      mode      =>  '0640',
+      selrange  =>  s0,
+      selrole   =>  object_r,
+      seltype   =>  nagios_etc_t,
+      seluser   =>  system_u,
+      notify    =>  Service[$ng_service],
+    }
+
+    # manage file header
+
+    concat::fragment { 'contactgroups_header':
+      target    =>  $ng_tgt_contactgroup_add,
+      content   =>  template($ng_cntctgrps_head_erb),
+      order     =>  '000',
+    }
+
+    cd_nagios::nagios::objects::add_contactgroups { 'example_group':
+      ng_contactgroup_name      =>  'example_group',
+      ng_contactgroup_alias     =>  'Example Group',
+      ng_contactgroup_register  =>  '1',
+    }
+  }
+}
--- a/manifests/nagios/objects/contactgroups.pp
+++ b/manifests/nagios/objects/contactgroups.pp
@@ -18,6 +18,18 @@
 #
 #    You should have received a copy of the GNU General Public License
 #    along with this program.  If not, see <http://www.gnu.org/licenses/>
+# @summary Class manages base contactgroups which always should be there.
+# @example
+#   @@nagios_contactgroup { 'admins':
+#     ensure              =>  present,
+#     alias               =>  'Nagios Administrators',
+#     contactgroup_name   =>  'admins',
+#     owner               =>  $ng_user,
+#     group               =>  $ng_user,
+#     mode                =>  '0640',
+#     register            =>  '1',
+#     target              =>  $ng_tgt_contactgroup_base,
+#   }
 ################################################################################
 class cd_nagios::nagios::objects::contactgroups (

--- a/manifests/params.pp
+++ b/manifests/params.pp
@@ -976,6 +976,9 @@ $ng_target_add_contact    = "${ng_conf_d_dir}/nagios_add_contact.cfg"
 $ng_contacts_head_erb     = 'cd_nagios/nagios/contacts_cfg_head.erb'
 $ng_contacts_rule_erb     = 'cd_nagios/nagios/contacts_cfg_rule.erb'
 $ng_tgt_contactgroup_base = "${ng_conf_d_dir}/nagios_contactgroup_base.cfg"
+$ng_tgt_contactgroup_add  = "${ng_conf_d_dir}/nagios_contactgroup_add.cfg"
+$ng_cntctgrps_head_erb    = 'cd_nagios/nagios/contactgroups_cfg_head.erb'
+$ng_cntctgrps_rule_erb    = 'cd_nagios/nagios/contactgroups_cfg_rule.erb'
 $ng_target_command        = "${ng_conf_d_dir}/nagios_command.cfg"


--- a/templates/nagios/contactgroups_cfg_head.erb
+++ b/templates/nagios/contactgroups_cfg_head.erb
@@ -0,0 +1,8 @@
+###############################################################################
+##########     nagios_add_contactgroups.cfg created by Puppet        ##########
+##########            manual changes are overwritten!                ##########
+###############################################################################
+##########        Full reference file available at                   ##########
+##########      https://confdroid.com/2017/07/nagios-contacts-cfg/   ##########
+###############################################################################
+# rules are created below by external puppet rules.
--- a/templates/nagios/contactgroups_cfg_rule.erb
+++ b/templates/nagios/contactgroups_cfg_rule.erb
@@ -0,0 +1,5 @@
+define contactgroup {
+  contactgroup_name   <%= @ng_contactgroup_name %>
+  alias               <%= @ng_contactgroup_alias %>
+  register            <%= @ng_contactgroup_register %>
+  }
--- a/templates/nagios/contacts_cfg.erb
+++ b/templates/nagios/contacts_cfg.erb