Kea DHCP Workshop @ Heise, November 2025

• Eine Root-Shell starten (Passwort kea-dhcp)

  [host]$ sudo -i
  

• In das Verzeichnis /root/lab/lab01 wechseln

  [host]% cd /root/lab/lab01
  

• Das ./run Shell-Skript ausführen, um die Container client und kea-server zu starten (Das Skript versucht ggf. alte Container zu beenden, sind diese [noch] nicht gestartet, so werden Fehlermeldungen ausgegeben, welche wir aber in diesem Fall ignorieren können)
• Prüfe mit dem Kommando running das die Container erfolgreich gestartet wurden

  [host]% running
  kea-server
  client
  

• In den Kea-DHCP-Server Container wechseln

[host]% enter kea-server

• Eine Kea DHCPv4 Konfigurationsdatei erstellen /etc/kea/kea-dhcp4.conf

{
"Dhcp4": {
    "interfaces-config": {
        "interfaces": [ "server-eth0" ],
        "dhcp-socket-type": "raw"
    },
    "control-socket": {
        "socket-type": "unix",
        "socket-name": "kea-dhcp4.socket"
    },
    "lease-database": {
        "type": "memfile",
        "lfc-interval": 3600
    },
    "renew-timer": 900,
    "rebind-timer": 1800,
    "valid-lifetime": 3600,
    "subnet4": [
        {
            "subnet": "192.0.2.0/24",
            "id": "1",
            "pools": [ { "pool": "192.0.2.100 - 192.0.2.200" } ],
            "option-data": [
                {
                    "name": "routers",
                    "data": "192.0.2.1"
                }
            ]
        }
    ]},
    "loggers": [
    {
        "name": "kea-dhcp4",
        "output_options": [
            {
                "output": "/var/log/kea/kea-dhcp4.log"
            }
        ],
        "severity": "INFO",
        "debuglevel": 0
    }
  ]
}
}

• Die neue Konfigurationsdatei auf Fehler prüfen. Die Vorlage oben hat zwei Fehler.

% kea-dhcp4 -t /etc/kea/kea-dhcp4.conf
Syntax check failed with: /etc/kea/kea-dhcp4.conf:29.7: syntax error, unexpected ",", expecting }

• Finden und berichtigen Sie den Fehler und prüfen Sie die Konfiguration erneut
  • Lösung: Bei ]}, vor loggers ist ein zusätzliches }, dies muss entfernt werden so das dort ], steht. Die Subnet-ID ist ein numerischer Wert, keine Zeichenkette, und darf daher nicht in Hochkommata stehen
• Beispiel eines erfolgreichen Tests der Konfigurationsdatei

% kea-dhcp4 -t /etc/kea/kea-dhcp4.conf
2025-04-01 10:31:54.260 INFO  [kea-dhcp4.hosts/183.139887242189504] HOSTS_BACKENDS_REGISTERED the following host backend types are available: mysql postgresql
2025-04-01 10:31:54.273 WARN  [kea-dhcp4.dhcpsrv/183.139887242189504] DHCPSRV_MT_DISABLED_QUEUE_CONTROL disabling dhcp queue control when multi-threading is enabled.
2025-04-01 10:31:54.275 WARN  [kea-dhcp4.dhcp4/183.139887242189504] DHCP4_RESERVATIONS_LOOKUP_FIRST_ENABLED Multi-threading is enabled and host reservations lookup is always performed first.
2025-04-01 10:31:54.287 INFO  [kea-dhcp4.dhcpsrv/183.139887242189504] DHCPSRV_CFGMGR_NEW_SUBNET4 a new subnet has been added to configuration: 192.0.2.0/24 with params: t1=900, t2=1800, valid-lifetime=3600
2025-04-01 10:31:54.299 INFO  [kea-dhcp4.dhcpsrv/183.139887242189504] DHCPSRV_CFGMGR_SOCKET_TYPE_SELECT using socket type raw
2025-04-01 10:31:54.300 INFO  [kea-dhcp4.dhcpsrv/183.139887242189504] DHCPSRV_CFGMGR_SOCKET_TYPE_SELECT using socket type raw
2025-04-01 10:31:54.304 INFO  [kea-dhcp4.dhcpsrv/183.139887242189504] DHCPSRV_CFGMGR_ADD_IFACE listening on interface server-eth0

• Starte den Kea DHCPv4 Server mittels Systemd

% systemctl start kea-dhcp4

• Prüfen Sie den Status des Dienstes

% systemctl status kea-dhcp4
● kea-dhcp4.service - Kea DHCPv4 Server
     Loaded: loaded (/usr/lib/systemd/system/kea-dhcp4.service; disabled; preset: disabled)
    Drop-In: /usr/lib/systemd/system/service.d
             └─10-timeout-abort.conf, 50-keep-warm.conf
     Active: active (running) since Tue 2025-04-01 10:34:29 UTC; 10s ago
 Invocation: 3a86492b55794c98876ba33718e9d3c3
       Docs: man:kea-dhcp4(8)
   Main PID: 194 (kea-dhcp4)
      Tasks: 6 (limit: 307)
     Memory: 2.8M (peak: 2.9M)
        CPU: 49ms
     CGroup: /system.slice/kea-dhcp4.service
             └─194 /usr/sbin/kea-dhcp4 -c /etc/kea/kea-dhcp4.conf

Apr 01 10:34:29 320a0c22ba80 systemd[1]: Started kea-dhcp4.service - Kea DHCPv4 Server.
Apr 01 10:34:29 320a0c22ba80 kea-dhcp4[194]: 2025-04-01 10:34:29.768 INFO  [kea-dhcp4.dhcp4/194.140439869610688] DHCP4_STARTING Kea DHCPv4 server version 2.6.1 (stable) starting
Apr 01 10:34:29 320a0c22ba80 kea-dhcp4[194]: 2025-04-01 10:34:29.770 INFO  [kea-dhcp4.commands/194.140439869610688] COMMAND_RECEIVED Received command 'config-set'

• Benutzen Sie ein weiteres Terminal auf den Server (via tmux oder weitere Browser-Reiter)
• Wechseln Sie in den Client-Container

% enter client

• Die Netzwerk-Schnittstelle client-eth0 hat keine IP-Konfiguration

# ip addr show
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
    link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
    inet 127.0.0.1/8 scope host lo
       valid_lft forever preferred_lft forever
    inet6 ::1/128 scope host
       valid_lft forever preferred_lft forever
10: client-eth0@if9: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UP group default qlen 1000
    link/ether fa:34:f8:0e:a4:ff brd ff:ff:ff:ff:ff:ff link-netnsid 1
    inet6 fe80::f834:f8ff:fe0e:a4ff/64 scope link
       valid_lft forever preferred_lft forever

• Starten Sie den DHCP-Client manuell

[client]% dhclient -v client-eth0
Internet Systems Consortium DHCP Client 4.4.2b1
Copyright 2004-2019 Internet Systems Consortium.
All rights reserved.
For info, please visit https://www.isc.org/software/dhcp/

Listening on LPF/client-eth0/72:28:b2:66:0d:f5
Sending on   LPF/client-eth0/72:28:b2:66:0d:f5
Sending on   Socket/fallback
DHCPDISCOVER on client-eth0 to 255.255.255.255 port 67 interval 3 (xid=0xb1f0b267)
DHCPOFFER of 192.0.2.100 from 192.0.2.1
DHCPREQUEST for 192.0.2.100 on client-eth0 to 255.255.255.255 port 67 (xid=0xb1f0b267)
DHCPACK of 192.0.2.100 from 192.0.2.1 (xid=0xb1f0b267)
bound to 192.0.2.100 -- renewal in 847 seconds.

• Auf dem Kea DHCP Server wurde eine Lease-Datei angelegt

[kea-server]% cat /var/lib/kea/kea-leases4.csv
address,hwaddr,client_id,valid_lifetime,expire,subnet_id,fqdn_fwd,fqdn_rev,hostname,state
192.0.2.100,9e:81:8f:31:62:85,ff:8f:31:62:85:00:04:22:6c:05:90:05:96:45:33:8d:ab:47:f1:1b:bf:66:0a,3600,1544097000,1,0,0,,0

• Der Socket für die Kommunikation mit dem Kea Control-Agent wird in der Kea-Server-Konfigurationsdatei Datei definiert. Stellen Sie sicher, dass die Socket-Definition für den DHCPv4 Server wie folgt aussieht:

