From 0c925229ef6a6b80963fcda8598e5eb3981b9c3e Mon Sep 17 00:00:00 2001 From: Nick Chappell Date: Mon, 1 Dec 2014 21:49:33 -0800 Subject: [PATCH] Added a README note about the refresh_icinga2_service parameter. refs#7856 : https://dev.icinga.org/issues/7856 --- README.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/README.md b/README.md index 7de8f4e..779a381 100644 --- a/README.md +++ b/README.md @@ -373,6 +373,21 @@ This means that they will not be added to the rendered object definition files. **However**, this doesn't mean that the values are undefined in Icinga 2. Icinga 2 itself has built-in default values for many object parameters and falls back to them if one isn't present in an object definition. See the docs for individual object types in [Configuring Icinga 2](http://docs.icinga.org/icinga2/latest/doc/module/icinga2/toc#!/icinga2/latest/doc/module/icinga2/chapter/configuring-icinga2) for more info about which object parameters have what default values. +####Notifying the Icinga 2 service + +By default, each object defined type will automatically notify and restart the Icinga 2 service. However, if you're using the module to just generate object files and not using it to manage the service, you'll likely get compilation errors about the `icinga2` service not being in the catalog. + +Each object defined type has a boolean parameter, `refresh_icinga2_service`, that controls whether the object file will notify the service. To **not** notify the service, set it to `false`: + +
+icinga2::object::apply_dependency { 'usermail_dep_on_icinga2mail':
+  parent_host_name => 'icinga2mail.local',
+  target_file_owner => vagrant,
+  assign_where => 'match("^usermail*", host.name)',
+  refresh_icinga2_service => false,
+}
+
+ ####[Objects](id:objects) Object types: