[#173,!154] Updated User's Guide with a warning about reconnect-wait-time.

diff --git a/doc/guide/dhcp4-srv.xml b/doc/guide/dhcp4-srv.xml
index ab94e0d7f0aff3bbfd4aaf71555d824f2eab35b8..6c08867d8dc3ab093a17bf9abb254211af85d10a 100644 (file)
--- 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 78f7ac82ad9756c5b0323266ba0805f5cf2a2262..63be6fbd9dcd9c07a60b233bc808da008c90c6ff 100644 (file)
--- 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>