From 5fc46151d5446b71c66689140d6edf5940240d57 Mon Sep 17 00:00:00 2001
From: Marcin Siodelski <marcin@isc.org>
Date: Thu, 6 Dec 2018 18:46:26 +0100
Subject: [PATCH] [#173,!154] Updated User's Guide with a warning about
 reconnect-wait-time.

---
 doc/guide/dhcp4-srv.xml | 11 +++++++++++
 doc/guide/dhcp6-srv.xml | 12 ++++++++++++
 2 files changed, 23 insertions(+)

diff --git a/doc/guide/dhcp4-srv.xml b/doc/guide/dhcp4-srv.xml
index ab94e0d7f0..6c08867d8d 100644
--- a/doc/guide/dhcp4-srv.xml
+++ b/doc/guide/dhcp4-srv.xml
@@ -673,6 +673,17 @@ causes the server to exit immediately upon detecting the loss of connectivity.
 The default value for Cassandra is 2000 ms.
     </para>
 
+    <warning>
+      <para>
+        Current Kea release has a flaw whereby the values of <command>reconnect-wait-time</command>
+        and <command>max-reconnect-tries</command> specified in the <command>lease-database</command>
+        override the setting of those parameters in the <command>hosts-database</command>. The
+        parameters specified within the <command>hosts-database</command> are only effective
+        when <command>memfile</command> is used as a lease database backend. This behavior will
+        be corrected in the future releases of Kea.
+      </para>
+    </warning>
+
   </para>
   <para>Finally, the credentials of the account under which the server will
   access the database should be set:
diff --git a/doc/guide/dhcp6-srv.xml b/doc/guide/dhcp6-srv.xml
index 78f7ac82ad..63be6fbd9d 100644
--- a/doc/guide/dhcp6-srv.xml
+++ b/doc/guide/dhcp6-srv.xml
@@ -609,6 +609,18 @@ The default value for MySQL and Postgres is 0, which disables automatic recovery
 causes the server to exit immediately upon detecting the loss of connectivity.
 The default value for Cassandra is 2000 ms.
   </para>
+
+  <warning>
+    <para>
+      Current Kea release has a flaw whereby the values of <command>reconnect-wait-time</command>
+      and <command>max-reconnect-tries</command> specified in the <command>lease-database</command>
+      override the setting of those parameters in the <command>hosts-database</command>. The
+      parameters specified within the <command>hosts-database</command> are only effective
+      when <command>memfile</command> is used as a lease database backend. This behavior will
+      be corrected in the future releases of Kea.
+    </para>
+  </warning>
+
   <para>Finally, the credentials of the account under which the server will
   access the database should be set:
 <screen>
-- 
GitLab