# Kea 1.8.2, Dec 16th 2020, Release Notes

Welcome to Kea 1.8.2, the second maintenance release of the 1.8 series. 
Kea is a DHCP implementation developed by Internet Systems Consortium, 
Inc. that features fully functional DHCPv4 and DHCPv6 servers, a dynamic 
DNS update daemon, a Control Agent (CA) that provides a REST API to 
control the DHCP and DNS update servers, an example shell client to 
connect to the CA, a daemon that is able to retrieve YANG configuration 
and updates from Sysrepo, and a DHCP performance-measurement tool. Both 
DHCP servers support server discovery, address assignment, renewal, 
rebinding, release, decline, information request, DNS updates, client 
classification, and host reservations. The DHCPv6 server also supports 
prefix delegation. Lease information is stored in a CSV file by default; 
it can optionally be stored in a MySQL, PostgreSQL, or Cassandra 
database instead. Host reservations can be stored in a configuration 
file, or in a MySQL, PostgreSQL, or Cassandra database. They can also be 
retrieved from a RADIUS server, although this functionality is somewhat 
limited. Kea DHCPv4 and DHCPv6 daemons provide support for YANG models, 
which are stored in a Sysrepo datastore and can be configured via the 
NETCONF protocol.

This is a maintenance release. If you are interested in the latest 
development releases with new features, please look at the development 
1.9.x series.

The text below references issue numbers. For more details, visit the Kea 
GitLab page at https://gitlab.isc.org/isc-projects/kea/issues.

The following bug fixes were implemented since version 1.8.1:

1. **Fix for the `lease4-update` command in multi-threaded DHCPv4**. A 
bug in the `lease4-update` command was discovered when the DHCPv4 server 
was running in multi-threaded mode. This command is used in HA 
scenarios. The bug caused the server to fail to update the lease 
properly, while reporting incorrectly that the update was successful. 
This has now been fixed. #1572

2. **Missing schema update scripts**. Kea previously failed to install 
some schema update scripts when using the `make install` command. This 
problem is now resolved. #1580

3. **Compilation fix for latest Cassandra driver**. The Kea code now 
compiles properly with the latest versions of cpp-driver, which is 
required for Cassandra database support. #1579

4. **Compilation warning in host cache fixed**. A minor compilation 
warning in the host cache hook library has been fixed. #1582

## Incompatible Changes

There are no backward-incompatible changes introduced in this release.

## 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 hooks 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 via 
https://kb.isc.org/docs/kea-administrator-reference-manual 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 upgrade notes since the 
1.8.1 

```
1803.   [build]         razvan
        Library version numbers bumped for Kea 1.8.2 stable release
        version.
        (Gitlab #1583)

1802.   [bug]           andrei, razvan
        Fix trivial logic error in handling the "lease4-update" command
        manifesting itself on v4 if multi-threading is enabled.
        Notable affected environment is a HA with the
        "send-lease-updates" configuration setting explicitly set to
        true. Prior to this fix, lease updates would not go through to
        other HA nodes, even though some log lines would say they would.
        A simple workaround prior to this fix is to disable
        multi-threading.
        (Gitlab #1542,#1572)
```

Thank you again to everyone who assisted us in making this release 
possible.

We look forward to receiving your feedback.