Kea DHCP High Availability - User Guide - Micetro - 25.2.0

Micetro Admin Guide
ft:locale
en-US
Product name
Micetro
Version
25.2.0

In Micetro, you can configure High Availability (HA) for Kea DHCP servers and add failover relationships for them. Both the primary and secondary servers in a failover relationship need to be added to Micetro. Once you've added the servers, you can manage them separately.

For more information about managing failover relationships, refer to Kea DHCP failover relationships.

Warning: Synchronized clocks are essential for the reliable operation of the High Availability setup. If a clock skew is not corrected and exceeds 60 seconds, the High Availability service on each server will be terminated.

There are several aspects of Kea's High Availability feature that you must take into account when setting up failover relationships:

High Availability hooks library

Previously only available to paid subscribers, the High Availability (HA) hooks library is now part of the open-source Kea. The hooks library needs to be present on the file system before the Kea DHCP servers can be managed in High Availability mode.

You must have the following hook libraries on your file system before you can add a failover relationship:

  • libdhcp_lease_cmds.so, which enables control commands necessary for High Availability to manage leases on remote servers.
  • libdhcp_ha.so, which implements the High Availability feature.

Micetro searches for hooks in the default location.

Tip:
  • For RedHat-like systems (e.g., RHEL, CentOS, SUSE, Fedora), the hook library is typically located at /usr/lib/x86_64-linux-gnu/kea/hooks/libdhcp_ha.so.
  • For Debian-based systems (e.g., Ubuntu, Linux Mint, Raspbian), the hook library is usually located at /usr/lib64/kea/hooks/libdhcp_ha.so.
  • You can customize the library’s location by specifying the path using the keaHooksLocation value in the DHCP Agent preferences.cfg file.

If the hooks are located elsewhere, you must specify the correct location using the keaHooksLocation preference value for the DHCP Agent.

Ports and networking

To ensure a seamless Kea High Availability setup, Micetro requires effective communication with each Kea DHCP server through specific ports. This communication is vital both for Micetro’s interaction with the servers and for cross-communication between Kea DHCP servers via the Kea Control Agent.

The Kea Control Agent defaults to port 8000. You can manually define this port in the configuration file, typically located at /etc/kea/kea-ctrl-agent.conf. It's crucial that you keep this port open and accessible on every server hosting a Kea DHCP service and a Kea Control Agent.

Adding a High Availability-enabled Kea DHCP server to Micetro

If the Kea High Availability environment is set up correctly, system administrators can add the Kea DHCP servers much like any other DHCP server. For more information, refer to Adding a service.

Important: If the DHCP Agent is running on a machine other than the primary Kea DHCP server, the Agent must be defined when you add the DHCP service to Micetro. In the dialog, enter the IP address or FQDN of the of the machine running the DHCP Agent.