{
    "Dhcp4": {
        "control-socket": {
            "socket-type": "unix",
            "socket-name": "kea-dhcp4.socket"
        },
        "valid-lifetime": 3600,
[...]

• Testen Sie die Konfiguration und starten Sie den Dienst neu

[kea-server]% kea-dhcp4 -t /etc/kea/kea-dhcp4.conf
[kea-server]% systemctl restart kea-dhcp4

• Erzeugen Sie eine Konfigurationsdatei für den Kea Control-Agent im Kea DHCP Server Container unter /etc/kea/kea-ctrl-agent.conf. Diese Konfiguration bedingt das der Kea Control Agent auf der IPv6 Loopback-Adresse, Port 9099, auf Anfragen via HTTP-REST API wartet:

{
    "Control-agent": {
        "http-host": "::1",
        "http-port": 9099,
        "control-sockets": {
            "dhcp4": {
                "socket-type": "unix",
                "socket-name": "kea-dhcp4.socket"
            }
        },
        "loggers": [
            {
                "name": "kea-ctrl-agent",
                "severity": "INFO",
                "output_options": [
                    {
                    "output": "/var/log/kea/kea-ctrl-agent.log"
                    }
                ]
            }
        ]
    }
}

• Testen Sie die Konfiguration auf Fehler

[kea-server]% kea-ctrl-agent -t /etc/kea/kea-ctrl-agent.conf

• Starten Sie die Kea Control-Agent

[kea-server]% systemctl start kea-ctrl-agent
[kea-server]% systemctl status kea-ctrl-agent
● kea-ctrl-agent.service - Kea Control Agent
   Loaded: loaded (/etc/systemd/system/kea-ctrl-agent.service; disabled; vendor preset: disabled)
   Active: active (running) since Sun 2018-12-09 21:33:12 UTC; 1s ago
     Docs: man:kea-ctrl-agent(8)
 Main PID: 361 (kea-ctrl-agent)
    Tasks: 1 (limit: 1144)
   Memory: 1.8M
   CGroup: /machine.slice/libpod-5c5b9d031716ba7b04e2726f7c6f7ef48cdd95d4bbac8c51e7fb591fb7c900c1.scope/system.slice/kea-ctrl-agent.service
           └─361 /usr/sbin/kea-ctrl-agent -c /etc/kea/kea-ctrl-agent.conf

Dec 09 21:33:12 5c5b9d031716 systemd[1]: Started Kea Control Agent.
Dec 09 21:33:12 5c5b9d031716 kea-ctrl-agent[361]: 2018-12-09 21:33:12.528 INFO  [kea-ctrl-agent.dctl/361] DCTL_STARTING Control-agent starting, pid: 361, version: 1.3.0
Dec 09 21:33:12 5c5b9d031716 kea-ctrl-agent[361]: 2018-12-09 21:33:12.531 INFO  [kea-ctrl-agent.ctrl-agent/361] CTRL_AGENT_HTTP_SERVICE_STARTED HTTP service bound to address ::1:90>
Dec 09 21:33:12 5c5b9d031716 kea-ctrl-agent[361]: 2018-12-09 21:33:12.531 INFO  [kea-ctrl-agent.dctl/361] DCTL_CONFIG_COMPLETE server has completed configuration: listening on ::1,>

• API Kommandos können mittels curl getestet werden. Im folgenden Beispiel wird das config-get Kommando an den DHCPv4 Server gesendet:

[kea-server]% curl --json '{ "command": "config-get", "service": [ "dhcp4" ] }' http://[::1]:9099/

• Die Ausgabe ist unformatiertes JSON. Mit dem Programm jq kann die Ausgabe verschönert werden

[kea-server]% curl --no-progress-meter --json '{ "command": "config-get", "service": [ "dhcp4" ] }' \
   http://[::1]:9099/ | jq .

• jq kann auch dazu benutzt werden, um Teile der JSON Ausgabe zu filtern. Der jq Filter ".[0].arguments" erzeugt zusammen mit config-get ein Teil der Kea Konfigurationsdatei:

[kea-server]% curl --no-progress-meter -s --json '{ "command": "config-get", "service": [ "dhcp4" ] }' \
  http://[::1]:9099/ | jq ".[0].arguments.Dhcp4.loggers"
[
  {
    "debuglevel": 0,
    "name": "kea-dhcp4",
    "output_options": [
      {
        "output": "/var/log/kea/kea-dhcp4.log"
      }
    ],
    "severity": "INFO"
  }
]

• Das API Kommando list-commands liefert alle API Kommandos eines Kea Moduls

[kea-server]% curl --no-progress-meter --json \
  '{ "command": "list-commands", "service": [ "dhcp4" ] }' \
  http://[::1]:9099/ | jq

• Die Kea-DHCP Konfiguration über das Netzwerk in die Datei kea-dhcp4.tmp kopieren

[kea-server]% curl --no-progress-meter -s \
     --json '{ "command": "config-get",  "service": [ "dhcp4" ] }' \
     http://[::1]:9099/ | jq ".[0]" > kea-dhcp4.tmp

• Editieren Sie die Datei, fügen sie die command und service Informationen hinzu und entfernen Sie die result und die hash Struktur am Ende der Datei. Machen Sie Änderungen an der Konfiguration des DHCP Servers, fügen Sie einen "user-context" auf der globalen Ebene hinzu:

{
  "command": "config-set",
  "service": [ "dhcp4" ],
  "arguments": {
    "Dhcp4": {
      "user-context": {
          "Kommentar": "Dies ist ein Kommentar im User-Context",
          "comment": "/user-context/ Blöcke können beliebige JSON Strukturen beinhalten",
          "Kommentti": "Die User-Context Blöcke werden vom Kea-Parser geladen, aber von Kea-Server nicht beachtet"
      },
      "authoritative": false,
      "boot-file-name": "",
      "calculate-tee-times": false,
[...]

• Senden Sie die neue Konfiguration zum Server

[kea-server]% curl --no-progress-meter -s -X POST \
   -H "Content-Type: application/json" \
   -d @kea-dhcp4.tmp http://[::1]:9099/ | jq

• Die erfolgreiche Rückmeldung vom Server

[
  {
    "arguments": {
      "hash": "E919FB6D9AD2F3732843474B49DCD6552833EA96C85FD5BF3A34E1B8CFC6922D"
    },
    "result": 0,
    "text": "Configuration successful."
  }
]

• Alle dynamischen Änderungen werden auf dem Server im Hauptspeicher vorgenommen. Um diese Änderungen dauerhaft zu speichern muss die aktuelle Konfiguration des Servers wieder in eine Konfigurationsdatei geschrieben werden (Achtung! Alle Kommentare und die Formatierung und Sortierung der Konfiguration geht verloren)

[kea-server]% curl --no-progress-meter -s -X POST -H "Content-Type: application/json" \
                   -d '{ "command": "config-write", "arguments": { "filename": "/etc/kea/kea-dhcp4-new.json" }, "service": [ "dhcp4" ] }' \
                   http://[::1]:9099/ | jq

• Wenn der Kea-DHCP4-Server die Datei nicht schreiben kann:
  • Ist das Verzeichnis /etc/kea schreibbar für den Benutzer kea?
  • Gehört die Datei /etc/kea/kea-dhcp4.conf dem Benutzer kea?
  • Lösung:

    # chmod -R u+rw /etc/kea
    # chown -R kea  /etc/kea
    

• Erfolgreiche Bestätigung vom Server

[
  {
    "arguments": {
      "filename": "/etc/kea/kea-dhcp4-new.json",
      "size": 3248
    },
    "result": 0,
    "text": "Configuration written to /etc/kea/kea-dhcp4-new.json successful"
  }
]

• Kea-Cookbook: How to add a new subnet via the REST API https://kea-cookbook.de/post/2025/03/20/how-to-add-a-new-subnet-via-the-rest-api/

• Der ISC DHCP Client (Bestandteil der meisten Linux/Unix Systeme) delegiert die Konfiguration des TCP/IP Stacks des Betriebssystems einem Shell-Script.
• Die im DHCP Paket gespeicherten DHCP Daten werden über Umgebungsvariablen an das Shell-Skript übergeben. Diese Variablen können mittels des env Befehls ausgegeben werden
• Stoppen Sie den ggf. schon gestarteten dhclient Prozess

  [client]% dhclient -r
  

• Starten Sie dhclient Programm mit dem Programm /usr/bin/env und betrachten Sie die Ausgabe

  [client]% dhclient -v -sf /usr/bin/env client-eth0
  

• Analysieren Sie auf dem Kea-DHCP-Server die DHCP Kommunikation zwischen dem DHCP Relay-Agent und dem DHCP-Server mittels tcpdump

  [kea-server]% tcpdump -vv -i server-eth0 port 67 or port 68
  

• Starten Sie eine neue DHCP Lease Anfrage vom Client Container (dhclient -r gibt die aktuell gehaltene Lease frei).

  [client]% dhclient -r
  [client]% dhclient -v -sf /usr/bin/env client-eth0
  

• Verlassen Sie den Kea-Server und den Client Container
• Führen Sie die Skripte ./stop und ./clean auf dem Host aus (im Verzeichnis /root/lab/lab01)

• Arbeiten Sie im Verzeichnis lab02 und starten Sie von dort die Lab-Container

[host]% cd /root/lab/lab02
[host]% ./run

• Starten Sie den DHCPv4 Relay Agent im Container relay

[host]% enter relay

• Das Relay-Agent Programm wartet auf DHCPv4 Broadcast-Pakete auf der Netzwerkschnittstelle relay1-eth0 und leitet diese Pakete an den Kea DHCP Server auf der Adresse 100.64.0.1 weiter

[relay]%  dhcrelay -id relay1-eth0 -iu relay2-eth0 -d 100.64.0.1
Requesting: relay1-eth0 as upstream: N downstream: Y
Requesting: relay2-eth0 as upstream: Y downstream: N
Dropped all unnecessary capabilities.
Internet Systems Consortium DHCP Relay Agent 4.4.2b1
Copyright 2004-2019 Internet Systems Consortium.
All rights reserved.
For info, please visit https://www.isc.org/software/dhcp/
Listening on LPF/relay2-eth0/d2:90:88:da:b9:48
Sending on   LPF/relay2-eth0/d2:90:88:da:b9:48
Listening on LPF/relay1-eth0/f6:94:7a:a5:69:9d
Sending on   LPF/relay1-eth0/f6:94:7a:a5:69:9d
Sending on   Socket/fallback
Dropped all capabilities.

• In einem anderen Terminal wechseln Sie in den Kea DHCP Server Container

[host]% enter kea-server

• Die die DHCP Anfragen von Client-Systemen nun vom Relay-Agent über UDP eintreffen können wir die Kea-DHCPv4 Konfiguration auf UDP Socket umstellen: "dhcp-socket-type": "udp"
• Bearbeiten Sie die Datei /etc/kea/kea-dhcp4.conf:

{
"Dhcp4": {
    "interfaces-config": {
        "interfaces": [ "server-eth0" ],
        "dhcp-socket-type": "udp"
    },
[...]

• Testen Sie die Kea DHCPv4 Konfigurationsdatei

[kea-server]% kea-dhcp4 -t /etc/kea/kea-dhcp4.conf

• Starten Sie den Kea-DHCPv4 Server neu

[kea-server]% systemctl start kea-dhcp4
[kea-server]% systemctl status kea-dhcp4
● kea-dhcp4.service - Kea DHCPv4 Server
   Loaded: loaded (/usr/lib/systemd/system/kea-dhcp4.service; disabled; vendor preset: disabled)
   Active: active (running) since Thu 2018-12-06 20:26:05 UTC; 3s ago
     Docs: man:kea-dhcp4(8)
 Main PID: 47 (kea-dhcp4)
    Tasks: 1 (limit: 1144)
   Memory: 9.2M
   CGroup: /machine.slice/libpod-131e8c63aa04d242f4f9c4037b0106eb88a56b03b2bf6e639e306df2e06dd09c.scope/system.slice/kea-dhcp4.service
           └─47 /usr/sbin/kea-dhcp4 -c /etc/kea/kea-dhcp4.conf

Dec 06 20:26:05 131e8c63aa04 systemd[1]: Started Kea DHCPv4 Server.
Dec 06 20:26:05 131e8c63aa04 kea-dhcp4[47]: 2018-12-06 20:26:05.450 INFO  [kea-dhcp4.dhcp4/47] DHCP4_STARTING Kea DHCPv4 server version 1.3.0 starting
Dec 06 20:26:05 131e8c63aa04 kea-dhcp4[47]: 2018-12-06 20:26:05.457 INFO  [kea-dhcp4.dhcpsrv/47] DHCPSRV_CFGMGR_SOCKET_TYPE_SELECT using socket type udp
Dec 06 20:26:05 131e8c63aa04 kea-dhcp4[47]: 2018-12-06 20:26:05.458 INFO  [kea-dhcp4.dhcpsrv/47] DHCPSRV_CFGMGR_ADD_IFACE listening on interface server-eth0
Dec 06 20:26:05 131e8c63aa04 kea-dhcp4[47]: 2018-12-06 20:26:05.465 INFO  [kea-dhcp4.dhcpsrv/47] DHCPSRV_CFGMGR_NEW_SUBNET4 a new subnet has been added to configuration: 192.0.2.0/24 wit>
Dec 06 20:26:05 131e8c63aa04 kea-dhcp4[47]: 2018-12-06 20:26:05.466 INFO  [kea-dhcp4.dhcp4/47] DHCP4_CONFIG_COMPLETE DHCPv4 server has completed configuration: added IPv4 subnets: 1; DDN>
Dec 06 20:26:05 131e8c63aa04 kea-dhcp4[47]: 2018-12-06 20:26:05.467 INFO  [kea-dhcp4.dhcpsrv/47] DHCPSRV_MEMFILE_DB opening memory file lease database: lfc-interval=3600 type=memfile uni>
Dec 06 20:26:05 131e8c63aa04 kea-dhcp4[47]: 2018-12-06 20:26:05.469 INFO  [kea-dhcp4.dhcpsrv/47] DHCPSRV_MEMFILE_LEASE_FILE_LOAD loading leases from file /var/lib/kea/kea-leases4.csv
Dec 06 20:26:05 131e8c63aa04 kea-dhcp4[47]: 2018-12-06 20:26:05.470 INFO  [kea-dhcp4.dhcpsrv/47] DHCPSRV_MEMFILE_LFC_SETUP setting up the Lease File Cleanup interval to 3600 sec

• Wechseln Sie innerhalb eines dritten Terminals in den Client Container

[host]% enter client

• Fordern Sie mit dem dhclient Programm eine neue DHCP Lease an

[client]% dhclient -v client-eth0
Internet Systems Consortium DHCP Client 4.3.6
Copyright 2004-2017 Internet Systems Consortium.
All rights reserved.
For info, please visit https://www.isc.org/software/dhcp/

Listening on LPF/client-eth0/b2:b9:2e:f6:5e:65
Sending on   LPF/client-eth0/b2:b9:2e:f6:5e:65
Sending on   Socket/fallback
DHCPDISCOVER on client-eth0 to 255.255.255.255 port 67 interval 6 (xid=0xe8e47a25)
DHCPREQUEST on client-eth0 to 255.255.255.255 port 67 (xid=0xe8e47a25)
DHCPOFFER from 192.0.2.1
DHCPACK from 192.0.2.1 (xid=0xe8e47a25)
bound to 192.0.2.109 -- renewal in 847 seconds.

• Log-Ausgabe auf dem DHCP Relay

Forwarded BOOTREQUEST for b2:b9:2e:f6:5e:65 to 100.64.0.1
Forwarded BOOTREPLY for b2:b9:2e:f6:5e:65 to 192.0.2.109
Forwarded BOOTREQUEST for b2:b9:2e:f6:5e:65 to 100.64.0.1
Forwarded BOOTREPLY for b2:b9:2e:f6:5e:65 to 192.0.2.109

• Verlassen Sie die client, relay und kea-server Container
• Führen Sie die Skripte ./stop und ./clean im Verzeichnis /root/lab/lab02/ auf dem Host aus

• DHCP Relay Agent 007

• https://github.com/westermo/dhcp-helper
• https://github.com/sonic-net/sonic-dhcp-relay
• https://github.com/eait-itig/dhcp-relay
• https://github.com/pyke369/pdhcp

• Wechseln Sie in das Verzeichnis /root/lab/lab03 auf dem Host
• Führen Sie das ./run Skript aus

• Wechseln Sie in den kea-server Container

  % enter kea-server
  

• Fügen Sie der Kea DHCPv4 Konfiguration ein neues Subnetz 198.100.51.0/24 hinzu

[...]
    "subnet4": [
        {
            "subnet": "192.0.2.0/24",
	    "id": 1000,
            "pools": [ { "pool": "192.0.2.100 - 192.0.2.200" } ],
            "option-data": [
                {
                    "name": "routers",
                    "data": "192.0.2.1"
                }
            ]
        },
        {
            "subnet": "198.100.51.0/24",
	    "id": 2000,
            "pools": [ { "pool": "198.100.51.50 - 198.100.51.90" } ],
            "option-data": [
                {
                    "name": "routers",
                    "data": "198.100.51.1"
                }
            ]
        }
[...]

• Testen Sie die neue Konfiguration

[kea-server]% kea-dhcp4 -t /etc/kea/kea-dhcp4.conf
INFO  [kea-dhcp4.dhcpsrv/48] DHCPSRV_CFGMGR_SOCKET_TYPE_SELECT using socket type udp
INFO  [kea-dhcp4.dhcpsrv/48] DHCPSRV_CFGMGR_ADD_IFACE listening on interface server-eth0
INFO  [kea-dhcp4.dhcpsrv/48] DHCPSRV_CFGMGR_NEW_SUBNET4 a new subnet has been added to configuration: 192.0.2.0/24 with params: t1=900, t2=1800, valid-lifetime=3600
INFO  [kea-dhcp4.dhcpsrv/48] DHCPSRV_CFGMGR_NEW_SUBNET4 a new subnet has been added to configuration: 198.100.51.0/24 with params: t1=900, t2=1800, valid-lifetime=3600

• Starten Sie die Kea DHCPv4 Server und stellen Sie sicher das der Dienst ohne Fehler gestartet wurde

[kea-server]% systemctl start kea-dhcp4
[kea-server]% systemctl status kea-dhcp4
● kea-dhcp4.service - Kea DHCPv4 Server
   Loaded: loaded (/usr/lib/systemd/system/kea-dhcp4.service; disabled; vendor preset: disabled)
   Active: active (running) since Fri 2018-12-07 06:26:46 UTC; 5s ago
     Docs: man:kea-dhcp4(8)
 Main PID: 54 (kea-dhcp4)
    Tasks: 1 (limit: 1144)
   Memory: 1.9M
   CGroup: /machine.slice/libpod-86d66477595de7e99c051c8f5b9c224d5e566cdbd3edbd5562a8b6fe09bc241a.scope/system.slice/kea-dhcp4.service
           └─54 /usr/sbin/kea-dhcp4 -c /etc/kea/kea-dhcp4.conf

Dec 07 06:26:46 86d66477595d systemd[1]: Started Kea DHCPv4 Server.
Dec 07 06:26:46 86d66477595d kea-dhcp4[54]: 2018-12-07 06:26:46.515 INFO  [kea-dhcp4.dhcp4/54] DHCP4_STARTING Kea DHCPv4 server version 1.3.0 starting
Dec 07 06:26:46 86d66477595d kea-dhcp4[54]: 2018-12-07 06:26:46.518 INFO  [kea-dhcp4.dhcpsrv/54] DHCPSRV_CFGMGR_SOCKET_TYPE_SELECT using socket type udp
Dec 07 06:26:46 86d66477595d kea-dhcp4[54]: 2018-12-07 06:26:46.518 INFO  [kea-dhcp4.dhcpsrv/54] DHCPSRV_CFGMGR_ADD_IFACE listening on interface server-eth0
Dec 07 06:26:46 86d66477595d kea-dhcp4[54]: 2018-12-07 06:26:46.519 INFO  [kea-dhcp4.dhcpsrv/54] DHCPSRV_CFGMGR_NEW_SUBNET4 a new subnet has been added to configuration: 192.0.2.0/24 wit>
Dec 07 06:26:46 86d66477595d kea-dhcp4[54]: 2018-12-07 06:26:46.519 INFO  [kea-dhcp4.dhcpsrv/54] DHCPSRV_CFGMGR_NEW_SUBNET4 a new subnet has been added to configuration: 198.100.51.0/24 >
Dec 07 06:26:46 86d66477595d kea-dhcp4[54]: 2018-12-07 06:26:46.519 INFO  [kea-dhcp4.dhcp4/54] DHCP4_CONFIG_COMPLETE DHCPv4 server has completed configuration: added IPv4 subnets: 2; DDN>
Dec 07 06:26:46 86d66477595d kea-dhcp4[54]: 2018-12-07 06:26:46.520 INFO  [kea-dhcp4.dhcpsrv/54] DHCPSRV_MEMFILE_DB opening memory file lease database: lfc-interval=3600 type=memfile uni>
Dec 07 06:26:46 86d66477595d kea-dhcp4[54]: 2018-12-07 06:26:46.521 INFO  [kea-dhcp4.dhcpsrv/54] DHCPSRV_MEMFILE_LEASE_FILE_LOAD loading leases from file /var/lib/kea/kea-leases4.csv
Dec 07 06:26:46 86d66477595d kea-dhcp4[54]: 2018-12-07 06:26:46.521 INFO  [kea-dhcp4.dhcpsrv/54] DHCPSRV_MEMFILE_LFC_SETUP setting up the Lease File Cleanup interval to 3600 sec

• In einem neuen Terminal, wechseln sie in den Relay Container und starten Sie den ISC Relay Agent

  % enter relay
  

• Starten Sie den Relay Agent (zwei Client Netze!)

[relay]% dhcrelay -id relay1-eth0 -id relay2-eth0 -iu relay3-eth0 -d 100.64.0.1
Requesting: relay1-eth0 as upstream: N downstream: Y
Requesting: relay2-eth0 as upstream: N downstream: Y
Requesting: relay3-eth0 as upstream: Y downstream: N
Dropped all unnecessary capabilities.
Internet Systems Consortium DHCP Relay Agent 4.3.6
Copyright 2004-2017 Internet Systems Consortium.
All rights reserved.
For info, please visit https://www.isc.org/software/dhcp/
Listening on LPF/relay3-eth0/8e:07:03:58:67:e4
Sending on   LPF/relay3-eth0/8e:07:03:58:67:e4
Listening on LPF/relay2-eth0/46:eb:a0:16:f0:8b
Sending on   LPF/relay2-eth0/46:eb:a0:16:f0:8b
Listening on LPF/relay1-eth0/26:fd:31:a7:6f:42
Sending on   LPF/relay1-eth0/26:fd:31:a7:6f:42
Sending on   Socket/fallback
Dropped all capabilities.

• Testen Sie die DHCP Clients von den Client Containern clientA und clientB

[host]% enter clientA
[clientA]% dhclient -v client1-eth0
[host]% enter clientB
[clientB]% dhclient -v client2-eth0

• ClientA wird eine IP-Adresse von DHCP Server bekommen, aber ClientB bekommt keine IP-Adresse. Warum?
• Prüfen Sie die Logdatei des Kea-Servers unter /var/log/kea/kea-dhcp4.log
• Vergleichen Sie die IP-Adressen auf dem Relay-Agent mit den IP-Adressen in der Kea-DHCPv4 Konfiguration

• Berichtigen Sie die Konfiguration (198.51.100.0/24 anstatt 198.100.51.0/24):

[...]
    "subnet4": [
        {
            "subnet": "192.0.2.0/24",
	    "id": 1000,
            "pools": [ { "pool": "192.0.2.100 - 192.0.2.200" } ],
            "option-data": [
                {
                    "name": "routers",
                    "data": "192.0.2.1"
                }
            ]
        },
        {
            "subnet": "198.51.100.0/24",
	    "id": 2000,
            "pools": [ { "pool": "198.51.100.50 - 198.51.100.90" } ],
            "option-data": [
                {
                    "name": "routers",
                    "data": "198.51.100.1"
                }
            ]
        }

[...]

• Testen Sie die neue Konfiguration und starten Sie die Kea-DHCP Server neu, wiederholen Sie den Test von ClientB

• Kea DHCP unterstützt Reservierungen für Leases basierend auf der Hardware-Adresse der Netzwerk-Schnittstelle (MAC-Adresse), der DHCP Unique ID (DUID), der Circut-ID des Relay-Agents oder der Client-ID.
• Ermitteln Sie die Hardware Adresse der Netzwerkschnittstelle des ClientA Containers mit dem Befehl ip link show und erstellen Sie eine Reservierung in der Kea DHCPv4 Konfiguration

[...]
        "subnet4": [
            {
                "subnet": "192.0.2.0/24",
                "id": 1000,
                "pools": [
                    {
                        "pool": "192.0.2.100 - 192.0.2.200"
                    }
                ],
                "option-data": [
                    {
                        "name": "routers",
                        "data": "192.0.2.1"
                    },
                    {
                        "name": "domain-name",
                        "data": "a.example.com"
                    }
                ],
                "reservations": [
                    {
                        "hw-address": "xx:xx:xx:xx:xx:xx",
                        "ip-address": "192.0.2.210",
                        "hostname": "client.a"
                    }
                ]
            },
[...]

• Testen Sie die Konfiguration und starten Sie den Kea Server Dienst neu
• Testen Sie von clientA das die reservierte IP-Adresse dem Client zugewiesen wird und das der Hostname übermittelt wird:

[clientA]% dhclient -r
Killed old client process
[ClientA]% dhclient -v -sf /usr/bin/env client1-eth0  | grep host_name
Internet Systems Consortium DHCP Client 4.3.6
Copyright 2004-2017 Internet Systems Consortium.
All rights reserved.
For info, please visit https://www.isc.org/software/dhcp/

Listening on LPF/client1-eth0/6a:52:4e:6c:ee:3d
Sending on   LPF/client1-eth0/6a:52:4e:6c:ee:3d
Sending on   Socket/fallback
DHCPREQUEST on client1-eth0 to 255.255.255.255 port 67 (xid=0xa4d0bd0c)
DHCPACK from 192.0.2.1 (xid=0xa4d0bd0c)
requested_host_name=1
new_host_name=client.a
bound to 192.0.2.210 -- renewal in 833 seconds.

• Das Prüfen der verschiedenen Client-Merkmale für DHCP Reservierungen kann den Kea DHCP Server verlangsamen. Indem wir dem Kea DHCP Server über die Konfiguration mitteilen, welche Merkmale in dieser Installation verwendet werden, kann die Geschwindigkeit der DHCP-Antworten erhöht werden:

[...]
	"reservations-global": false,
	"reservations-in-subnet": true,
	"reservations-out-of-pool": true,
        "host-reservation-identifiers": [ "duid", "hw-address" ],
[...]

• In dieser Übung wird das Subntz eines Shared-Networks über die Vendor-Option (Option 60) ausgewählt. Kea-DHCP erstellt automatische Vendor-Klassen.
• Bei den in dieser Übung verwendeten Vendor-Optionen handelt es sich um Beispiele und nicht um die realen Werte der Hersteller:

"shared-networks": [
    {
        "name": "kea-lab01",
        "relay": {
            "ip-addresses": [ "192.0.2.1" ]
        },
        "subnet4": [
            {
                "subnet": "192.0.2.0/26",
                "id": 1000,
                "client-classes": [ "VENDOR_CLASS_windowsXP" ], # <-- Windows XP Clients will get IP
		                                                # from this subnet
                "option-data": [
                    {
                        "name": "routers",
                        "data": "192.0.2.1"
                    }
                ],
                "pools": [
                    {
                        "pool": "192.0.2.60 - 192.0.2.63"
                    }
                ]
            },
            {
                "subnet": "10.0.0.0/24",
                "id": 1001,
                "client-classes": [ "VENDOR_CLASS_fedoraLinux" ], # <-- Fedora-Linux Clients will get IP
		                                                  # from this subnet
                "option-data": [
                    {
                        "name": "routers",
                        "data": "10.0.0.1"
                    }
                ],
                "pools": [
                    {
                        "pool": "10.0.0.10 - 10.0.0.11"
                    }
                ]
            }
        ]
    }
],
[...]

• Teste die Konfiguration und starte den Kea-DHCP Server neu
• Anfrage einer DHCP Lease mit der Vendor-Option fedoraLinux

[clientA]% dhclient -r
Killed old client process
[clientA]% dhclient -v -V fedoraLinux
Internet Systems Consortium DHCP Client 4.3.6
Copyright 2004-2017 Internet Systems Consortium.
All rights reserved.
For info, please visit https://www.isc.org/software/dhcp/

Listening on LPF/client1-eth0/1e:d8:f9:75:80:a6
Sending on   LPF/client1-eth0/1e:d8:f9:75:80:a6
Sending on   Socket/fallback
DHCPREQUEST on client1-eth0 to 255.255.255.255 port 67 (xid=0xdf55944)
DHCPREQUEST on client1-eth0 to 255.255.255.255 port 67 (xid=0xdf55944)
DHCPDISCOVER on client1-eth0 to 255.255.255.255 port 67 interval 8 (xid=0x61d13664)
DHCPREQUEST on client1-eth0 to 255.255.255.255 port 67 (xid=0x61d13664)
DHCPOFFER from 192.0.2.1
DHCPACK from 192.0.2.1 (xid=0x61d13664)
bound to 10.0.0.11 -- renewal in 728 seconds.

• Anfrage einer DHCP Lease mit der Vendor-Option windowsXP

[clientA]% dhclient -r
Killed old client process
[clientA]% dhclient -v -V windowsXP
Internet Systems Consortium DHCP Client 4.3.6
Copyright 2004-2017 Internet Systems Consortium.
All rights reserved.
For info, please visit https://www.isc.org/software/dhcp/

Listening on LPF/client1-eth0/1e:d8:f9:75:80:a6
Sending on   LPF/client1-eth0/1e:d8:f9:75:80:a6
Sending on   Socket/fallback
DHCPREQUEST on client1-eth0 to 255.255.255.255 port 67 (xid=0xdcc6561e)
DHCPNAK from 192.0.2.1 (xid=0xdcc6561e)
DHCPDISCOVER on client1-eth0 to 255.255.255.255 port 67 interval 7 (xid=0xa3479029)
DHCPREQUEST on client1-eth0 to 255.255.255.255 port 67 (xid=0xa3479029)
DHCPOFFER from 192.0.2.1
DHCPACK from 192.0.2.1 (xid=0xa3479029)
bound to 192.0.2.60 -- renewal in 854 seconds.

• Füge die Debug-Ausgabe für Client-Class Entscheidungen im Kea-DHCP hinzu (Datei /etc/kea/kea-dhcp4.conf)

"loggers": [
   [...]
   {
    "name": "kea-dhcp4.eval",
    "output_options": [ {
        "output": "/var/log/kea/kea-dhcp4-eval.log"
    } ],
    "severity": "DEBUG",
    "debuglevel": 55
   }
]

• Beispiel-Ausgabe in der Logdatei /var/log/kea/kea-dhcp4-eval.log

2021-10-01 09:42:02.503 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_OPTION Pushing option 60 with value 0x
2021-10-01 09:42:02.504 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_STRING Pushing text string '0'
2021-10-01 09:42:02.504 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_STRING Pushing text string '3'
2021-10-01 09:42:02.504 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_SUBSTRING_EMPTY Popping length 3, start 0, string 0x pushing result 0x
2021-10-01 09:42:02.504 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_STRING Pushing text string 'win'
2021-10-01 09:42:02.504 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_EQUAL Popping 0x77696E and 0x pushing result 'false'
2021-10-01 09:42:02.504 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_OPTION Pushing option 60 with value 0x
2021-10-01 09:42:02.504 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_STRING Pushing text string '0'
2021-10-01 09:42:02.504 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_STRING Pushing text string '3'
2021-10-01 09:42:02.504 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_SUBSTRING_EMPTY Popping length 3, start 0, string 0x pushing result 0x
2021-10-01 09:42:02.504 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_STRING Pushing text string 'win'
2021-10-01 09:42:02.504 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_EQUAL Popping 0x77696E and 0x pushing result 'false'
2021-10-01 09:42:02.504 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_NOT Popping 'false' pushing 'true'
2021-10-01 09:42:02.505 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_OPTION Pushing option 60 with value 0x
2021-10-01 09:42:02.505 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_STRING Pushing text string '0'
2021-10-01 09:42:02.505 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_STRING Pushing text string '3'
2021-10-01 09:42:02.505 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_SUBSTRING_EMPTY Popping length 3, start 0, string 0x pushing result 0x
2021-10-01 09:42:02.506 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_STRING Pushing text string 'win'
2021-10-01 09:42:02.506 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_EQUAL Popping 0x77696E and 0x pushing result 'false'
2021-10-01 09:42:02.506 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_OPTION Pushing option 60 with value 0x
2021-10-01 09:42:02.506 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_STRING Pushing text string '0'
2021-10-01 09:42:02.506 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_STRING Pushing text string '3'
2021-10-01 09:42:02.506 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_SUBSTRING_EMPTY Popping length 3, start 0, string 0x pushing result 0x
2021-10-01 09:42:02.506 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_STRING Pushing text string 'win'
2021-10-01 09:42:02.506 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_EQUAL Popping 0x77696E and 0x pushing result 'false'
2021-10-01 09:42:02.506 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_NOT Popping 'false' pushing 'true'
2021-10-01 09:42:05.616 DEBUG [kea-dhcp4.eval/445.140222409295296] EVAL_DEBUG_OPTION Pushing option 60 with value 0x77696E646F777337

• https://www.youtube.com/watch?v=v7CA834WhMo

• DHCP Optionen

• Option 1: Client-Klassen via Reservierung zuordnen

{
  "Dhcp4": {
      "client-classes": [
      {
        "name": "pool_name_1",
        "valid-lifetime": 3600
      },
      {
        "name": "pool_name_etc",
        "valid-lifetime": 1800
      }
    ],
    "reservations-global": true,
    "reservations": [
      {
        "hw-address": "a1:bb:cc:dd:ee:ff",
        "client-classes": [
          "pool_name_1",
          "pool_name_etc"
        ]
      },
      {
        "hw-address": "a2:bb:cc:dd:ee:ff",
        "client-classes": [
          "pool_name_etc"
        ]
      }
    ],
    "subnet4": [
      {
        "id": 1,
        "subnet": "10.0.0.0/24",
        "pools": [
          {
            "pool": "10.0.0.10-10.0.0.100",
            "client-classes": [
              "pool_name_1",
              "pool_name_etc"
            ]
          }
        ],
        "reservations": [
          {
            "hw-address": "a1:bb:cc:dd:ee:ff",
            "ip-address": "10.0.0.2"
          },
          {
            "hw-address": "a2:bb:cc:dd:ee:ff",
            "ip-address": "10.0.0.3"
          }
        ]
      },
      {
        "id": 2,
        "subnet": "192.0.3.0/24",
        "pools": [
          {
            "pool": "192.0.3.10-192.0.3.20",
            "client-classes": [
              "pool_name_1"
            ]
          }
        ]
      }
    ]
  }
}

• Option 2: Client-Klassen via Test-Ausdruck zuordnen
  • Diese Lösung skaliert nur für eine geringe Anzahl von Hosts

{
  "Dhcp4": {
    "reservations-global": false,
    "client-classes": [
      {
        "name": "pool_name_1",
        "test": "match('a1:bb:cc:dd:ee:ff',hexstring(pkt4.mac, ':'))",
        "valid-lifetime": 3600
      },
      {
        "name": "pool_name_etc",
        "test": "match('a1:bb:cc:dd:ee:ff|a2:bb:cc:dd:ee:ff',hexstring(pkt4.mac, ':'))",
        "valid-lifetime": 1800
      }
    ],
    "subnet4": [
      {
        "id": 1,
        "subnet": "10.0.0.0/24",
        "pools": [
          {
            "pool": "10.0.0.10-10.0.0.100",
            "client-classes": [
              "pool_name_1",
              "pool_name_etc"
            ]
          }
        ],
        "reservations": [
          {
            "hw-address": "a1:bb:cc:dd:ee:ff",
            "ip-address": "10.0.0.2"
          },
          {
            "hw-address": "a2:bb:cc:dd:ee:ff",
            "ip-address": "10.0.0.3"
          }
        ]
      },
      {
        "id": 2,
        "subnet": "192.0.3.0/24",
        "pools": [
          {
            "pool": "192.0.3.10-192.0.3.20",
            "client-classes": [
              "pool_name_1"
            ]
          }
        ]
      }
    ]
  }
}

• Starte Sie im kea-server container
• Initialisieren und starten Sie die PostgreSQL Datenbank

[kea-server]% /usr/bin/postgresql-setup --initdb
[kea-server]% systemctl enable --now postgresql

• Verbinden Sie sich mit dem Datenbankserver. Dieser PostgreSQL-Server hat kein Passwort, verwenden Sie das leere Passwort, um sich anzumelden. Für eine Produktionsinstallation konfigurieren Sie die Passwortauthentifizierung für den Datenbankserver. Die Konfiguration der PostgreSQL-Authentifizierung ist nicht Gegenstand der ISC Kea DHCP-Schulung.

[kea-server]% su - postgres
[kea-server]$ psql postgres
psql (16.1)
Type "help" for help.

postgres=#

• Erstellen Sie eine neue Datenbank, kea_lease_db ist der Name der Datenbank in diesem Beispiel

postgres=# CREATE DATABASE kea_lease_db;
CREATE DATABASE

• Anlegen eines Benutzers für den Kea-Server für den Zugriff auf die Datenbank

postgres=# CREATE USER kea WITH PASSWORD 'secure-password';
CREATE ROLE

• Legen Sie die Berechtigungen für den neuen Benutzer in der Datenbank fest

postgres=# GRANT ALL PRIVILEGES ON DATABASE kea_lease_db TO kea;
GRANT

• In PostgreSQL 15 (und höher) müssen Sie dem Benutzer kea zum Besitzer der Datenbank machen und diesem Benutzer die Rechte zum verändern des Datenbank-Schema geben (siehe https://www.cybertec-postgresql.com/en/error-permission-denied-schema-public/)

postgres=# GRANT ALL ON SCHEMA public TO kea;
postgres=# ALTER DATABASE kea_lease_db OWNER TO kea;

• Verlassen Sie den PostgreSQL Client

postgres=# \q

• Beenden Sie die Shell mit dem Benutzer postgres um wieder auf der root Shell zu sein

[kea-server]$ exit
[kea-server]% id
uid=0(root) gid=0(root) groups=0(root)

• Konfigurieren Sie die PostgreSQL-Datenbank so, dass sie die Passwort-Authentifizierung für die Kea-Datenbank verwendet. Die Kea-Datenbankeinträge müssen vor den all Datenbankeinträgen in der Datei /var/lib/pgsql/data/pg_hba.conf erscheinen.

# TYPE  DATABASE        USER            ADDRESS                 METHOD
local   kea_lease_db    kea                                 password
host    kea_lease_db    kea          127.0.0.1/32           password
host    kea_lease_db    kea          ::1/128                password

# "local" is for Unix domain socket connections only
local   all             all                                     peer
[...]

• Starten Sie den PostgreSQL Server-Dienst neu

[kea-server]% systemctl restart postgresql

• Füllen Sie die Datenbank mit dem Kea-DHCP Schema mit hilfe des kea-admin Programms ( Befehl mit einem Leerzeichen beginnen, um zu verhindern das das Passwort in der Shell-Historie aufgezeichnet wird )

[kea-server]% kea-admin db-init pgsql -u kea -h 127.0.0.1 -p secure-password -n kea_lease_db
Checking if there is a database initialized already...
Initializing database using script /usr/share/kea/scripts/pgsql/dhcpdb_create.pgsql
psql:/usr/share/kea/scripts/pgsql/dhcpdb_create.pgsql:140: NOTICE:  function lease4dumpheader() does not exist, skipping
psql:/usr/share/kea/scripts/pgsql/dhcpdb_create.pgsql:148: NOTICE:  function lease4dumpdata() does not exist, skipping
psql:/usr/share/kea/scripts/pgsql/dhcpdb_create.pgsql:178: NOTICE:  function lease6dumpheader() does not exist, skipping
psql:/usr/share/kea/scripts/pgsql/dhcpdb_create.pgsql:186: NOTICE:  function lease6dumpdata() does not exist, skipping
Schema version reported after initialization: 22.1

• Kea-DHCP Datenbank-Erweiterung (Hook) für PostgreSQL hinzufügen:

{
"Dhcp4": {
  "hooks-libraries": [
   {
     "library": "/usr/lib64/kea/hooks/libdhcp_pgsql.so"
   }
   ],

• Passen Sie den Block lease-database in der Kea-Serverkonfiguration an, um eine Datenbank vom Typ PostgreSQL zu verwenden:

[...]
        "lease-database": {
          "type": "postgresql",
          "host": "localhost",
          "name": "kea_lease_db",
          "user": "kea",
          "password": "secure-password"
        },
[...]

• Testen Sie die Konfiguration und starten Sie den Kea-DHCP-Server
• Starten Sie den DHCP-Relay-Dienst im Container relay

[relay]% dhcrelay -id relay1-eth0 -id relay2-eth0 -iu relay3-eth0 -d 100.64.0.1

• Testen Sie die Installation indem Sie eine DHCP-Lease von clientA und clientB anfordern
• Die Lease-Datenbank kann mit der lease-dump Funktion des kea-admin Kommandos exportiert werden ( Befehl mit einem Leerzeichen beginnen, um zu verhindern das das Passwort in der Shell-Historie aufgezeichnet wird )

[kea-server]% kea-admin lease-dump pgsql -u kea -h 127.0.0.1 -p secure-password -n kea_lease_db -o leases.csv -4
lease4 successfully dumped to leases.csv
[kea-server]% less leases.csv
address,hwaddr,client_id,valid_lifetime,expire,subnet_id,fqdn_fwd,fqdn_rev,hostname,state
192.0.2.100,fe15e927353b,ffe927353b000400d52b989bf14fbfaeb1f21908f229d9,3600,2018-12-08 21:39:06+00,1,0,0,,default
198.51.100.50,f2b272a61f8d,ff72a61f8d000405a5b16faf254760879df44a6a58636a,3600,2018-12-08 21:38:01+00,2,0,0,,default

• Eine Host-Datenbank kann auf die gleiche Weise erstellt werden wie die Leasing-Datenbank (siehe Anweisungen oben)

[...]
	"host-database": {
	  "type": "postgresql",
	  "host": "localhost",
	  "name": "kea_host_db",
	  "user": "kea",
	  "password": "secure-password"
	},
[...]

• Wenn der Datenbankinhalt über Datenbank-Updates gepflegt wird, kann die Host-Reservierungs-Datenbank im Modus /read-only konfiguriert werden:

[...]
	"host-database": {
	  "readonly": true,
	  "type": "postgresql",
	  "host": "localhost",
	  "name": "kea_host_db",
	  "user": "kea",
	  "password": "secure-password"
	},
[...]

• See https://kea.readthedocs.io/en/latest/arm/hooks.html#host-cmds-host-commands
• Es gibt die "Host-Command" Hooks, welche eine Reihe von neuen Befehlen zur Abfrage und Bearbeitung von Host-Reservierungen bietet. Kea bietet eine Möglichkeit, Host-Reservierungen in einer Datenbank zu speichern. Dies ist insb. bei größeren Installationen sinnvoll. Diese Hooks-Bibliothek bietet Verwaltungsbefehle zum Hinzufügen, Abfragen und Löschen von Host-Reservierungen auf eine sichere Weise, ohne das der Kea-DHCP Server neu gestartet werden muss oder die Konfiguration neu geladen wird.
• Der Host Command Hook ist bis Kea-DHCP 2.6 als kostenpflichtiges Lizenzpaket (Premium Hooks, 549-7499 US$) erhältlich und ab Kea-DHCP 3.0 bestandteil der Open-Source Version von Kea-DHCP.
• Die Open Source "Kea-Python" Hooks erlauben es, Kea Hooks in der Programmiersprache Python zu erstellen. https://github.com/davejohncole/kea_python
  • Dieses Projekt beinhalten eine Implementation der Hooks Commands in Python.

• Verlassen Sie die kea-server, relay, clientA und clientB Container
• Führen Sie die Scripte ./stop und ./clean in /root/lab/lab03 aus

• Starten Sie das Script ./run im Verzeichnis /root/lab/lab05 um die Lab-Umgebung zu starten
• Gehen Sie in den Container kea-server1

# enter kea-server1

• Entfernen Sie die PostgreSQL Lease-Datenbank und schalten Sie zurück auf die in-memory Datenbank

• Fügen Sie eine HA-Standby-Konfiguration im Container kea-server1 in der Datei /etc/kea/kea-dhcp4.conf hinzu. Die Hook-Bibliothek dhcp_lease_cmds ist für das HA-Modul erforderlich (Die Hochverfügbarkeits-Funktion verwendet die in diesem Hook definierten REST-API-Funktionen):

        "hooks-libraries": [
        {
            "library": "/usr/lib64/kea/hooks/libdhcp_lease_cmds.so",
            "parameters": { }
        },
            {
            "library": "/usr/lib64/kea/hooks/libdhcp_ha.so",
            "parameters": {
                "high-availability": [ {
                    "this-server-name": "server1",
                    "mode": "hot-standby",
                    "heartbeat-delay": 10000,    # miliseconds
                    "max-response-delay": 20000, # miliseconds
                    "max-ack-delay": 5000,       # miliseconds
                    "max-unacked-clients": 0,    # immediate partner down
                    "peers": [
                        {
                            "name": "server1",
                            "url": "http://100.64.0.1:9098/",
                            "role": "primary",
                            "auto-failover": true
                        },
                        {
                            "name": "server2",
                            "url": "http://100.64.1.1:9098/",
                            "role": "standby",
                            "auto-failover": true
                        }
                    ]
                } ]
            }
        }
    ],
[...]

• Ändern Sie den Namen der Netzwerkschnittstelle im Kea-DHCP4-Modul von server-eth0 in server1-eth0.
• Starte den Kea-DHCP Server

[kea-server1]% systemctl start kea-dhcp4
[kea-server1]% systemctl status kea-dhcp4

• Starten Sie die Überwachung der Kea DHCP4-Logdatei

[kea-server1]% tail -f /var/log/kea/kea-dhcp4.log

• Kopieren Sie die Konfiguration von kea-server1 auf kea-server2 (auf dem VM-Host)

[host]% cp /root/lab/conf/kea-dhcp4.conf /root/lab/conf2/

• In einem anderen Terminal, betrete den Container kea-server2

[host]% enter kea-server2

• Ändern Sie die Konfigurationsoption this-server-name in der Konfigurationsdatei des Kea DHCP4-Servers in den Text server2
• Ändern Sie den Schnittstellennamen in der Kea-DHCP4-Modulkonfiguration von server-eth0 in server2-eth0.
• Starten Sie den Kea Server

[kea-server2]% systemctl start kea-dhcp4

• Starte die Anzeige der Kea-DHCP Logdatei

[kea-server2]% tail -f /var/log/kea/kea-dhcp4.log

• Sie sollten sehen, dass sich das HA-Protokoll synchronisiert und beginnt, Heartbeat-Nachrichten zwischen den beiden Servern zu senden

• Wechseln Sie an einem anderen Terminal in den Container relay
• Starten Sie das DHCP-Relais, um die Anfragen von Clients an beide Kea DHCP4-Server zu senden.

[relay]% dhcrelay -id relay1-eth0 -id relay2-eth0 -iu relay3-eth0 -iu relay4-eth0 \
         -d 100.64.0.1 100.64.1.1

• Fordern Sie einen Lease von einem Client an. Dieser Lease sollte von kea-server1 kommen und der Lease sollte mit kea-server2 synchronisiert werden (siehe Lease-Datei im Verzeichnis /var/lib/kea/kea-leases4.csv

[client1]% dhclient -v -V fedoraLinux client1-eth0

• Stoppen Sie den Prozess kea-dhcp4 auf dem Rechner kea-server1.

[kea-server1]% systemctl stop kea-dhcp4

• Die Protokollmeldungen auf kea-server2 sollten den Status partner-down anzeigen
• Anfragen von clientA sollten nun nach 5000ms von kea-server2 bedient werden
• Starten Sie den Prozess kea-dhcp4 auf kea-server1. Beobachten Sie die Synchronisierung der Lease-Datenbank, fordern Sie einen Lease von einem Client an. Dieser Client sollte nun wieder von kea-server1 bedient werden.

• Wir benutzen wieder die lab03 Umgebung

$ sudo -s
% cd /root/lab/lab03
% ./run

• Erlaube "Rapid-Commit" für eines der Subnetze in der Kea-DHCPv6 Konfiguration

[...]
        "subnet6": [
            {
                "subnet": "fd00:100::/32",
                "id": 1000,
                "rapid-commit": true,
                "pools": [
                    {
                        "pool": "fd00:100::1-fd00:100::ffff"
                    }
                ],
[...]

• Teste die Konfiguration und lade den Kea-DHCPv6 Server neu
• Überwache die Log-Ausgaben auf dem Kea-DHCPv6 Server

• Auf clientA, erzeuge die Datei /etc/dhcp/dhclient6.conf mit einer Rapid-Commit Konfiguration

send dhcp6.rapid-commit;

• Entferne die alte DHCPv6 Lease-Datenbank auf dem Client

[clientA]% rm /var/lib/dhclient/dhclient6.leases

• Fordere eine IPv6-Adresse von DHCPv6 Server mit Rapid-Commit:

[clientA]%  dhclient -6 -d -cf /etc/dhcp/dhclient6.conf
Internet Systems Consortium DHCP Client 4.3.6
Copyright 2004-2017 Internet Systems Consortium.
All rights reserved.
For info, please visit https://www.isc.org/software/dhcp/

Listening on Socket/client1-eth0
Sending on   Socket/client1-eth0
Created duid "\000\0049\376\214\213\036\333G\374\242\034#T\354\325]\326".
PRC: Soliciting for leases (INIT).
XMT: Forming Solicit, 0 ms elapsed.
XMT:  X-- IA_NA a0:df:17:1a
XMT:  | X-- Request renew in  +3600
XMT:  | X-- Request rebind in +5400
XMT: Solicit on client1-eth0, interval 1080ms.
RCV: Reply message on client1-eth0 from fe80::3c1d:4ff:fe2e:950a.
RCV:  X-- IA_NA a0:df:17:1a
RCV:  | X-- starts 1544389491
RCV:  | X-- t1 - renew  +1000
RCV:  | X-- t2 - rebind +2000
RCV:  | X-- [Options]
RCV:  | | X-- IAADDR fd00:100::2
RCV:  | | | X-- Preferred lifetime 3000.
RCV:  | | | X-- Max lifetime 4000.
RCV:  X-- Server ID: 00:01:00:01:23:a0:2f:4b:76:de:2c:55:01:44
PRC: Bound to lease 00:01:00:01:23:a0:2f:4b:76:de:2c:55:01:44.
PRC: Renewal event scheduled in 999 seconds, to run for 1000 seconds.
PRC: Depreference scheduled in 2999 seconds.
PRC: Expiration scheduled in 3999 seconds.

• Füge die Konfiguration für eine Prefix-Delegation der Kea-DHCPv6 Konfiguration /etc/kea/kea-dhcp6.conf hinzu:

[...]
        "subnet6": [
            {
                "subnet": "fd00:100::/32",
                "id": 1000,
                "pools": [
                    {
                        "pool": "fd00:100::1-fd00:100::ffff"
                    }
                ],
                "pd-pools": [
                    {
                        "prefix": "fd00:100:10::",
                        "prefix-len": 48,
                        "delegated-len": 56,
                        "excluded-prefix": "fd00:100:10::",
                        "excluded-prefix-len": 64
                    }
                ]
            },
[...]

• Sende eine Anfrage für ein IPv6-Netzwerk mit der (-P) Option (Prefix-Delegation)

[clientA]% dhclient -d -6 -P client1-eth0
Internet Systems Consortium DHCP Client 4.3.6
Copyright 2004-2017 Internet Systems Consortium.
All rights reserved.
For info, please visit https://www.isc.org/software/dhcp/

Listening on Socket/client1-eth0
Sending on   Socket/client1-eth0
PRC: Soliciting for leases (INIT).
XMT: Forming Solicit, 0 ms elapsed.
XMT:  X-- IA_PD a0:df:17:1a
XMT:  | X-- Request renew in  +3600
XMT:  | X-- Request rebind in +5400
XMT: Solicit on client1-eth0, interval 1030ms.
RCV: Advertise message on client1-eth0 from fe80::3c1d:4ff:fe2e:950a.
RCV:  X-- IA_PD a0:df:17:1a
RCV:  | X-- starts 1544388880
RCV:  | X-- t1 - renew  +1000
RCV:  | X-- t2 - rebind +2000
RCV:  | X-- [Options]
RCV:  | | X-- IAPREFIX fd00:100:10::/56
RCV:  | | | X-- Preferred lifetime 3000.
RCV:  | | | X-- Max lifetime 4000.
RCV:  X-- Server ID: 00:01:00:01:23:a0:2f:4b:76:de:2c:55:01:44
RCV:  Advertisement recorded.P
RC: Selecting best advertised lease.
PRC: Considering best lease.
PRC:  X-- Initial candidate 00:01:00:01:23:a0:2f:4b:76:de:2c:55:01:44 (s: 10103, p: 0).
XMT: Forming Request, 0 ms elapsed.
XMT:  X-- IA_PD a0:df:17:1a
XMT:  | X-- Requested renew  +3600
XMT:  | X-- Requested rebind +5400
XMT:  | | X-- IAPREFIX fd00:100:10::/56
XMT:  | | | X-- Preferred lifetime +7200
XMT:  | | | X-- Max lifetime +7500
XMT:  V IA_PD appended.
XMT: Request on client1-eth0, interval 1090ms.
RCV: Reply message on client1-eth0 from fe80::3c1d:4ff:fe2e:950a.
RCV:  X-- IA_PD a0:df:17:1a
RCV:  | X-- starts 1544388881
RCV:  | X-- t1 - renew  +1000
RCV:  | X-- t2 - rebind +2000
RCV:  | X-- [Options]
RCV:  | | X-- IAPREFIX fd00:100:10::/56
RCV:  | | | X-- Preferred lifetime 3000.
RCV:  | | | X-- Max lifetime 4000.
RCV:  X-- Server ID: 00:01:00:01:23:a0:2f:4b:76:de:2c:55:01:44
PRC: Bound to lease 00:01:00:01:23:a0:2f:4b:76:de:2c:55:01:44.
Prefix BOUND6 old= new=fd00:100:10::/56
PRC: Renewal event scheduled in 998 seconds, to run for 1000 seconds.
PRC: Depreference scheduled in 1690 seconds.
PRC: Expiration scheduled in 2690 seconds.

• Create the container configuration for the dynamic DNS updates lab

[host]% cd /root/lab/lab04
[host]% ./run

• Create a simple BIND 9 configuration

[host]% enter bind9
[bind9]% systemctl edit --full named
[...]
Environment=NAMEDCONF=/etc/namedb/named.conf
[..]
[bind9]% cd /etc/namedb
[bind9]% nano named.conf

• BIND 9 configuration file

options {
        recursion no;
        directory "/etc/namedb";
};

zone "example.com" {
     type master;
     allow-update { 100.64.0.1; };
     file "example.com";
};

• Create a simple zone file for the domain example.com

[bind9]% nano example.com

• Content of the example.com zonefile

$TTL 1h
@    IN SOA  dns.example.com. hostmaster 1001 2h 30m 41d 1h
     IN NS   dns.example.com.
dns  IN A    100.64.53.1

• Adjust the file and directory permissions

[bind9]% chown -R named /etc/namedb

• Check configuration and start the BIND 9 DNS-Server

[bind9]% named-checkconf -z /etc/namedb/named.conf
zone example.com/IN: loaded serial 1001
[bind9]% systemctl enable --now named
[bind9]% systemctl status named
● named.service - Berkeley Internet Name Domain (DNS)
   Loaded: loaded (/etc/systemd/system/named.service; enabled; vendor preset: disabled)
   Active: active (running) since Sat 2018-12-08 21:21:31 UTC; 2s ago
  Process: 114 ExecStop=/bin/sh -c /usr/sbin/rndc stop > /dev/null 2>&1 || /bin/kill -TERM $MAINPID (code=exited, status=0/SUCCESS)
  Process: 123 ExecStart=/usr/sbin/named -u named -c ${NAMEDCONF} $OPTIONS (code=exited, status=0/SUCCESS)
  Process: 121 ExecStartPre=/bin/bash -c if [ ! "$DISABLE_ZONE_CHECKING" == "yes" ]; then /usr/sbin/named-checkconf -z "$NAMEDCONF"; else echo "Checking o>
 Main PID: 124 (named)
    Tasks: 7 (limit: 4915)
   Memory: 56.6M
   CGroup: /machine.slice/libpod-85f9421313e21d95745a04b15adc67749a39ebce96087a78e0e83db7ef6f3b16.scope/system.slice/named.service
           └─124 /usr/sbin/named -u named -c /etc/namedb/named.conf

Dec 08 21:21:31 85f9421313e2 named[124]: none:104: 'max-cache-size 90%' - setting to 10699MB (out of 11888MB)
Dec 08 21:21:31 85f9421313e2 named[124]: configuring command channel from '/etc/rndc.key'
Dec 08 21:21:31 85f9421313e2 named[124]: command channel listening on 127.0.0.1#953
Dec 08 21:21:31 85f9421313e2 named[124]: configuring command channel from '/etc/rndc.key'
Dec 08 21:21:31 85f9421313e2 named[124]: command channel listening on ::1#953
Dec 08 21:21:31 85f9421313e2 named[124]: managed-keys-zone: loaded serial 0
Dec 08 21:21:31 85f9421313e2 named[124]: zone example.com/IN: loaded serial 1001
Dec 08 21:21:31 85f9421313e2 named[124]: all zones loaded
Dec 08 21:21:31 85f9421313e2 named[124]: running
Dec 08 21:21:31 85f9421313e2 systemd[1]: Started Berkeley Internet Name Domain (DNS).

• Query the SOA record from the new DNS-Server, check the flags to see that the answer is authoritative (AA-Flag)

[bind9]% dig @localhost soa example.com

; <<>> DiG 9.11.4-P2-RedHat-9.11.4-10.P2.fc29 <<>> @localhost soa example.com
; (2 servers found)
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 13943
;; flags: qr aa rd; QUERY: 1, ANSWER: 1, AUTHORITY: 1, ADDITIONAL: 2
;; WARNING: recursion requested but not available

;; OPT PSEUDOSECTION:
; EDNS: version: 0, flags:; udp: 4096
; COOKIE: e2bfaaa71e139bacd7f36d815c0c3643b451622ab4174331 (good)
;; QUESTION SECTION:
;example.com.                   IN      SOA

;; ANSWER SECTION:
example.com.            3600    IN      SOA     dns.example.com. hostmaster.example.com. 1001 7200 1800 3542400 3600

;; Query time: 0 msec
;; SERVER: ::1#53(::1)
;; WHEN: Sat Dec 08 21:23:15 UTC 2018
;; MSG SIZE  rcvd: 119

• Work on the Kea DHCP Server machine

  [host]% enter kea-server
  

• Create a configuration file for the kea-dhcp-ddns daemon in /etc/kea/kea-dhcp-ddns.conf (writing domain names in full qualified format, including the "." at the end, is very important!):

{
    "DhcpDdns": {
        "ip-address": "127.0.0.1",
        "port": 53001,
        "dns-server-timeout": 100,
        "ncr-protocol": "UDP",
        "ncr-format": "JSON",
        "tsig-keys": [],
        "forward-ddns": {
            "ddns-domains": [
                {
                    "name": "example.com.",
                    "key-name": "",
                    "dns-servers": [
                        {
                            "hostname": "",
                            "ip-address": "100.64.53.1",
                            "port": 53
                        }
                    ]
                }
            ]
        },
        "reverse-ddns": {
            "ddns-domains": []
        },
        "loggers": [
            {
                "name": "kea-dhcp-ddns",
                "severity": "INFO",
                "output_options": [
                    {
                        "output": "/var/log/kea/kea-dhcp-ddns.log"
                    }
                ]
            }
        ]
    }
}

• Test the configuration file

[kea-server]% kea-dhcp-ddns -t /etc/kea/kea-dhcp-ddns.conf
2018-12-08 21:33:17.546 INFO  [kea-dhcp-ddns.dctl/52] DCTL_CONFIG_CHECK_COMPLETE server has completed configuration check: listening on 127.0.0.1, port 53001, using UDP, result: success(0), text=Configuration seems sane.

• Start the Kea DHCP-DDNS (D2) server

[kea-server]% systemctl start kea-dhcp-ddns
[kea-server]% systemctl status kea-dhcp-ddns
● kea-dhcp-ddns.service - Kea DHCP-DDNS Server
   Loaded: loaded (/usr/lib/systemd/system/kea-dhcp-ddns.service; disabled; vendor preset: disabled)
   Active: active (running) since Sat 2018-12-08 21:34:07 UTC; 4s ago
     Docs: man:kea-dhcp-ddns(8)
 Main PID: 55 (kea-dhcp-ddns)
    Tasks: 1 (limit: 4915)
   Memory: 1.8M
   CGroup: /machine.slice/libpod-e96af203d05ac37853f65c7a93ffdbf87d509873172b7bab5abae1505f6a2c9b.scope/system.slice/kea-dhcp-ddns.service
           └─55 /usr/sbin/kea-dhcp-ddns -c /etc/kea/kea-dhcp-ddns.conf

Dec 08 21:34:07 e96af203d05a systemd[1]: Started Kea DHCP-DDNS Server.
Dec 08 21:34:07 e96af203d05a kea-dhcp-ddns[55]: 2018-12-08 21:34:07.445 INFO  [kea-dhcp-ddns.dctl/55] DCTL_STARTING DhcpDdns starting, pid: 55, version: 1>
Dec 08 21:34:07 e96af203d05a kea-dhcp-ddns[55]: 2018-12-08 21:34:07.446 INFO  [kea-dhcp-ddns.dctl/55] DCTL_CONFIG_COMPLETE server has completed configurat>
Dec 08 21:34:07 e96af203d05a kea-dhcp-ddns[55]: 2018-12-08 21:34:07.446 INFO  [kea-dhcp-ddns.dhcpddns/55] DHCP_DDNS_STARTED Kea DHCP-DDNS server version 1>

• In the kea-dhcp4 configuration file, revert back from PostgreSQL backend to the memfile backend for lease storage (because in this lab we do not have the database running)

  "lease-database": {
      "type": "memfile",
      "lfc-interval": 3600
  },
  

• Enable DDNS in the kea-dhcp4.conf configuration file

{
  "Dhcp4": {
    "ddns-replace-client-name": "always",
    "ddns-generated-prefix": "host",
    "ddns-qualifying-suffix": "example.com.",
    "dhcp-ddns": {
      "enable-updates": true
    },
[...]

• Test the configuration and restart the Kea DHCP server
• Monitor the Kea-DHCP-DDNS logfile

[kea-server]% tail -f /var/log/kea/kea-dhcp-ddns.log

• Start the relay-agent on the relay container

  [relay]% dhcrelay -id relay1-eth0 -id relay2-eth0 -iu relay3-eth0 -d 100.64.0.1
  

• Request a lease from clientA and clientB. Observe the Kea-DHCP-DDNS logfile:

2018-12-08 21:50:23.003 INFO  [kea-dhcp-ddns.dhcpddns/89] DHCP_DDNS_STARTED Kea DHCP-DDNS server version 1.3.0 started
2018-12-08 21:53:49.204 INFO  [kea-dhcp-ddns.d2-to-dns/89] DHCP_DDNS_ADD_SUCCEEDED DHCP_DDNS Request ID 000101900AC838EC971B893D11C655FBB9E1E8343488CB0801F35B74A64CA9424C996E: successfully added the DNS mapping addition for this request: Type: 0 (CHG_ADD)
Forward Change: yes
Reverse Change: no
FQDN: [host-192-0-2-100.example.com.]
IP Address: [192.0.2.100]
DHCID: [000101900AC838EC971B893D11C655FBB9E1E8343488CB0801F35B74A64CA9424C996E]
Lease Expires On: 20181208225349
Lease Length: 3600

• Log on the BIND 9 DNS-Server

# journalctl -fu named
-- Logs begin at Sat 2018-12-08 21:07:04 UTC. --
Dec 08 21:21:31 85f9421313e2 named[124]: command channel listening on 127.0.0.1#953
Dec 08 21:21:31 85f9421313e2 named[124]: configuring command channel from '/etc/rndc.key'
Dec 08 21:21:31 85f9421313e2 named[124]: command channel listening on ::1#953
Dec 08 21:21:31 85f9421313e2 named[124]: managed-keys-zone: loaded serial 0
Dec 08 21:21:31 85f9421313e2 named[124]: zone example.com/IN: loaded serial 1001
Dec 08 21:21:31 85f9421313e2 named[124]: all zones loaded
Dec 08 21:21:31 85f9421313e2 named[124]: running
Dec 08 21:21:31 85f9421313e2 systemd[1]: Started Berkeley Internet Name Domain (DNS).
Dec 08 21:51:47 85f9421313e2 named[124]: received control channel command 'sync'
Dec 08 21:51:47 85f9421313e2 named[124]: dumping all zones: success
Dec 08 21:53:49 85f9421313e2 named[124]: client @0x7f9a9c11e0b0 100.64.0.1#54788: updating zone 'example.com/IN': adding an RR at 'host-192-0-2-100.example.com' A 192.0.2.100
Dec 08 21:53:49 85f9421313e2 named[124]: client @0x7f9a9c11e0b0 100.64.0.1#54788: updating zone 'example.com/IN': adding an RR at 'host-192-0-2-100.example.com' DHCID AAEBkArIOOyXG4k9EcZV+7nh6DQ0iMsIAfNbdKZMqUJMmW4=

• Inspect updated zonefile

[bind9]% rndc sync
[bind9]% cat /etc/namedb/example.com
$ORIGIN .
$TTL 3600       ; 1 hour
example.com             IN SOA  dns.example.com. hostmaster.example.com. (
                                1003       ; serial
                                7200       ; refresh (2 hours)
                                1800       ; retry (30 minutes)
                                3542400    ; expire (5 weeks 6 days)
                                3600       ; minimum (1 hour)
                                )
                        NS      dns.example.com.
$ORIGIN example.com.
dns                     A       100.64.53.1
host-192-0-2-100        A       192.0.2.100
                        DHCID   ( AAEBkArIOOyXG4k9EcZV+7nh6DQ0iMsIAfNbdKZMqUJM
                                mW4= ) ; 1 1 32
host-198-51-100-50      A       198.51.100.50
                        DHCID   ( AAEBCI5Fy5lEJYJbJcRaLLKHNUVpTN5HyOU8C/1Ijobh
                                CjM= ) ; 1 1 32

• Add a reverse zones to the BIND 9 DNS-Server for the IP-Networks 192.0.2.0/24 (2.0.192.in-addr.arpa.) and 198.51.100.0/24 (100.51.198.in-addr.arpa.).
• Add the reverse zones to the Kea-DHCP-DDNS daemon configuration
• Reload and test

• Operating DDNS with authentication based on IP-Adresses is insecure. In production environments, DDNS should be authenticated with TSIG
• In this exercise we change the previous DDNS configuration to use TSIG keys

• Exit from the kea-server, relay, bind9 clientA and clientB container
• Execute the script ./stop and ./clean in /root/lab/lab04