• Share
  • Dark

Kea 0.9.1 Release Notes

  • Updated on 02 Jun 2017
  • 5 minutes to read
  • Contributors 


Kea is a new DHCP implementation being developed by Internet Systems Consortium, Inc. that features fully functional DHCPv4, DHCPv6 and Dynamic DNS servers. Both DHCP servers fully support server discovery, address assignment, renewal, rebinding, release, DNS updates and host reservation. The DHCPv6 server supports prefix delegation. 

This document summarizes features added or significantly changed since the previous release, Kea 0.9. Bug fixes since Kea 0.91 beta are also summarized. Please see the ChangeLog file in the source code release for a complete list of all changes.


The latest versions of Kea software can always be found on our web site at http://www.isc.org/downloads/ or  from ftp.isc.org (this release is http://ftp.isc.org/isc/kea/0.9.1/kea-0.9.1.tar.gz). A PGP signature of the distribution is at http://ftp.isc.org/isc/kea/0.9.1/kea-0.9.1.tar.gz.sha512.asc.  The signature was generated with the ISC code signing key which is available at https://www.isc.org/about/openpgp.

Kea provides detailed documentation, including installation instructions and usage tutorials. In addition, all logging messages have unique documented explanations. This documentation is included with the installation or via http://kea.isc.org/docs/ in HTML, plain text, or PDF formats. We also maintain a public open source code tree 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 http://kea.isc.org/wiki/KeaKnownIssues

We would like testers 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.

If you have any comments or questions about working with Kea, please share them to the Kea Users List or join the Kea Jabber room at dhcp@conference.jabber.isc.org. Bugs and feature requests may be submitted via the ticket tracking system at http://kea.isc.org/.



Professional support will be available when Kea reaches Release 1.0. 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/.



  • Host Reservation, the ability to add static reservations of addresses (DHCPv4 & DHCPv6), prefixes (DHCPv6) and hostnames (DHCPv4 & DHCPv6) for clients.
  • For DHCPv6 clients, several methods have been provided to extract the client's MAC address from information it sends to the server.
  • Support for the DHCPv6 Information-Request message
  • The periodic removal of redundant information from the "memfile" lease file. (Prior to this, the lease file would grow without bound.)
  • A tool, 'kea-admin', for administrators to create and update the databases used for the MySQL and PostgreSQL backends.

Note: When migrating from Kea 0.9 to 0.91:

  • The JSON configuration file must be updated.
  • The MySQL or PostgreSQL lease databases must be updated (if used).


`The following summarizes the significant changes and important upgrade notes since the previous release (Kea 0.9). (See the git history for more details and additional development.)

919.[doc]stephenCorrected some configuration examples in the documentation.(Trac #3772 git e9f084525bc1eec1cca635c00f33228bf7fac6a4) 918.[func]tomek,tmarkDHCPv6 server now supports static reservations of hostnamesfor clients. Note this resolves #3708 by reducing the numberof calls to selectSubnet to once per client request.(Trac #3689 git c13c824d9948f7e3f71a65ed43798f3b5c14042c) 917.[bug]marcinDHCPv4 server may allocate lease for the client which isusing a non-unique identifier (HW address or client id),if the other identifier is unique.(Trac #3768, git 0f7a029e2a2a7652d49a0bcd9f49e879fac9136f) 916.[func]sarAdd a log message that indicates when the v4, v6 orDHCP-DDNS server has completed processing itsconfiguration and is about to enter the loop to processmessages.(Trac #3755, git c71c7836804842bae51fe79fd599c57f5b3d007d) 915.[func]tomek, marcinThe DHCPv6 server now supports the Relay-Supplied Optionsoption,as defined in RFC 6422. The relay can insert optionsin the relay forward message that the server will send backto the client if certain criteria are met.(Trac #3705, git 4772ee589712f5359ecbd79ebf71fbc7bb68741b) 914.[bug]marcinDHCPv4 server: corrected the logging message issued whenthe server could not allocate or offer the lease for theclient. The corrected message contains the client-id,hardware address, ciaddr and requested-ip-address.(Trac #3737, git 4c56e1348c5d50eaa5b3083a0a8c346966e1b603) 913.[bug]sarHandle recovery properly should the LFC crash whilemanipulating files after completing processing.(Trac #3759, git bb3b4d14119392261a1766da2b406fa46d4c0f21) 912.[doc]sarAdded sections on LFC to the administrators and developersguides.(Trac #3720, git 828b801e6a4616de331588076ab9c4c35677595) 911.[func]*marcinlibdhcp++: the C++ objects representing network interfaces(Iface objects) are now non-copyable. As a result, the APIof the Interface Manager functions returning the pointersto the Iface objects has changed.(Trac #3715, git 7415c74e38e13385a75e7200cb23b7d6ca86df7f) 910.[func]marcinDHCPv4 server supports static reservations of the hostnamesfor the clients.(Trac #3688, git b5c50e2aff64da05b439da8d5fa4913fc8a704ca) 909.[bug]marcinRemoved many cppcheck errors in the code. Also removed thedhcp-ubench test tool.(Trac #3736, git 552aea126e968b78292ae80c1c6a03c9ef4dcdcd) 908.[bug]marcinHandle overflows during time conversions in the MySQL andPostgreSQL lease database backends.(Trac #3673, git 27b4e4590fdee507f0e877d7b771dc6c6457a4b5) 907.[doc]tmarkCorrected depictions of kea-admin command line options fordatabase-name in Kea Administrator Reference. Prior to thisthe document showed "-d" as the database name option, whenin fact it is "-n".(Trac #3742, git ec427e4c9d008abc800f87eda3c0024b35e4c2e2) 906.[doc]tmarkAdded description of a restriction on extracting a MACaddress from an IPv6 link-local address to the KeaAdministrator Reference, section 8.8, item "ipv6-link-local".(Trac #3691, git ca9f5541cb36f815ac614c5c21088d545eafcac6) 905.[func]marcinDHCPv4 server assigns an address from the dynamic addresspool if the reserved address is in use by another client.(Trac #3694, git 95b09ff53b941691cba172c933de0682b05a0d85) 904.[bug]marcinFreeBSD-only change: Disabled unit test expecting the deathof the process when conditional variable was destroyed whenthe thread was still waiting for the variable. This is dueinvalid behavior of the pthread_cond_destroy on FreeBSDwhich should return EBUSY in such case, whereas it returnssuccess error code.(Trac #3710, git bdb442402ef023055715baf597c401c9974a7fb2) 903.[bug]stephenCorrected arithmetical error in the rate control module ofperfdhcp which led to the incorrect calculation of the rateat which packets should be sent.(Trac #3729, git bb5bca3d9b68abc4b83abdd204bfb075dda630ac) 902.[bug]marcinFixed the bug in the DHCPv4 server whereby the serverreconfiguration (using the SIGHUP signal) failed becauseof sockets remaining open since the previous configuration.(Trac #3730, git 3ceb0cd97cf5e44e8fc151d0a38db553530dd3ed)

`Thank You Thank you 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 your feedback.

© 2001-2018 Internet Systems Consortium For 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.

Problems with this site? Email us at marketing@isc.org