From: Thomas Markwalder <tmark@isc.org>
Date: Thu, 8 Oct 2020 18:33:13 +0000 (-0400)
Subject: [#1385] Updated ARM and added a ChangeLog
X-Git-Tag: Kea-1.9.1~97
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=fbc4d1ecaf9bdc241b88809bfb1adbdef9be0afe;p=thirdparty%2Fkea.git

[#1385] Updated ARM and added a ChangeLog
---

diff --git a/ChangeLog b/ChangeLog
index 85c0700236..17c1766cf8 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+1813.	[func]		tmark
+	A new parameter, ddns-update-on-renew, has been added to kea-dhcp4
+	and kea-dhcp6 configuration.  When true, the server will always
+	update DNS when a lease is renewed even if the DNS information
+	for the lease has not changed. The prior, and now default, behavior
+	is for the server to only update DNS for a renewing lease if its
+	DNS information has changed.
+	(Gitlab #1385)
+
 1812.	[doc]		andrei
 	Document how MAC addresses can be formatted for use as attributes
 	in RADIUS authentication
diff --git a/doc/sphinx/arm/dhcp4-srv.rst b/doc/sphinx/arm/dhcp4-srv.rst
index af38e24b59..2267bd667a 100644
--- a/doc/sphinx/arm/dhcp4-srv.rst
+++ b/doc/sphinx/arm/dhcp4-srv.rst
@@ -2925,6 +2925,7 @@ DDNS related parameters were split into two groups:
     -  ``ddns-replace-client-name"``
     -  ``ddns-generated-prefix``
     -  ``ddns-qualifying-suffix``
+    -  ``ddns-update-on-renew``
     -  ``hostname-char-set``
     -  ``hostname-char-replacement``
 
@@ -2994,6 +2995,19 @@ together:
    |                 |                    | false for ddns-enable-updates |
    +-----------------+--------------------+-------------------------------+
 
+Kea 1.9.1 added a new parameter, ``ddns-update-on-renew``. Normally, when
+leases are renewed the server will only update DNS if the DNS information
+for the lease (e.g. FQDN, DNS update direction flags) have changed. Setting
+``ddns-update-on-renew`` to true instructs the server to always update the
+DNS information when a lease is renewed even if its DNS information has not
+changed.  This always Kea to "self-heal" in the event it was previously unable
+to add DNS entries or they were somehow lost by the DNS server.
+
+.. note::
+
+    Setting ``ddns-update-on-renew`` to true may impact performance, especially
+    for servers with numerous clients who renew often.
+
 .. _dhcpv4-d2-io-config:
 
 DHCP-DDNS Server Connectivity
diff --git a/doc/sphinx/arm/dhcp6-srv.rst b/doc/sphinx/arm/dhcp6-srv.rst
index d497f188ca..f56dd1f9ad 100644
--- a/doc/sphinx/arm/dhcp6-srv.rst
+++ b/doc/sphinx/arm/dhcp6-srv.rst
@@ -2599,6 +2599,7 @@ DDNS related parameters were split into two groups:
     -  ``ddns-replace-client-name"``
     -  ``ddns-generated-prefix``
     -  ``ddns-qualifying-suffix``
+    -  ``ddns-update-on-renew``
     -  ``hostname-char-set``
     -  ``hostname-char-replacement``
 
@@ -2668,6 +2669,19 @@ together:
    |                 |                    | false for ddns-enable-updates |
    +-----------------+--------------------+-------------------------------+
 
+Kea 1.9.1 added a new parameter, ``ddns-update-on-renew``. Normally, when
+leases are renewed the server will only update DNS if the DNS information
+for the lease (e.g. FQDN, DNS update direction flags) have changed. Setting
+``ddns-update-on-renew`` to true instructs the server to always update the
+DNS information when a lease is renewed even if its DNS information has not
+changed.  This always Kea to "self-heal" in the event it was previously unable
+to add DNS entries or they were somehow lost by the DNS server.
+
+.. note::
+
+    Setting ``ddns-update-on-renew`` to true may impact performance, especially
+    for servers with numerous clients who renew often.
+
 .. _dhcpv6-d2-io-config:
 
 DHCP-DDNS Server Connectivity