[icinga-checkins] icinga.org: icinga-doc/r1.7: docs issue #2301: changed text for allow_empty_hostgroups_assignment

git at icinga.org git at icinga.org
Fri Feb 10 17:35:24 CET 2012


Module: icinga-doc
Branch: r1.7
Commit: fa7fe0c4691958289acd451d4cc6e6b5307d2fd2
URL:    https://git.icinga.org/?p=icinga-doc.git;a=commit;h=fa7fe0c4691958289acd451d4cc6e6b5307d2fd2

Author: Wolfgang <wnd at gmx.net>
Date:   Fri Feb 10 17:32:32 2012 +0100

docs issue #2301: changed text for allow_empty_hostgroups_assignment

---

 de/configmain.xml |   26 ++++++++++++++++++++++----
 en/configmain.xml |   25 +++++++++++++++++++++----
 2 files changed, 43 insertions(+), 8 deletions(-)

diff --git a/de/configmain.xml b/de/configmain.xml
index 17c28fd..9608e73 100644
--- a/de/configmain.xml
+++ b/de/configmain.xml
@@ -5202,10 +5202,28 @@
     </tgroup>
   </informaltable>
 
-  <para>Diese boolesche Option legt fest, ob Services, die leeren Hostgruppen zuordnet sind (Hostgruppen ohne Host-Member), &name-icinga;
-  beim Start (oder bei der Konfigurationsprüfung) mit einem Fehler abbrechen lassen oder nicht. Das Default-Verhalten, wenn die Option nicht
-  in der Hauptkonfigurationsdatei vorhanden ist (oder auf "0" gesetzt ist), besteht darin, dass &name-icinga; mit einem Fehler abbricht,
-  wenn Services mit Hostgruppen verbunden sind, denen in der hostgroup-Definition keine Host-Member zugeordnet sind.</para>
+  <para>Diese boolesche Option legt fest, ob Services, Host-Abhängigkeiten oder Service-Abhängigkeiten, die leeren Hostgruppen zuordnet
+    sind (Hostgruppen ohne Host-Member), &name-icinga; beim Start (oder bei der Konfigurationsprüfung) mit einem Fehler abbrechen lassen
+    oder nicht. Das Default-Verhalten, wenn die Option nicht in der Hauptkonfigurationsdatei vorhanden ist (oder auf "0" gesetzt ist),
+    besteht darin, dass &name-icinga; mit einem Fehler abbricht, wenn Services, Host-Abhängigkeiten oder Service-Abhängigkeiten, mit
+    Hostgruppen verbunden sind, denen in der hostgroup-Definition keine Host-Member zugeordnet sind.</para>
+
+  <para>Aktivieren dieser Option kann sinnvoll sein, wenn:</para>
+  <itemizedlist>
+    <listitem>
+      <para>Konfigurationdateien oder vorgespeicherte Objektdateien an viele &Icinga-Poller verteilt werden.</para>
+    </listitem>
+    <listitem>
+      <para>Automation benutzt wird, um einen "Baum" mit &name-icinga;-Konfigurationsdateien zu erzeugen.</para>
+    </listitem>
+    <listitem>
+      <para>es einen Satz von Services, Host-Abhängigkeiten oder Service-Abhängigkeiten gibt, der von Administrationen verwaltet werden, be
+        dem Benutzer der Einfachheit halber Hosts über die Hostgruppenzugehörigkeit hinzufügen können (z.B. eine Suite von Prüfungen, die
+        mit einem entfernten Überwachungsagenten verbunden sind), wobei es aber keine Garantie dafür gibt, dass die Benutzer die Services
+        verwenden, die mit der Hostgruppe verbunden sind, oder dass die Hosts existieren (z.B. ein entfernter Agent, dessen Hosts
+        mit der Zeit stillgelegt werden).
+    </listitem>
+  </itemizedlist>
 
   <note>
     <para>Diese Option ist verfügbar ab &name-icinga; 1.3.</para>
diff --git a/en/configmain.xml b/en/configmain.xml
index 424fe6a..17a6d34 100644
--- a/en/configmain.xml
+++ b/en/configmain.xml
@@ -5664,10 +5664,27 @@
     </tgroup>
   </informaltable>
 
-  <para>This boolean option determines whether services assigned to empty host groups (host groups with no host members) will cause
-  &name-icinga; to exit with error on startup (or during a configuration check) or not. The default behaviour if the option is not present
-  (or set to "0") in the main configuration file is for &name-icinga; to exit with error if services are associated with host groups whose
-  hostgroup definitions have no host_members associated with them.</para>
+  <para>This boolean option determines whether services, service dependencies, or host dependencies assigned to empty host groups (host
+  groups with no host members) will cause &name-icinga; to exit with error on startup (or during a configuration check) or not. The default
+  behaviour if the option is not present (or set to "0") in the main configuration file is for &name-icinga; to exit with error if any of
+  these objects are associated with host groups whose hostgroup definitions have no host_members associated with them.</para>
+
+  <para>Enabling this option can be useful when:</para>
+  <itemizedlist>
+    <listitem>
+      <para>Configuration files or pre-cached object files are distributed across many &name-icinga; pollers.</para>
+    </listitem>
+    <listitem>
+      <para>Automation is used to generate an &name-icinga; configuration file tree.</para>
+    </listitem>
+    <listitem>
+      <para>There is one set of services, service dependencies, or host dependencies maintained by administrators for which users may add
+        hosts through host group membership for convenience (e.g. a suite of checks associated with a remote monitoring agent) but for
+        which there is no guarantee that users will use the services associated with the host group or that the hosts will exists (e.g. a
+        remote agent that is being deprecated over time or hosts that are being decommissioned).</para>
+    </listitem>
+  </itemizedlist>
+
 
   <note>
     <para>This option is available starting with &name-icinga; 1.3.</para>





More information about the icinga-checkins mailing list