Changeset 0dcde6e

Timestamp:

06/12/2023 04:20:38 PM (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:

da1d238

Parents:

baf6d5a0

Message:

Add ctrl-agent config as it needs also be tweaked to find the sockets in /run

File:

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

networking/connect/kea.xml

@@ -9 +9 @@
   <!ENTITY kea-md5sum        "64c75b4cdbe7b1208ab0929865d2bd12">
   <!ENTITY kea-size          "9.5 MB">
-  <!ENTITY kea-buildsize     "1.9 GB">
-  <!ENTITY kea-time          "5 SBU"> <!-- CHECK -->
+  <!ENTITY kea-buildsize     "1.1 GB">
+  <!ENTITY kea-time          "14 SBU"><!-- Thats unexpectedly long -->
   <!ENTITY kea-arm-vers      "2.2.0">
 ]>
@@ -126 +126 @@
             --localstatedir=/var \
             --enable-shell       \
-            --with-openssl &amp;&amp;
+            --with-openssl       \
+            --disable-static &amp;&amp;
 make</userinput></screen>
 
@@ -189 +190 @@
     which is a management dashboard to <application>ISC Kea</application>.</para>
 
+    <para>
+      If you want to start the DHCP Server at boot, install the
+      <phrase revision="sysv"><filename>/etc/rc.d/init.d/kea-dhcpd</filename>
+      init script</phrase>
+      <phrase revision="systemd"><filename>kea-dhcpd.service</filename>
+      unit</phrase> included in the
+      <xref linkend="bootscripts" revision="sysv"/>
+      <xref linkend="systemd-units" revision="systemd"/>
+      package:
+    </para>
+
+<screen role="root"><userinput>make install-kea-dhcpd</userinput></screen>
+
     <sect3 id="kea-dhcp-config">
       <title>Config Files</title>
@@ -203 +217 @@
         <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>
@@ -233 +247 @@
 
       <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.
+          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
+          is not needed.</para>
+        </listitem>
         <listitem>
           <para>IPv4 DHCP server</para>
@@ -255 +278 @@
           are not wanted.</para>
         </listitem>
-        <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.
-          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
-          is not needed.</para>
-        </listitem>
       </itemizedlist>
 
@@ -285 +299 @@
     </sect3>
 
+    <sect3 id="kea-ctrl-agent-config">
+      <title>Control Agent Configuration</title>
+
+      <para>
+        The provided configuration could be used without changes
+        but in BLFS objects like sockets are stored in 
+        <filename class="directory">/run</filename>
+        rather than in
+        <filename class="directory">/tmp</filename>.
+      </para>
+
+<screen role="nodump" ><userinput>cat &gt; /etc/kea/kea-ctrl-agent.conf &lt;&lt; "EOF"
+<literal>// Begin /etc/kea/kea-ctrl-agent.conf
+{
+  // This is a basic configuration for the Kea Control Agent.
+  // RESTful interface to be available at http://127.0.0.1:8000/
+  "Control-agent": {
+    "http-host": "127.0.0.1",
+    "http-port": 8000,
+    "control-sockets": {
+      "dhcp4": {
+        "socket-type": "unix",
+        "socket-name": "/run/kea4-ctrl-socket"
+      },
+      "dhcp6": {
+        "socket-type": "unix",
+        "socket-name": "/run/kea6-ctrl-socket"
+      },
+      "d2": {
+        "socket-type": "unix",
+        "socket-name": "/run/kea-ddns-ctrl-socket"
+      }
+    },
+
+    "loggers": [
+      {
+        "name": "kea-ctrl-agent",
+        "output_options": [
+          {
+            "output": "/var/log/kea-ctrl-agent.log"
+            "pattern": "%D{%Y-%m-%d %H:%M:%S.%q} %-5p %m\n"
+          }
+        ],
+        "severity": "INFO",
+        "debuglevel": 0
+      }
+    ]
+  }
+}
+// End /etc/kea/kea-ctrl-agent.conf</literal>
+EOF</userinput></screen>
+
+    </sect3>
+
     <sect3 id="kea-dhcp4-config">
       <title>IPv4 DHCP Server Configuration</title>
-
-      <para>
-        If you want to start the DHCP Server at boot, install the
-        <phrase revision="sysv"><filename>/etc/rc.d/init.d/kea-dhcpd</filename>
-        init script</phrase>
-        <phrase revision="systemd"><filename>kea-dhcpd.service</filename>
-        unit</phrase> included in the
-        <xref linkend="bootscripts" revision="sysv"/>
-        <xref linkend="systemd-units" revision="systemd"/>
-        package:
-      </para>
-
-<screen role="root"><userinput>make install-kea-dhcpd</userinput></screen>
 
       <para>
@@ -319 +374 @@
     "control-socket": {
       "socket-type": "unix",
-      "socket-name": "/tmp/kea4-ctrl-socket"
+      "socket-name": "/run/kea4-ctrl-socket"
     },
 
@@ -402 +457 @@
 
       <para>
-        If there is a <xref linkend="bind"/> server running, <application>ISC Kea</application>
-        can update the DNS when it gives an IP address to a client.
-        A sample configuration file is created in <filename>/etc/kea/kea-dhcp-ddns.conf</filename>.
+        If there is a <xref linkend="bind"/> server running,
+        <application>ISC Kea</application> can update the DNS when
+        it gives an IP address to a client. A sample configuration
+        file is created in <filename>/etc/kea/kea-dhcp-ddns.conf</filename>.
         Adjust the file to suit your needs or overwrite it by using
         the following sample as the <systemitem class="username">root</systemitem>
@@ -418 +474 @@
     "control-socket": {
       "socket-type": "unix",
-      "socket-name": "/tmp/kea-ddns-ctrl-socket"
+      "socket-name": "/run/kea-ddns-ctrl-socket"
     },
 
@@ -483 +539 @@
           provided by <xref linkend="bind"/>.
         </para>
+        <para>
+          In this sample config it is assumed that the DNS server
+          runs on the same machine as Kea does (accessable via
+          <literal>127.0.0.1</literal>) and that this machine has
+          the IP <literal>192.168.56.2</literal>.
+        </para>
       </note>
 
@@ -522 +584 @@
         <listitem>
           <para>
-            Tool to control the server processes
+            Tool to control (start/stop) the server processes
           </para>
           <indexterm zone="kea keactrl">
@@ -531 +593 @@
 
       <!-- ...to be completed... -->
+      <!--
+        kea-admin
+        kea-ctrl-agent
+        kea-dhcp4
+        kea-dhcp6
+        kea-dhcp-ddns
+        kea-lfc
+      -->
+
+      <varlistentry id="keashell">
+        <term><command>keashell</command></term>
+        <listitem>
+          <para>
+            RESTful client to the <application>ISC Kea</application>
+            services.
+          </para>
+          <indexterm zone="kea keashell">
+            <primary sortas="b-keashell">keashell</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
 
     </variablelist>