Kea Cloudsmith Repository Updates
Many Kea DHCP users use ISC packages, so we want to let everyone know that we will be cleaning up some older repositories on Cloudsmith.
ReadCentralize monitoring and configuration
Stork is an open source project that provides a graphical interface for monitoring, troubleshooting, and maintaining the configuration of, Kea DHCP servers. Stork provides a layer of administrative control for your Kea servers, including integration with LDAP for administrator authentication and authorization.
Stork is comprised of two components: the Stork server (stork-server) and the Stork agent (stork-agent). Stork interacts with the Kea servers via the agents, installed on each Kea server. One Stork server is deployed in a network, providing an integrated, centralized front end for these services. The Stork server can integrate with Prometheus and Grafana for warehousing and visualizing DHCP usage data.
Stork leverages several of the optional Kea hook libraries. We strongly recommend Stork users install at least the lease_cmds
and stat_cmds
on Kea servers they want to manage with Stork. Kea may optionally be deployed with a database backend for host reservations, and if it is, Stork will manage the host reservations in the database. Most Kea users deploy the optional high availability hook - if your Kea servers are configured to work as HA pair then Stork will use this library to display the HA status.
Stork requires the subnet_cmds
hook installed on the Kea servers in order to modify subnets and pools: it also enhances the metrics passed to Prometheus by including subnet labels. Without this hook, Prometheus identifies subnets by subnet IDs. The subnet_cmds
hook is commercially licensed.
Stork does not require nor integrate with the optional Kea configuration backend.
Stork is open source, shared under MPL2.0 licensing. Stork is developed in the open on ISC’s GitLab; we welcome you to open issues and submit patches there. Stork runs on most Linux and Unix platforms, as well as MacOS. If you don’t want to build from our source distribution, we also provide a repository of pre-built packages for most popular operating systems, for both Kea and Stork.
Contact ISC for Support
Your major design decisions are whether to deploy in pairs for High Availability and use the default csv file for host and lease data, or to install a separate database for a Kea data “backend.” Some of these decisions can limit your performance. See our Knowledgebase for advice on designing for optimal performance.
Instructions are available for building and installing Kea from the source packages downloadable below. ISC provides pre-built packages for RHEL, Fedora, Ubuntu, and Debian. If you are using any Kea hook libraries, you will also need to install and configure those.
The Kea Administrator Reference Manual (ARM) is the primary reference for Kea configuration. The extensive set of example configuration filesin the project repo and our knowledgebase may help you get started. If you are migrating from an existing ISC DHCP deployment, try the Kea Migration Assistant (a special feature of the ISC DHCP distribution). This will enable you to save your current ISC DHCP server configuration as a Kea configuration file. It will still need some manual adjustment, but this tool should translate the bulk of your configuration.
Most users will benefit from joining the stork-users mailing list. Consider joining our Stork project GitLab to log issues, see what we’re working on, submit patches, and participate in development. You might want to read about our Premium and Subscriber-only Kea libraries, which Stork uses for management. If your DHCP is critical to your business, we recommend you subscribe for technical support from ISC.
Stork aggregates data about the health of the system hosting Kea, as well as the status and activity level of Kea itself. Parameters reported include memory, CPU utilization, software versions, and uptime.
Stork displays configured pools, with # of addresses provisioned and assigned and even tracks pool utilization across shared networks. Graphical elements highlight areas of high utilization to alert the operator to take actionHigh Availability pairs are monitored and their configured role and status are shown, making it easy to see which servers don’t have a backup established, and when a failover event has occurred.
Add, update and view DHCPv4 and DHCPv6 host reservations, using a graphical interface to select a host identifier, assign a hostname, reserve an IP address, associate a client class, and configure boot file information and DHCP options.
The Kea distribution includes separate daemons for a DHCPv4 server, a DHCPv6 server, and a dynamic DNS (DDNS) module. Bundled with Kea are a portable DHCP library (libdhcp++), a control agent that provides the REST management interface for Kea, a NETCONF agent that provides a YANG/NETCONF interface, a DHCP benchmarking tool, perfdhcp. The dynamically loadable hook libraries included in the MPL2.0-licensed open source distribution are: Bootp, Flexible Options, High Availability, Lease Commands, Run Script and Stats Command.
Add and change subnets and pools using Stork. Select which Kea servers to apply these changes to. Note that this requires Kea to be installed with the Subnet Commands hook, available to software support subscribers.
Kea high-availability mode provides resilience for either DHCPv4 or DHCPv6, using either a 50/50 load-balancing or active/standby configuration. This feature is implemented with the HA hook library, part of the open source. Stork provides visibility into HA pairings, and the current status of each member of the HA group.
The Stork dashboard is a web-based system that displays critical information about service availability, CPU and memory capacity, pool utilization, failover status and DHCP traffic statistics. Stork integrates with the popular Prometheus time-series data store and Grafana visualization system. Stork is available as open source from ISC’s GitLab repository, or in a ready-to-install package from Cloudsmith.io.
ISC Support Subscribers receive all our Premium Kea hook libraries, PLUS several additional libraries that will be most useful in larger deployments. Stork may leverage the following Kea subscriber hooks. These hooks are licensed under the ISC HBCEULA. ISC Support is offered as an annual subscription.
The Leasequery library allows you to retrieve a single lease, identified by IP address, hardware address or client identifier. Bulk leasequery is supported with Kea 2.3.5 and later versions.
The Ping Check library adds the ability to perform a ping check of a candidate IPv4 address prior to offering it to a DHCP client. This feature is similar to a behavior available in ISC DHCP and one suggested in RFC 2131. Ping check is supported with Kea 2.5.4 and later versions.
The Subnet Commands library allows you to add, remove, and modify subnets via the API, without resending the entire Kea configuration.
The Enterprise features are reserved for customers with Silver or Gold support from ISC. This new tier includes the Role-based Access Control feature. This hooks is licensed under the ISC HBCEULA. Contact our friendly sales team to buy a support plan that includes this commercially-licensed library.
The RBAC library, supported with Kea 2.2 and later, allows the administrator to control authenticated user access to read and write Kea configuration data.
Join the stork-users mailing list to offer help to or receive advice from other users.
Join NowBefore submitting a bug report please ensure that you are running a current version. Then log your report as an issue in our Stork GitLab project.
ReportPremium libraries add the Host Reservation API, Flexible Host Identifier, & Forensic Logging.
Buy