Changeset c320d40 for server

Timestamp:

12/04/2023 03:07:13 PM (5 months ago)

Author:

Pierre Labastie <pierre.labastie@…>

Branches:

12.1, ken/TL2024, lazarus, plabs/newcss, python3.11, rahul/power-profiles-daemon, trunk, xry111/llvm18

Children:

d1d8cc44

Parents:

64b92e43

git-author:

Pierre Labastie <pierre.labastie@…> (12/03/2023 09:35:34 PM)

git-committer:

Pierre Labastie <pierre.labastie@…> (12/04/2023 03:07:13 PM)

Message:

kea.xml: fix text for systemd units

Also fix typgraphy...

File:

• server/major/kea.xml (modified) (7 diffs)

server/major/kea.xml

@@ -170 +170 @@
     <title>Configuring ISC Kea DHCP Server</title>
 
-    <para>The support of IPv4, IPv6 and DDNS has been split into
-    separate servers which runs independently from each other. Each
-    of them has its own configuration file. Additional configuration
-    files come from the keactrl agent which is uses to control the
-    servers in an easy way.</para>
-
-    <para>Consult the
-    <ulink url="https://kea.readthedocs.io/en/kea-&kea-arm-vers;/">Kea Administrator Reference Manual</ulink>
-    for detailed information about the configuration of <application>ISC Kea</application>
-    as it is a quite capable system. The configuration shown a bare
-    minimum to get a DHCP server running but it already includes
-    configuration for DDNS (Dynamic DNS). That setup might be working
-    for small networks with a few clients and low traffic. For greater
-    installations with thousands of clients, <application>ISC Kea</application>
-    can be configured to use databases (mariadb or postgresql) to store
-    the leases and build a cluster with multiple nodes. It can
-    be integrated to <ulink url="https://www.isc.org/categories/stork/">ISC Stork</ulink>
-    which is a management dashboard to <application>ISC Kea</application>.</para>
+    <para>
+      The support of IPv4, IPv6 and DDNS has been split into
+      separate servers which runs independently from each other. Each
+      of them has its own configuration file.<phrase revision="sysv">
+      Additional configuration files come from the keactrl agent which
+      is used to control the servers in an easy way.</phrase>
+    </para>
+
+    <para>
+      Consult the <ulink
+        url="https://kea.readthedocs.io/en/kea-&kea-arm-vers;/">
+        Kea Administrator Reference Manual</ulink>
+      for detailed information about the configuration of
+      <application>ISC Kea</application> as it is a quite capable system.
+      The configuration shown below is a bare minimum to get a DHCP server
+      running but it already includes configuration for DDNS (Dynamic DNS).
+      That setup might be working for small networks with a few clients and
+      low traffic. For greater installations with thousands of clients,
+      <application>ISC Kea</application> can be configured to use databases
+      (mariadb or postgresql) to store the leases and build a cluster with
+      multiple nodes. It can be integrated to
+      <ulink url="https://www.isc.org/categories/stork/">ISC Stork</ulink>
+      which is a management dashboard to <application>ISC Kea</application>.
+    </para>
 
     <para>
@@ -206 +212 @@
 
       <para>
-        <filename>/etc/kea/keactrl.conf</filename>,
+        <phrase revision="sysv">
+          <filename>/etc/kea/keactrl.conf</filename>,
+        </phrase>
         <filename>/etc/kea/kea-ctrl-agent.conf</filename>,
         <filename>/etc/kea/kea-dhcp4.conf</filename>,
-        <filename>/etc/kea/kea-dhcp6.conf</filename> and
+        <filename>/etc/kea/kea-dhcp6.conf</filename>, and
         <filename>/etc/kea/kea-dhcp-ddns.conf</filename>
       </para>
 
-      <indexterm zone="kea keactrl-config">
+      <indexterm zone="kea keactrl-config" revision="sysv">
         <primary sortas="e-etc-kea-keactrl.conf">/etc/kea/keactrl.conf</primary>
       </indexterm>
