ISC Packages for Kea DHCP
  • 04 Nov 2020
  • 7 Minutes To Read
  • Contributors
  • Print
  • Share
  • Dark
    Light

ISC Packages for Kea DHCP

  • Print
  • Share
  • Dark
    Light

Overview

ISC offers binary packages of Kea DHCP for our users and customers, hosted on Cloudsmith. They are provided along with the source code tarballs for every release.

Thank you!
The repository for Kea open source packages is provided by Cloudsmith at no charge as a free community service for non-profit open source projects.

Why does ISC provide Kea DHCP packages?

We want to make sure that Kea DHCP users have access to binaries, for two reasons:

  1. We want to make our users' lives easier by offering an alternative to building Kea from sources;
  2. Our users should not have to wait for OS distributions that package Kea to include all the latest bug fixes. We provide binary packages along with sources at the time of release.

Supported Operating Systems

ISC has created packages for what we think are the most popular operating systems for production DHCP servers. If your preferred operating system is not packaged, remember you can still build from our published sources.

We provide the following types of packages:

  • RPMs for RHEL, CentOS, Fedora
  • debs for Debian and ubuntu
  • apk for Alpine
Supported OS Versions
Please note that we only provide packages for currently supported versions of an operating system. When we release a new version of Kea, we evaluate the OSes we support. We add packages for newly released operating system versions as we are able to, and remove packages for operating system versions and Kea versions that become end-of-life.

A current list of supported systems and their versions can be found in the Kea documentation.

Kea Packages

Kea binaries are available in several packages. They are in the same layout as the ones provided by Fedora and Debian and their derivatives, and they behave in more or less the same way. To avoid confusing ISC packages with those from other distributors, all ISC packages start with the isc- prefix.

Open Source Packages

The open source packages contain the base Kea software and the following hooks libraries:

  • Flexible Option
  • Lease Commands
  • High Availability
  • Statistics Commands
  • MySQL Configuration Backend
  • BOOTP
RPM Packages
Comment
isc-kea DHCPv4, DHCPv6 and DDNS servers
isc-kea-devel Development headers and libraries for Kea DHCP server. Needed if you plan to build your own Kea hooks.
isc-kea-hooks This package includes the open source hooks, plus user-check, lease-commands, and high-availability.
isc-kea-libs Shared libraries used by Kea. Install this.
freeradius-client You will need this if you are using the Kea RADIUS integration.
freeradius-client-devel Install this if you are using the Kea RADIUS integration.
Deb Packages
Comment
isc-kea-admin This package provides backend database initialization and migration scripts and a DHCP benchmark tool. If you are not using a database backend, you may not need this.
isc-kea-common Common libraries for the ISC Kea DHCP server. Install this.
isc-kea-ctrl-agent This package provides the REST API service agent for Kea DHCP.
isc-kea-dev Development headers for ISC Kea DHCP server. Install if you plan to create any custom Kea hooks.
isc-kea-dhcp4-server DHCPv4 server
isc-kea-dhcp6-server DHCPv6 server
isc-kea-dhcp-ddns-server DDNS server
isc-kea-doc Kea Documentation. Highly recommended.
python3-isc-kea-connector This package is needed for the Kea shell. Optional.
libfreeradius-client You will need this if you are using the Kea RADIUS integration.
libfreeradius-client-dev For Kea RADIUS integration. Optional.
Premium Hooks
ISC sells several premium Kea hooks libraries, for users who wish to take advantage of these features in conjunction with the open source version of Kea. These premium hooks are:

* Flexible Identifier
* Forensic Logging
* Host Commands

If you are interested in purchasing these hooks libraries, they are available at https://www.isc.org/shop/.

For ISC support subscribers only

Organizations that purchase professional Kea DHCP support from ISC are entitled to special software features that are not available in the open source version. ISC support subscribers receive all the premium hooks listed above (as binary packages or in source code form), as well as several others that are only available with a support subscription:

  • Class Commands
  • Configuration Backend Commands
  • Flexible Identifier
  • Forensic Logging
  • Host Cache
  • Host Commands
  • RADIUS
  • Subnet Commands

For more information about obtaining the subscriber-only Kea hooks libraries, please contact us at https://www.isc.org/contact.

RPM Packages
Comment
isc-kea-premium-class-cmds Classification Commands hooks library
isc-kea-premium-cb-cmds Config Backend Commands hooks library
isc-kea-premium-flex-id Flexible Identifier hooks library
isc-kea-premium-forensic-log Forensic Logging hooks library
isc-kea-premium-host-cache Host Cache hooks library
isc-kea-premium-host-cmds Host Commands hooks library
isc-kea-premium-radius RADIUS hooks library
isc-kea-premium-subnet-cmds Subnet Commands hooks library
Deb Packages
Comment
isc-kea-premium-class-cmds Classification Commands hooks library
isc-kea-premium-cb-cmds Config Backend Commands hooks library
isc-kea-premium-flex-id Flexible Identifier hooks library
isc-kea-premium-forensic-log Forensic Logging hooks library
isc-kea-premium-host-cache Host Cache hooks library
isc-kea-premium-host-cmds Host Commands hooks library
isc-kea-premium-radius RADIUS hooks library
isc-kea-premium-subnet-cmds Subnet Commands hooks library
RADIUS packages for Kea 1.6 and above
The Free RADIUS support requires a special patch from ISC to work with Kea. The packages posted for Kea 1.6 and above are missing this patch. If you are using RADIUS with Kea, please ask ISC Support for the correct package.

