From: Marcin Siodelski <marcin@isc.org>
Date: Thu, 6 Dec 2018 17:46:26 +0000 (+0100)
Subject: [#173,!154] Updated User's Guide with a warning about reconnect-wait-time.
X-Git-Tag: 339-doxygen-errors_base~10^2~2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=5fc46151d5446b71c66689140d6edf5940240d57;p=thirdparty%2Fkea.git

[#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 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>