# Kea 2.0.3, July 27th 2022, Release Notes Welcome to Kea 2.0.3, a maintenance release of the stable 2.0 branch. Kea is a DHCP implementation developed by Internet Systems Consortium (ISC) that features DHCPv4 and DHCPv6 servers with DNS update and a RESTful API; optional database support (MySQL and PostgreSQL); optional RADIUS, Kerberos, and YANG/NETCONF support; and much more. Kea provides extensive management capabilities, including but not limited to: TLS support, runtime configuration monitoring and updates via a RESTful API, host reservations, client classification, and more. The text below references issue numbers. For more details, visit the Kea GitLab page at https://gitlab.isc.org/isc-projects/kea/issues. If you are upgrading from the previous stable version, the following deficiencies have been addressed since Kea 2.0.2: 1. **Bug fix: Race condition in HA+MT**: Under certain conditions, especially under heavy traffic when both High Availability and Multi-Threading were enabled, a rare race condition could occur that would lead to two threads processing the same structure, which caused Kea to crash. The problem has been fixed [#2473, #2477]. 2. **Bug fix: Invalid subnet-id in shared networks**: Under specific conditions (multiple clients matching the the same address in shared networks), Kea could store a lease with an invalid subnet-id. This has now been corrected. With the fix, the first client is now assigned the fixed address, and any subsequent client is given a dynamically allocated address from a different subnet in the shared network [#2409, #2485]. 3. **Bug fix: Missing server principals in the GSS-TSIG hook**: The subscriber-only GSS-TSIG hook now properly handles cases when the server principal does not exist. Previously, an exception was thrown that led the DDNS daemon to shut down [#2486, #2396]. ## License This version of Kea is released under the Mozilla Public License, version 2.0. https://www.mozilla.org/en-US/MPL/2.0 The premium and subscriber-only hook libraries are provided under the terms of an End User License Agreement. ## Download Pre-built ISC packages for current versions of the most popular Linux operating systems are available at: https://cloudsmith.io/~isc/repos/ 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, plain text, or PDF 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 and DHCP 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.0.2 release. ```plaintext 1961. [build] razvan Library version numbers bumped for Kea 2.0.3 stable version. (Gitlab #2488) 1960. [bug] marcin A bug in the allocation engine, which caused it to write an allocated lease under the wrong subnet ID within a shared network, has been corrected. This was occurring when multiple clients matched the same fixed address reservation. The first client is now assigned the fixed address, while a subsequent client is then given a dynamically allocated address from a different subnet in the shared network. (Gitlab #2409, #2485) 1959. [bug] razvan, marcin Fixed a crash in the HA+MT scenario caused by a race condition between resetting the CalloutHandle state and accessing hook point parameters from different threads when unparking packets. (Gitlab #2473, #2477) 1958. [build] andrei Froze Sphinx dependency versions used to build documentation. Added the update-python-dependencies Makefile rule to bump the versions. (Gitlab #2161, #2340) ``` The following summarizes changes in the premium hooks since the 2.0.2 release: ```plaintext 129. [bug] fdupont Handle exceptions thrown by TSIG exchange initialization: for instance, when the server principal does not exist. Previously, an exception caused the DDNS server to exit. (Gitlab #2486, #2396) ``` Thank you again to everyone who assisted us in making this release possible. We look forward to receiving your feedback.