[#3577] Clarified FLQ not for shared db

diff --git a/doc/sphinx/arm/dhcp4-srv.rst b/doc/sphinx/arm/dhcp4-srv.rst
index b567b802e13b1e1bfcede3c26426878c6ed916d8..e14811511579b733c5071305d36ec1de28868aef 100644 (file)
--- a/doc/sphinx/arm/dhcp4-srv.rst
+++ b/doc/sphinx/arm/dhcp4-srv.rst
@@ -8828,5 +8828,12 @@ the FLQ allocator only for selected subnets. That way, when a new subnet is
 added without an allocator specification, the global setting is used, thus
 avoiding unnecessary impact on the server's startup time.
 
-Like the random allocator, the FLQ allocator offers leases in
-random order, which makes it suitable for use with a shared lease database.
+.. warning::
+
+   The FLQ allocator is not suitable for use with a shared lease database
+   (i.e., when multiple Kea servers store leases in the same database).
+   The servers are unaware of the expired leases reclaimed by the
+   sibling servers and never return them to their local free lease queues.
+   As a result, the servers will not be able to offer some of the available
+   leases to the clients. Only a server reclaiming a particular lease will
+   be able to offer it.

diff --git a/doc/sphinx/arm/dhcp6-srv.rst b/doc/sphinx/arm/dhcp6-srv.rst
index ffe809f285797ad395e109a1cb1c6f91185a90de..14971451587df9b499963da733c3656b16c601f1 100644 (file)
--- a/doc/sphinx/arm/dhcp6-srv.rst
+++ b/doc/sphinx/arm/dhcp6-srv.rst
@@ -8484,5 +8484,12 @@ the FLQ allocator only for selected subnets. That way, when a new subnet is
 added without an allocator specification, the global setting is used, thus
 avoiding unnecessary impact on the server's startup time.
 
-Like the random allocator, the FLQ allocator offers leases in
-random order, which makes it suitable for use with a shared lease database.
+.. warning::
+
+   The FLQ allocator is not suitable for use with a shared lease database
+   (i.e., when multiple Kea servers store leases in the same database).
+   The servers are unaware of the expired leases reclaimed by the
+   sibling servers and never return them to their local free lease queues.
+   As a result, the servers will not be able to offer some of the available
+   leases to the clients. Only a server reclaiming a particular lease will
+   be able to offer it.