]> git.ipfire.org Git - thirdparty/kea.git/commitdiff
[#3123] add documentation for the peer-updates flag in radius
authorAndrei Pavel <andrei@isc.org>
Thu, 18 Jan 2024 12:44:30 +0000 (14:44 +0200)
committerAndrei Pavel <andrei@isc.org>
Thu, 25 Jan 2024 08:14:03 +0000 (10:14 +0200)
doc/sphinx/arm/ext-radius.rst
doc/sphinx/arm/hooks-ha.rst

index b595a5f4c6d5394bea2a59914a811ffa063f05d9..028bfb2e8eae104a4df2f5326fc4d93d79c2a808 100644 (file)
@@ -181,7 +181,7 @@ Two services are supported:
 
 -  ``accounting`` - the accounting service.
 
-Configuration of services is divided into two parts:
+At the service level, three sections can be configured:
 
 -  Servers that define RADIUS services that the library is expected to
    contact. Each server may have the following items specified:
@@ -218,6 +218,16 @@ Configuration of services is divided into two parts:
       It specifies an evaluation expression on the DHCP query packet.
       Currently this is restricted to the access service.
 
+    Attributes are supported only for the access service.
+
+- The ``peer-updates`` boolean flag controls whether lease updates coming from
+  an active High-Availability (HA) partner should result in an accounting
+  request. This may be desirable to remove duplicates if HA partners are
+  configured to send request to the same RADIUS server. The flag is enabled by
+  default and only supported by the accounting service. The lease
+  synchronization process at the startup of an HA node does not trigger a RADIUS
+  accounting request, regardless of the value of this flag.
+
 For example, to specify a single access server available on localhost
 that uses ``"xyz123"`` as a secret, and tell Kea to send three additional
 attributes (``User-Password``, ``Connect-Info``, and ``Configuration-Token``),
index 983a39f3706d74ed85ec82323de34baac5f75f4e..9acfffe137d99cf895d77f06362aa59480a53b56 100644 (file)
@@ -2422,7 +2422,7 @@ The optional ``server-name`` parameter specifies a name of one of the partners b
 to the HA relationship this command pertains to. This parameter can be omitted if the
 server receiving this command has only one HA relationship in the configuration.
 
-The `origin` is used to select the HA service for which the receiving server should
+The ``origin`` parameter is used to select the HA service for which the receiving server should
 enable the DHCP service when it receives this notification. This is the same origin the
 sending server used previously to disable the DHCP service before synchronization.