Changeset 4d418ccd for networking

Timestamp:

06/06/2023 09:18:30 AM (12 months ago)

Author:

Thomas Trepl <thomas@…>

Branches:

12.0, 12.1, kea, ken/TL2024, ken/tuningfonts, lazarus, plabs/newcss, python3.11, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, xry111/llvm18, xry111/xf86-video-removal

Children:

e8a4d3b1

Parents:

c2ab6f4

Message:

Add ISC-Kea DHCP server

File:

• networking/connect/kea.xml (modified) (10 diffs)

networking/connect/kea.xml

@@ -123 +123 @@
     </para>
 
-<screen role="root"><userinput>make install</userinput></screen>
-
-  </sect2>
-
+<screen role="root"><userinput>make -j1 install</userinput></screen>
+
+  </sect2>
+
+  <sect2 role="commands">
+    <title>Command Explanations</title>
+
+    <para>
+      <parameter>make -j1 install</parameter>: ISC doesn not recomment any form of
+      parallel or job server options when doing the install.
+    </para>
+
+  </sect2>
+  
   <sect2 role="configuration">
     <title>Configuring ISC Kea DHCP</title>
+
+    <para>Consult the 
+    <ulink url="https://kea.readthedocs.io/en/kea-2.2.0/">Kea Administrator Reference Manual</ulink>
+    for detailled information about the configuration of Kea.</para>
 
     <para>The support of IPv4, IPv6 and DDNS has been splitted into
     separate servers which runs independently from each other. Each
     of them has its own configuration file. Additional configuration
-    files come from the control agent which is uses to control the
+    files come from the keactrl agent which is uses to control the
     servers in an easy way.</para>
     
@@ -146 +160 @@
         <filename>/etc/kea/kea-dhcp-ddns.conf</filename>
       </para>
-<!--
+
       <indexterm zone="kea keactrl-config">
         <primary sortas="e-etc-kea-keactrl.conf">/etc/kea/keactrl.conf</primary>
       </indexterm>
-
+<!--
       <indexterm zone="kea kea-ctrl-agent-config">
         <primary sortas="e-etc-kea-kea-ctrl-agent.conf">/etc/kea/kea-ctrl-agent.conf</primary>
       </indexterm>
-
+-->
       <indexterm zone="kea kea-dhcp4-config">
         <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>
@@ -171 +185 @@
     <sect3 id="keactrl-config">
       <title>Kea Control Configuration</title>
-      
+
       <para><command>keactrl</command> is used to control the
       independend servers (IPv4, IPv6, DDNS). Its configuration file
@@ -183 +197 @@
         <listitem>
           <para>IPv4 DHCP server</para>
-          <para>Set <literal>dhcp4=yes</literal> to start it, set 
+          <para>This daemon handles requests for IPv4 addresses.
+          Set <literal>dhcp4=yes</literal> to start it, set 
           <literal>dhcp4=no</literal> in case DHCP service for IPv4
           is not wanted.</para>
@@ -189 +204 @@
         <listitem>
           <para>IPv6 DHCP server</para>
-          <para>Set <literal>dhcp6=yes</literal> to start it, set 
+          <para>This daemon handles requests for IPv6 addresses.
+          Set <literal>dhcp6=yes</literal> to start it, set 
           <literal>dhcp6=no</literal> in case DHCP service for IPv6
           is not wanted.</para>
@@ -195 +211 @@
         <listitem>
           <para>Dynamic DNS</para>
-          <para>Set <literal>dhcp_ddns=yes</literal> to enable it, set 
+          <para>This daemon is used to update a DNS server dynamically
+          when Kea assignes an IP address to a device. 
+          Set <literal>dhcp_ddns=yes</literal> to enable it, set 
           <literal>dhcp_ddns=no</literal> in case dynamic DNS updates
           are not wanted.</para>
@@ -201 +219 @@
         <listitem>
           <para>Control Agent</para>
-          <para>Set <literal>ctrl_agent=yes</literal> to start the
+          <para>The Control Agent is a daemon which allows the
+          (re)configuration of the Kea DHCP service via REST API.
+          Set <literal>ctrl_agent=yes</literal> to start the
           control agent (service providing a REST API), set
           <literal>ctrl_agent=no</literal> in case the control agent
@@ -210 +230 @@
       <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>
+
+<screen><userinput role="root">sed -e "s/^dhcp4=.*/dhcp4=yes/" \
+    -e "s/^dhcp6=.*/dhcp6=no/" \
+    -e "s/^dhcp_ddns=.*/dhcp_ddns=yes/" \
+    -e "s/^ctrl_agent=.*/ctrl_agent=no/" \
+    -i /etc/kea/keactrl.conf
+</userinput></screen>
+
     </sect3>
 
@@ -225 +259 @@
 <screen role="nodump" ><userinput>cat &gt; /etc/kea/kea-dhcpd4.conf &lt;&lt; "EOF"
 <literal>// Begin /etc/kea/kea-dhcpd4.conf
-
+{
 "Dhcp4": {
     "interfaces-config": {
@@ -286 +320 @@
     ]
 }
-
+}
 // End /etc/kea/kea-dhcpd4.conf</literal>
 EOF</userinput></screen>