[#643,!421] Added a warning about misconfigurations when using server tags.

diff --git a/doc/guide/config-backend.xml b/doc/guide/config-backend.xml
index 9783caa12133371c448c94d6e91ad5829442cc15..cbff721a4ad83ff3e94f4525f0d5464e1686d1f9 100644 (file)
--- a/doc/guide/config-backend.xml
+++ b/doc/guide/config-backend.xml
@@ -324,6 +324,22 @@
       configuration in the database is shareable because all its pieces
       belong to "all" servers.
     </para>
+
+    <note>
+      <simpara>
+        Be very careful when associating the configuration elements with
+        different server tags. The configuration backend doesn't protect you
+        against some possible misconfigurations that may arise from the
+        wrong server tags' assignments. For example: if you assign a shared
+        network to one server and the subnets belonging to this shared network
+        to another server, the servers will fail upon trying to fetch and
+        use this configuration. The server fetching the subnets will be
+        aware that the subnets are associated with the shared network but
+        the shared network will not be found by this server as it doesn't
+        belong to it. In such case, both the shared network and the subnets
+        should be assigned to the same set of servers.
+      </simpara>
+    </note>
   </section>
 
 </section>