From 282386e122971b5e6c84fa60a903382ac58252a9 Mon Sep 17 00:00:00 2001
From: Michael Friedrich <michael.friedrich@netways.de>
Date: Wed, 14 May 2014 18:24:41 +0200
Subject: [PATCH] Documentation: Update draft on zone sync.

Refs #6191
---
 doc/4-monitoring-remote-systems.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/doc/4-monitoring-remote-systems.md b/doc/4-monitoring-remote-systems.md
index 5a079a2ea..d6cb65a01 100644
--- a/doc/4-monitoring-remote-systems.md
+++ b/doc/4-monitoring-remote-systems.md
@@ -576,6 +576,31 @@ Zones can be used for [high availability](#cluster-scenarios-high-availability),
 
 TODO - FIXME
 
+Zones are organized below `/etc/icinga2/zones.d`. Each configured zone must exist with the
+same directory name. The parent zone syncs the configuration to the child zones, if allowed.
+
+    object Zone "master" {
+      endpoints = [ "icinga2a" ]
+    }
+
+    object Zone "checker" {
+      endpoints = [ "icinga2b" ]
+      parent = "master"
+    }
+
+    /etc/icinga2/zones.d
+      master
+        health.conf
+      checker
+        health.conf
+        demo.conf
+
+> **Note**
+>
+> `zones.d` must not be included in [icinga2.conf](#icinga2-conf). Icinga 2 automatically
+> determines the required include directory. This can be overridden using the
+> [global constant](#global-constants) `ZonesDir`.
+
 ### <a id="zone-permissions"></a> Zone Permissions
 
 TODO - FIXME
-- 
2.40.0