Packages Repositories

All ISC packages for Kea are contained in our repositories on Cloudsmith.

Open Source Repositories

Packages can be downloaded from our public Cloudsmith repository by following these directions. These instructions are for Kea 1.8, but they can be easily customized for other versions by changing kea-1-8 in the commands to kea-1-9, etc., as appropriate.

Deb Repositories

To install packages, you can quickly setup the repository automatically (recommended):

curl -1sLf \
  'https://dl.cloudsmith.io/public/isc/kea-1-8/cfg/setup/bash.deb.sh' \
  | sudo bash

If you need to force a specific distribution/release, you can also do that (e.g. if your system is compatible but not identical):

curl -1sLf \
  'https://dl.cloudsmith.io/public/isc/kea-1-8/cfg/setup/bash.deb.sh' \
  | sudo distro=some-distro codename=some-codename bash

or ... you can manually configure it yourself before installing packages:

apt-get install -y debian-keyring  # debian only
apt-get install -y debian-archive-keyring  # debian only
apt-get install -y apt-transport-https
curl -1sLf 'https://dl.cloudsmith.io/public/isc/kea-1-8/cfg/gpg/gpg.4DD5AE28ADA7268E.key' | apt-key add -
curl -1sLf 'https://dl.cloudsmith.io/public/isc/kea-1-8/cfg/setup/config.deb.txt?distro=ubuntu&codename=focal' > /etc/apt/sources.list.d/isc-kea-1-8.list
apt-get update

Note: Please replace ubuntu and focal above with your actual operating system, distribution, and distribution version.

If you no longer want to install packages from the repository, you can remove it with:

rm /etc/apt/sources.list.d/isc-kea-1-8.list
apt-get clean
rm -rf /var/lib/apt/lists/*
apt-get update

RPM Repositories

To install RPM packages, you can quickly setup the repository automatically (recommended):

curl -1sLf \
  'https://dl.cloudsmith.io/public/isc/kea-1-8/cfg/setup/bash.rpm.sh' \
  | sudo bash

If you need to force a specific distribution/release, you can also do that (e.g. if your system is compatible but not identical):

curl -1sLf \
  'https://dl.cloudsmith.io/public/isc/kea-1-8/cfg/setup/bash.rpm.sh' \
  | sudo distro=some-distro codename=some-codename bash

or... you can manually configure it yourself before installing packages:

yum install yum-utils pygpgme
rpm --import 'https://dl.cloudsmith.io/public/isc/kea-1-8/cfg/gpg/gpg.4DD5AE28ADA7268E.key'
curl -1sLf 'https://dl.cloudsmith.io/public/isc/kea-1-8/cfg/setup/config.rpm.txt?distro=el&codename=8' > /tmp/isc-kea-1-8.repo
yum-config-manager --add-repo '/tmp/isc-kea-1-8.repo'
yum -q makecache -y --disablerepo='*' --enablerepo='isc-kea-1-8'

Note: Please replace el and 8 above with your actual distribution/version and use wildcards when enabling multiple repos.

If you no longer want to install packages from the repository, you can remove it with:

rm /etc/yum.repos.d/isc-kea-1-8.repo
rm /etc/yum.repos.d/isc-kea-1-8-source.repo

Repositories for Support Subscribers

These instructions provide information on accessing the private Cloudsmith repositories with a token, indicated with your_token_goes_here in the commands. If you are an ISC Kea support customer and need a token, please open a ticket to request one.

The instructions are very similar to the ones for the open source repositories, given above. They can be easily customized by altering the URLs; the public part should be replaced with the token and kea-1-8 with kea-1-8-prv. For example:

'https://dl.cloudsmith.io/public/isc/kea-1-8/cfg/setup/bash.rpm.sh'

should be changed to

'https://dl.cloudsmith.io/your_token_goes_here/isc/kea-1-8-prv/cfg/setup/bash.rpm.sh' 

Kea Installation

After configuring the repositories on a host machine, the Kea packages can be installed. As there are several packages, we can choose to install only the parts of Kea that are required. The dependencies between packages are set up so any dependent packages will be pulled in as well.

The following command installs the base Kea software for DHCPv4.

Deb version:

apt install isc-kea-dhcp4-server

RPM version:

yum install isc-kea

With the RPMs, DHCPv4 and DHCPv6 are put into one package, whereas with debs there are two separate packages.

The following command installs the Kea hooks.

RPM version:

yum install isc-kea-hooks

With the RPMs, all hooks are put into one package, while debs hooks libraries are included in the base package (isc-kea-common) which is always installed.

The following command installs a particular Kea premium hooks library.

Deb version:

apt install isc-kea-premium-flex-id

RPM version:

yum install isc-kea-premium-flex-id

So now Kea is installed and can be configured; the configuration files are located in the /etc/kea/ folder.

To start, stop, or restart Kea daemons, systemctl should be used.

Deb version:

systemctl enable isc-kea-dhcp4-server
systemctl start isc-kea-dhcp4-server
systemctl stop isc-kea-dhcp4-server

RPM version:

systemctl enable kea-dhcp4-server
systemctl start kea-dhcp4-server
systemctl stop kea-dhcp4-server

There is a difference between deb and RPMs: deb services have the isc- prefix.