= Kea 1.0.0, December 29 2015, Release Notes =
Welcome to the 1.0.0 release of Kea. Kea is an alternative DHCP implementation
being developed by Internet Systems Consortium, Inc. that features fully
functional DHCPv4, DHCPv6 servers, Dynamic DNS updates daemon and a DHCP
performance measurement tool. Both DHCP servers fully support server discovery,
address assignment, renewal, rebinding, release, decline, information request,
DNS updates and host reservation. The DHCPv6 server supports prefix delegation.
Lease information can be stored in CSV files, MySQL or PostgreSQL databases.
Version 1.0.0 adds the following features to Kea:
* Lease expiration. A configurable mechanism which provides the ability
to properly clean up expired leases including hook points, DNS clean up,
* Client classification. Initial support for client classification using
conditional logic expressions to test inbound packet content is available
for both DHCPv4 and DHCPv6.
* Decline support in both DHCPv4 and DHCPv6.
* New statistics. Several new statistics have been added. They can be
used to monitor lease expiration and decline processing.
* PXE boot. Several new DHCPv4 and DHCPv6 options useful for PXE and
iPXE boot are now supported.
* Host Reservations in MySQL. Kea is now able to store host
reservations in both its configuration file and a MySQL database.
While currently available only for DHCPv4, this functionality will
be available for DHCPv6 in an upcoming release.
Important license change:
Kea 1.0.0 is released under new license Mozilla Public License 2.0. Earlier
releases were licensed under the ISC license. The new license is slightly more
restrictive than the original ISC license. If you are planning to redistribute
Kea, please review the terms of the new license. For more details about why we
are making this change, see the blog posting:
The MPL 2.0 license: https://www.mozilla.org/en-US/MPL/2.0/
An excellent FAQ about the MPL2.0: https://www.mozilla.org/en-US/MPL/2.0/FAQ/
== Download ==
The kea-1.0.0 source may be downloaded from:
A PGP signature of the distribution is at
The signature was generated with the ISC code signing key which is available at
ISC provides detailed documentation, including installation instructions
and usage tutorials in the Kea Administrator Reference Manual.
Documentation is included with the installation or via
http://kea.isc.org/docs/ in HTML, plain text, or PDF formats. ISC
maintains a public open source code tree at https://github.com/isc-projects/kea
and wiki pages with roadmap and issue tracking at http://kea.isc.org/.
Limitations and known issues with this DHCP release can be found at
We'd like 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 configuration
or use case. Also we would like to hear whether the documentation is adequate
and accurate (please open tickets for documentation omissions and errors).
We want to hear from you even if everything worked.
== Support ==
Professional support for Kea is available from ISC. Free
best-effort support is provided by our user community via a mailing list.
Information on all public email lists is available at
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 or to
the Kea Jabber room. Bugs and feature requests may be submitted via the ticket
tracking system at
== Changes ==
The following summarizes changes and important upgrade notes since the previous
release (1.0.0-beta2). (See the git history for more details and additional
1079. [bug] jpopelka
Fixed compilation issue in MySQL host data source: the
dhcp_identifier_length is now unsigned long. This addresses
a compilation problem on Fedora.
(Github #17, git 8548d1b589df98cc956b4d80d2cb8819ef576717)
1078. [bug] fdupont
Removed warnings emitted during generation of Doxygen documentation.
(Trac #4234, git b67910a3893bc79eb77a48bae6c31214a317bd40)
1077. [bug] marcin
Addressed regression in distcheck after merge of #4224.
Before the changes one of the lease files produced by
'kea-lfc' was not removed after tests running lease file
cleanup. As a result, the distcheck failed discovering
this file being left after distclean.
(Trac #4249, git 04aa9b95bf8c4dd8b555dd78cc8cd57126473800)
1076. [bug] tmark
This change bumps the MySQL schema version from 4.0 to 4.1 and includes
the following changes: added explicit use of InnoDB engine to all MySQL
table create statements, MySQL lease dump output is now sorted by lease
address in ascending order, and the MySQL lease_hwaddr_source table now
contains an entry for HWADDR_SOURCE_UNKNOWN (i.e. source = 0). Our thanks
to Sebastien Couture at Ubity Inc. for reporting the InnoDB engine issue
and submitting a fix for it.
(Github #16, Trac #4237,#4238, git f0fb9f35a394785215573a591c2bcc68ab481436)
1075. [doc] marcin
Changed Kea license from ISC to Mozilla Public License,
(Trac #4236, git a0574cdab4deb31e3244fc4e237753a1ad361d96)
1074. [bug] marcin
PID files created by Kea processes are used in shell based
tests to determine if the given process is running. This
solves the problem whereby some unrelated processes could
be reported as running Kea processes in those tests, causing
the tests to fail.
(Trac #4224, git 94edccc50cb374ec4db35f653b869c9f06d356ea)
1073. [doc] tomek
Developer's Guide updated with client classification text
and several clean-ups.
(Trac #4102, git ac33ebf7428ba5935d3302d000bed317716fabfe)
1072. [bug] tmark
The lease6 hardware address source value is now being properly populated.
Prior to this the value stored with each IPv6 lease was always zero.
(Trac #4247, git 27886dadcf9051dc622ee6fde586c27f3d431f8b)
1071. [func] tmark
Assigned unique log message IDs to log messages issued from
MySQL hosts storage operations, eliminating reuse of
lease database message IDs.
(Trac #4216, git f0e37cd6d45537971a730c68187011dce41217cc)
1070. [doc] sar
Correct v6 classification examples to use client-id (1) instead
of server-id (2).
(Trac #4222, git 69dd98d03861d9de72c2ef75c17c8154b0c5088b)
Thank you again to everyone who assisted us in making this release
possible. If you would like to contribute to ISC to assist us in
continuing to make quality open source software, please visit our
donations page at http://www.isc.org/donate-to-isc/.
We look forward to receiving your feedback.
© 2001-2017 Internet Systems ConsortiumFor assistance with problems and questions for which you have not been able to find an answer in our Knowledge Base, we recommend searching our community mailing list archives and/or posting your question there (you will need to register there first for your posts to be accepted). The bind-users and the dhcp-users lists particularly have a long-standing and active membership.ISC relies on the financial support of the community to fund the development of its open source software products. If you would like to support future product evolution and maintenance as well having peace of mind knowing that our team of experts are poised to provide you with individual technical assistance whenever you call upon them, then please consider our Professional Subscription Support services - details can be found on our main website.