From: Michael Friedrich <michael.friedrich@netways.de>
Date: Fri, 24 Jan 2014 13:20:37 +0000 (+0100)
Subject: Documentation: Add service check authorities.
X-Git-Tag: v0.0.7~34
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=26f41502b40b68b606e7bfbd68949a47d10dd9ae;p=icinga2

Documentation: Add service check authorities.

Fixes #5441
---

diff --git a/doc/4.3-object-types.md b/doc/4.3-object-types.md
index 9afc49a85..584959e83 100644
--- a/doc/4.3-object-types.md
+++ b/doc/4.3-object-types.md
@@ -125,6 +125,7 @@ Attributes:
   service_dependencies|**Optional.** A list of services which this host depends on. Each array element must be a dictionary containing the keys "host" and "service". These dependencies are used to determine whether the host is unreachable.
   groups          |**Optional.** The service groups this service belongs to.
   notifications   |**Optional.** Inline definition of notifications. Each dictionary item specifies a notification.<br /><br />The `templates` attribute can be used to specify an array of templates that should be inherited by the notification object.<br /><br />The new notification object's name is "hostname:service:notification" - where "notification" is the dictionary key in the notifications dictionary.
+  authorities     |**Optional.** A list of Endpoints on which this service check will be executed in a cluster scenario.
 
 ### <a id="objecttype-servicegroup"></a> ServiceGroup
 
diff --git a/doc/6-advanced-topics.md b/doc/6-advanced-topics.md
index 52c686456..4c6a3c671 100644
--- a/doc/6-advanced-topics.md
+++ b/doc/6-advanced-topics.md
@@ -232,6 +232,29 @@ You can find the state file in `/var/lib/icinga2/icinga2.state`. Before copying
 the state file you should make sure that all your cluster nodes are properly shut
 down.
 
+### Assign Services to Cluster Nodes
+
+By default all services are distributed among the cluster nodes with the `Checker`
+feature enabled.
+If you require specific services to be only executed by one or more checker nodes
+within the cluster, you must define `authorities` as additional service object
+attribute. Required Endpoints must be defined as array.
+
+    object Host "dmz-host1" inherits "generic-host" {
+      services["dmz-oracledb"] = {
+        templates = [ "generic-service" ],
+        authorities = [ "icinga-node-1" ],
+      }
+    }
+
+> **Tip**
+>
+> Most common usecase is building a classic Master-Slave-Setup. The master node
+> does not have the `Checker` feature enabled, and the slave nodes are checking
+> services based on their location, inheriting from a global service template
+> defining the authorities.
+
+
 ## Dependencies
 
 Icinga 2 uses host and service dependencies as attribute directly on the host or