%general-entities; ]> Kea The ISC Kea package contains the server programs for DHCP. It is the successor of the server which is end-of-life since December 2022. &lfs113_checked; Package Information Download (HTTP): Download (FTP): Download MD5 sum: &kea-md5sum; Download size: &kea-size; Estimated disk space required: &kea-buildsize; Estimated build time: &kea-time; Kea Dependencies Required User Notes: You must have Packet Socket support. IPv6 support is optional. [*] Networking support ---> [CONFIG_NET] Networking options ---> <*> Packet socket [CONFIG_PACKET] <*> The IPv6 Protocol ---> [CONFIG_IPV6] Kea Install ISC Kea DHCP by running the following commands: ./configure --prefix=/usr \ --sysconfdir=/etc \ --docdir=/usr/share/doc/kea-&kea-dhcp-version; \ --localstatedir=/var \ --enable-shell \ --with-openssl && make To test the results, issue: make check. To install the ISC Kea DHCP suite, issue the following commands as the root user: make -j1 install make -j1 install: ISC doesn not recomment any form of parallel or job server options when doing the install. Consult the Kea Administrator Reference Manual for detailled information about the configuration of Kea. 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 keactrl agent which is uses to control the servers in an easy way. /etc/kea/keactrl.conf, /etc/kea/kea-ctrl-agent.conf, /etc/kea/kea-dhcp4.conf, /etc/kea/kea-dhcp6.conf and /etc/kea/kea-dhcp-ddns.conf /etc/kea/keactrl.conf /etc/kea/kea-dhcp4.conf keactrl is used to control the independend servers (IPv4, IPv6, DDNS). Its configuration file /etc/kea/keactrl.conf is installed by default and includes many path settings which are defined due to the configure at build time. It also includes settings to specify which of the servers should be started. IPv4 DHCP server This daemon handles requests for IPv4 addresses. Set dhcp4=yes to start it, set dhcp4=no in case DHCP service for IPv4 is not wanted. IPv6 DHCP server This daemon handles requests for IPv6 addresses. Set dhcp6=yes to start it, set dhcp6=no in case DHCP service for IPv6 is not wanted. Dynamic DNS This daemon is used to update a DNS server dynamically when Kea assignes an IP address to a device. Set dhcp_ddns=yes to enable it, set dhcp_ddns=no in case dynamic DNS updates are not wanted. Control Agent The Control Agent is a daemon which allows the (re)configuration of the Kea DHCP service via REST API. Set ctrl_agent=yes to start the control agent (service providing a REST API), set ctrl_agent=no in case the control agent is not wanted. The Netconf service is not installed because required dependencies are not covered by the current BLFS book. 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 root user: 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 A sample configuration file is created in /etc/kea/kea-dhcpd4.conf. Adjust the file to suit your needs or overwrite it by using the following sample as the root user: cat > /etc/kea/kea-dhcpd4.conf << "EOF" // Begin /etc/kea/kea-dhcpd4.conf { "Dhcp4": { "interfaces-config": { "interfaces": [ "eth0" ] }, "control-socket": { "socket-type": "unix", "socket-name": "/run/kea/kea4-ctrl-socket" }, "lease-database": { "type": "memfile", "lfc-interval": 3600 }, "renew-timer": 900, "rebind-timer": 1800, "valid-lifetime": 3600, "option-data": [ { "name": "domain-name-servers", "data": "192.168.2.1, 192.168.2.2" }, { "name": "domain-search", "data": "mydomain.example.org, example.org" } ], "subnet4": [ { "subnet": "192.168.2.0/24", "pools": [ { "pool": "192.168.2.16 - 192.168.2.64" } ], "option-data": [ { "name: "routers", "value": "192.168.2.254" } ], "reservations": [ { "hw-address": "00:11:22:33:44:55", "ip-address": "192.168.2.65", "hostname": "host-2-65" }, { "hw-address": "00:00:00:00:00:01", "ip-address": "192.168.2.253", "hostname": "special-host", "option-data": [ { "name": "domain-name-servers", "data": "192.168.1.1" } ] } ] } ] } } // End /etc/kea/kea-dhcpd4.conf EOF The double braces at the end of the config is not a typo. The configuration for IPv6 is similar to the configuration of IPv4. The configuration file is /etc/kea/kea-dhcpd6.conf. If you want to start the DHCP Server at boot, install the /etc/rc.d/init.d/kea-dhcpd init script kea-dhcpd.service unit included in the package: make install-kea-dhcpd Installed Programs Installed Libraries Installed Directories keactrl, kea-admin, kea-ctrl-agent, kea-dhcp4, kea-dhcp6, kea-dhcp-ddns, kea-lfc, kea-shell libkea-* /etc/kea, /usr/include/kea, /var/lib/kea Short Descriptions keactrl Tool to control the server processes keactrl