[icinga-checkins] icinga.org: icinga-doc/master: docs issue #1149: inheritance / important values

git at icinga.org git at icinga.org
Wed Jan 26 20:59:30 CET 2011


Module: icinga-doc
Branch: master
Commit: 5839ab794405ffddd4eb9be3f44face1156796a3
URL:    https://git.icinga.org/?p=icinga-doc.git;a=commit;h=5839ab794405ffddd4eb9be3f44face1156796a3

Author: Wolfgang <wnd at gmx.net>
Date:   Wed Jan 26 20:58:01 2011 +0100

docs issue #1149: inheritance / important values

---

 de/icinga-web-config.xml |    2 +-
 de/objectinheritance.xml |   42 ++++++++++++++++++++++++++++++++++++++++++
 en/objectinheritance.xml |    5 +++++
 3 files changed, 48 insertions(+), 1 deletions(-)

diff --git a/de/icinga-web-config.xml b/de/icinga-web-config.xml
index e491568..914d743 100644
--- a/de/icinga-web-config.xml
+++ b/de/icinga-web-config.xml
@@ -207,7 +207,7 @@ autoload.xml  config_handlers.xml  cronks.xml  module.xml  validators.xml</progr
 
   <para>Wenn Sie diese Einstellungen ändern möchten, editieren Sie bitte app/modules/Web/config/icinga-io.site.xml.</para>
 
-  <para><anchor xml:id="configweb-custom" /><emphasis role="bold">Benutzerdefinierte Konfiguration</emphasis></para>
+  <para><anchor xml:id="configweb-customconfig" /><emphasis role="bold">Benutzerdefinierte Konfiguration</emphasis></para>
 
   <para><emphasis role="bold">Bitte beachten:</emphasis></para>
 
diff --git a/de/objectinheritance.xml b/de/objectinheritance.xml
index 2936bf1..d576745 100644
--- a/de/objectinheritance.xml
+++ b/de/objectinheritance.xml
@@ -408,6 +408,48 @@
         ...
         }</screen>
 
+    <para><anchor xml:id="objectinheritance-important_values" /><emphasis role="bold">Wichtige Werte</emphasis> (important values)</para>
+
+    <para>Service-Vorlagen können eine spezielle Regel benutzen, die ihrem check_command-Wert Vorrang gibt. Wenn das check_command mit einem
+    Ausrufungszeichen (!) beginnt, dann wird das check_command der Vorlage als wichtig markiert und wird statt des im Service definierten
+    check_command (dies ist der CSS-Syntax nachempfunden, die ! als wichtiges Attribut benutzt).</para>
+
+    <para>Warum ist das nützlich? Es ist hauptsächlich dann sinnvoll, wenn ein unterschiedliches check_command für verteilte Systeme gesetzt wird.
+    Sie wollen vielleicht einen Frische-Schwellwert und ein check_command setzen, der den Service in einen fehlerhaften Status versetzt, aber
+    das funktioniert nicht mit dem normalen Vorlagensystem. Dieses "wichtig"-Kennzeichen erlaubt es, das angepasste check_command zu schreiben,
+    aber eine allgemeine verteilte Vorlage zu benutzen, die das check_command überlagert, wenn es auf dem zentralen &name-icinga;-Server
+    eingesetzt wird.</para>
+
+    <para>Zum Beispiel:</para>
+
+    <screen># On master
+define service {
+        name                   service-distributed
+        register               0
+        active_checks_enabled  0
+        check_freshness        1
+        check_command          !set_to_stale
+        }
+# On slave
+define service {
+        name                   service-distributed
+        register               0
+        active_checks_enabled  1
+        }
+# Service definition, used by master and slave
+define service {
+        host_name              host1
+        service_description    serviceA
+        check_command          check_http...
+        use                    service-distributed
+        ...
+        }</screen>
+
+    <note><para>Bitte beachten Sie, dass nur eine Vererbungsebene bei diesen wichtigen Werten möglich ist. Das bedeutet, dass Sie nicht das
+    check_command von einer Vorlage zu einer weiteren und von dort zum Service vererben können.
+    <programlisting> Template1 => Service1                <== funktioniert
+ Template1 => Template2 => Service1   <== funktioniert NICHT</programlisting></para></note>
+
   <para><anchor xml:id="objectinheritance-multiple_templates" /><emphasis role="bold">Mehrere Vererbungsquellen</emphasis></para>
 
   <para>Bisher haben alle Beispiele Objektdefinitionen gezeigt, die Variablen/Werte von einer einzelnen Quelle erben. Sie können
diff --git a/en/objectinheritance.xml b/en/objectinheritance.xml
index 2df8468..70ce934 100644
--- a/en/objectinheritance.xml
+++ b/en/objectinheritance.xml
@@ -455,6 +455,11 @@ define service {
         ...
         }</screen>
 
+    <note><para>Please note that only one level of inheritance is possible using important values. That means that you cannot inherit 
+    the check_command from one template to another and from the latter to a service.
+    <programlisting> Template1 => Service1                <== will work
+ Template1 => Template2 => Service1   <== will NOT work</programlisting></para></note>
+
     <para><anchor xml:id="objectinheritance-multiple_templates" /><emphasis role="bold">Multiple Inheritance Sources</emphasis></para>
 
     <para>Thus far, all examples of inheritance have shown object definitions inheriting variables/values from just a single source. You are also able





More information about the icinga-checkins mailing list