# Kea 2.7.3 Release Notes, September 25th, 2024 Welcome to Kea 2.7.3, the third monthly release of the 2.7 development series. As with any other development release, use this with caution: development releases are not recommended for production use. Kea is a DHCP implementation developed by Internet Systems Consortium (ISC) that features DHCPv4 and DHCPv6 servers with DNS update and a REST API; optional database support (MySQL and PostgreSQL); optional RADIUS, Kerberos, YANG/NETCONF, and GSS-TSIG support; and much more. Kea provides extensive management capabilities, including but not limited to: TLS support, Role-Based Access Control, run-time configuration monitoring and updates via a REST API, host reservations, and client classification. The text below references issue numbers. For more details, visit the Kea GitLab page at https://gitlab.isc.org/isc-projects/kea/-/issues. For details about Docker issues, visit the page at https://gitlab.isc.org/isc-projects/kea-docker/-/issues/. For details about packaging, visit the page at https://gitlab.isc.org/isc-projects/kea-packaging/-/issues/. The following bug fixes and features have been implemented since the previous release, version 2.7.2: 1. **Classification changes**: The precedence of options specified in a template class and its spawned classes has been reversed. An option specified in a spawned class now takes precedence over the same option if specified in the template class. This change applies to both kea-dhcp4 and kea-dhcp6 [ #3576]. 2. **PD-Exclude in Host reservations**: The host reservations mechanism now supports the `pd-exclude` mechanism, thus allowing fine tuning of `pd-exclude` on a per-host basis [ #1387]. 3. **Control sockets**: The UNIX control socket code was updated [ #3506]. Extra tests for HTTP/HTTPS control sockets were added [ #3557]. 4. **SQL Hooks**: In preparation for upcoming SQL hooks (expected in future releases), much of the related code was refactored [#3536]. 5. **Bug fixes**: A problem with the HA hook that caused a validation failure when `-T` (test configuration) was used was fixed [ #3542]. 6. **Documentation**: Obsolete notes about bulk leasequery were removed [ #3570]. The Developer's Guide now uses SVG instead of PNG images, dramatically reducing the documentation build size [ #3566]. 7. **Test improvements**: Unit tests no longer fail when the `kea-admin tool` is installed [ #3419]. The hammer tool no longer has occasional problems with starting MariaDB on Alpine [ #3559]. 8. **Build improvements**: One of the release scripts (update-code-for-release.py) was made more robust [ #3600]. A problem was fixed with Kea not able to find `kea-lfc` if it was installed outside of /usr/local/sbin [ #3504]. The `keactrl` script now works better in embedded environments. Thanks to Philip Prindeville for submitting a patch [ #3533]. The compilation was fixed for the upcoming clang/libc++ 19. Thanks to Dimitry Andric for submitting a patch [ #3432]. ## Incompatible Changes There are no incompatible changes. ## License This version of Kea is released under the Mozilla Public License, version 2.0. https://www.mozilla.org/en-US/MPL/2.0 Some Kea hook libraries are provided under the MPL 2.0; others are licensed with the [Kea Hooks Basic Commercial End User License](https://www.isc.org/kea-premium-license/). The source for each hook library includes the applicable license. ## Download Pre-built ISC packages for current versions of the most popular Linux operating systems are available at: https://cloudsmith.io/~isc/repos/ Pre-built Docker images, as well as Docker files, are available. For details, see: https://gitlab.isc.org/isc-projects/kea-docker The Kea source and PGP signature for this release may be downloaded from: https://www.isc.org/download The signature was generated with the ISC code-signing key, which is available at: https://www.isc.org/pgpkey ISC provides detailed documentation, including installation instructions and usage tutorials, in the Kea Administrator Reference Manual. Documentation is included with the installation or at https://kea.readthedocs.io/en/latest/index.html in HTML, PDF, or EPUB formats. ISC maintains a public open source code tree, wiki, issue tracking system, milestone planner, and roadmap at https://gitlab.isc.org/isc-projects/kea. Limitations and known issues with this release can be found at https://gitlab.isc.org/isc-projects/kea/-/wikis/known-issues-list. We ask users of this software to please let us know how it worked for you and what operating system you tested on. Feel free to share your feedback on the Kea Users mailing list (https://lists.isc.org/mailman/listinfo/kea-users). We would also like to hear whether the documentation is adequate and accurate. Please open tickets in the Kea GitLab project for bugs, documentation omissions and errors, and enhancement requests. We want to hear from you even if everything worked. ## Support Professional support for Kea is available from ISC. We encourage all professional users to consider this option; Kea maintenance is funded with support subscriptions. For more information on ISC's Kea software support, see https://www.isc.org/support/. Free best-effort support is provided by our user community via a mailing list. Information on all public email lists is available at https://www.isc.org/community/mailing-list. If you have any comments or questions about working with Kea, please share them to the Kea Users list (https://lists.isc.org/mailman/listinfo/kea-users). Bugs and feature requests may be submitted via GitLab at https://gitlab.isc.org/isc-projects/kea/-/issues. ## Changes The following summarizes changes and important upgrades since the 2.7.2 release. 2286. [func] fdupont Reorganized UNIX control socket code. (Gitlab #3506) 2285. [build] tomek Changed image type in the Developer's guide from PNG to SVG. This drastically reduced the size of the generated docs (from 2.7GB to 560MB). (Gitlab #3566) 2284. [build] razvan The library version numbers have been bumped up for the Kea 2.7.3 development release. (Gitlab #3597) 2283. [func] tmark The order or precedence of options specified in a template class and its spawned classes has been reversed. An option specified in a spawned class now takes precedence over the same option if specified in the template class. This change applies to both kea-dhcp4 and kea-dhcp6. (Gitlab #3576) 2282. [bug] razvan Fixed a bug caused by starting listeners when checking the configuration using the '-T' command line parameter. This was also causing the check to fail if loading the High Availability hook library. (Gitlab #3542) 2281. [bug] andrei An issue was fixed where kea-admin and kea-lfc were not found by the Kea DHCP servers when installed via a custom defined sbindir. (Gitlab #3504) 2280. [func] fdupont IPv6 host reservation syntax now accepts a new entry "excluded-prefixes": a pd-exclude option (RFC6603) can now be added into an iaprefix option carrying a reserved prefix. (Gitlab #1387) 2279. [build] pprindeville Replace the cut and rev utilities with shell variable expansions, improving compatibility with minimal setups on embedded systems. (Gitlab #3533) 2278. [build] dim Replace ``std::basic_string`` with equivalent ``std::vector`` constructs, since the former has been deprecated for a while in libc++, and has been completely removed as of libc++ 19. (Gitlab #3532) And for Kea premium: 206. [bug] razvan Fixed a bug caused by starting listeners when checking the configuration using the '-T' command line parameter. This was also causing the check to fail if loading the High Availability hook library. (Gitlab #3542) Thank you again to everyone who assisted us in making this release possible. We look forward to receiving your feedback.