@@ -224 +232 @@
         <primary sortas="e-etc-kea-dhcp4.conf">/etc/kea/kea-dhcp4.conf</primary>
       </indexterm>
-<!--
+
       <indexterm zone="kea kea-dhcp6-config">
         <primary sortas="e-etc-kea-dhcp6.conf">/etc/kea/kea-dhcp6.conf</primary>
       </indexterm>
--->
+
       <indexterm zone="kea kea-dhcp-ddns-config">
         <primary sortas="e-etc-kea-dhcp-ddns.conf">/etc/kea/kea-dhcp-ddns.conf</primary>
@@ -234 +242 @@
     </sect3>
 
-    <sect3 id="keactrl-config">
+    <sect3 id="keactrl-config" revision="sysv">
       <title>Kea Control Configuration</title>
 
@@ -279 +287 @@
       </itemizedlist>
 
-      <para>The Netconf service is not installed because required
-      dependencies are not covered by the current BLFS book.</para>
-
-      <para>With the following command, Kea will be configured to
-      start the dhcp service for IPv4 and the
-      dynamic DNS update, while the control agent and
-      the dhcp service for IPv6 remains down. Tweak the command to
-      match your needs on started services and execute as the
-      <systemitem class="username">root</systemitem> user:</para>
+      <para>
+        The Netconf service is not installed because required
+        dependencies are not covered by the current BLFS book.
+.    </para>
+
+      <para>
+        With the following command, Kea will be configured to
+        start the dhcp service for IPv4 and the
+        dynamic DNS update, while the control agent and
+        the dhcp service for IPv6 remain down. Tweak the command to
+        match your needs on started services and execute as the
+        &root; user:
+      </para>
 
 <screen role="root"><userinput>sed -e "s/^dhcp4=.*/dhcp4=yes/" \
@@ -295 +307 @@
     -i /etc/kea/keactrl.conf
 </userinput></screen>
+
+    </sect3>
+
+    <sect3 id="kea-sysd-config" revision="systemd">
+      <title>Kea Configuration Using Systemd Units</title>
+
+      <para>
+        Four service units are used to start various daemons
+        provided by Kea:
+      </para>
+
+      <itemizedlist>
+        <listitem>
+          <para>Control Agent</para>
+          <para>
+            The Control Agent is a daemon which allows the
+            (re)configuration of the Kea DHCP service via REST API.
+            Run <command>systemctl enable kea-ctrl-agent</command>
+            if this daemon is needed.
+          </para>
+        </listitem>
+        <listitem>
+          <para>IPv4 DHCP server</para>
+          <para>
+            This daemon handles requests for IPv4 addresses.
+            Run <command>systemctl enable kea-dhcp4-server</command> to
+            have it started by systemd.
+          </para>
+        </listitem>
+        <listitem>
+          <para>IPv6 DHCP server</para>
+          <para>
+            This daemon handles requests for IPv6 addresses.
+            Run <command>systemctl enable kea-dhcp6-server</command> to
+            have it started by systemd.
+          </para>
+        </listitem>
+        <listitem>
+          <para>Dynamic DNS</para>
+          <para>
+            This daemon is used to update a DNS server dynamically
+            when Kea assigns an IP address to a device.
+            Run <command>systemctl enable kea-ddns-server</command> to
+            have it started by systemd.
+          </para>
+        </listitem>
+      </itemizedlist>
+
+      <para>The Netconf service is not installed because required
+      dependencies are not covered by the current BLFS book.</para>
 
     </sect3>
@@ -444 +506 @@
 EOF</userinput></screen>
 
+    </sect3>
+
+    <sect3 id="kea-dhcp6-config">
+      <title>IPv6 DHCP Server Configuration</title>
+
       <para>
         The configuration for IPv6 is similar to the configuration