|
|
# Kea 1.9.2, November 25th 2020, Release Notes
|
|
|
|
|
|
Welcome to Kea 1.9.2, the third monthly release of the 1.9 development branch. As with any other development release, use this with caution. Development releases are not recommended for production use. This development release tackles an assortment of feature improvements and bug fixes.
|
|
|
Welcome to Kea 1.9.2, the third monthly release of the 1.9 development branch. As with any other development release, use this with caution: development releases are not recommended for production use. This development release tackles an assortment of feature improvements and bug fixes.
|
|
|
|
|
|
The most significant changes introduced in this version are:
|
|
|
|
|
|
1. **Global and subnet reservations**. Earlier Kea versions has a single configuration parameter called `reservation-mode` that governed whether host reservations are global or subnet-level (either in pool or out-of-pool) and it was not possible to use different reservation types at the same time. However, in some deployments there is a need to use several types at the same time. As a result, the `reservation-mode` is now deprecated and replaced by three separate boolean parameters: `reservations-global`, `reservations-in-subnet` and `reservations-out-of-pool` which can be controlled independently. This gives users more flexibility in their configuration. Caution is recommended as enabling more lookups has performance implications.
|
|
|
#1405, #1550.
|
|
|
1. **Global and subnet reservations**. Earlier Kea versions had a single configuration parameter called `reservation-mode` that governed whether host reservations were global or subnet-level (either in pool or out-of-pool), and it was not possible to use different reservation types at the same time. However, in some deployments there is a need to use several types at the same time. As a result, the `reservation-mode` parameter is now deprecated and replaced by three separate boolean parameters: `reservations-global`, `reservations-in-subnet`, and `reservations-out-of-pool`, each of which can be controlled independently. This gives users more flexibility in their configuration. Caution is recommended as enabling more lookups has performance implications. #1405, #1550
|
|
|
|
|
|
2. **Fix for lease4-update command in multi-threaded DHCPv4**. A bug has been discovered in the `lease4-update` command when the DHCPv4 server is running in multi-threaded mode. Unfortunately, this command is used in HA scenarios. The bug caused the server to fail to do the lease update properly, while claiming the update was successful. This has now been fixed. A patch for 1.8.0 and 1.8.1 is available. The maintenance release of 1.8.2 that will include this fix is expected in Dec. #1542
|
|
|
2. **Fix for the `lease4-update` command in multi-threaded DHCPv4**. A bug has been discovered in the `lease4-update` command when the DHCPv4 server is running in multi-threaded mode. Unfortunately, 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. A patch for 1.8.0 and 1.8.1 is available; the maintenance release of 1.8.2 that will include this fix is expected in December 2020. #1542
|
|
|
|
|
|
3. **Authentication hook points**. A new `auth` and `response` have been implemented in the Control Agent (CA). It is now possible to load a hook that will be processing incoming HTTP requests and possibly perform access control and audit logging on them. This is a preparation step for a new hook library that will provide a Role Based Access Control. #1421
|
|
|
3. **Authentication hook points**. A new `auth` and `response` have been implemented in the Control Agent (CA). It is now possible to load a hook that processes incoming HTTP requests and performs access control and audit logging on them. This is a preparation step for a new hook library that will provide Role-based Access Control (RBAC). #1421
|
|
|
|
|
|
4. **Escape character codes are more portable**. Code in the shell script has been updated to be more portable. As a result, keactrl can now run on FreeBSD #1424
|
|
|
4. **Escape character codes are more portable**. Code in the shell script has been updated to be more portable. As a result, `keactrl` can now run on FreeBSD. #1424
|
|
|
|
|
|
5. **Documentation updates**. Many Kea ARM updates done by Peter (#1536), and Suzanne (#1539). The Developer's guide has been corrected in several places #1516, as well as some examples in Kea ARM have been corrected #1457. There is a new KB article explaining how to access the Cloudsmith repository #1476 and another one about comparing Host Reservation in Kea to similar mechanism in ISC DHCP #1355.
|
|
|
5. **Documentation updates**. Peter (#1536) and Suzanne (#1539) made many edits to the Kea ARM. The Developer's guide has been corrected in several places (#1516), and some examples in the ARM have been corrected (#1457). There are also new KB articles on accessing the Cloudsmith repository (#1476) and comparing Host Reservations in Kea to the analogous mechanism in ISC DHCP. #1355
|
|
|
|
|
|
6. **Test improvements**. Perfdhcp can now control secs field in DHCPv4 and elapsed time option in DHCPv6. Both are used to simulate clients not getting timely responses from the server, which is essential for triggering HA failure #1332. A number of tests issues were fixed as reported by running unit-tests with reshuffle mode turned on #1442.
|
|
|
6. **Test improvements**. `perfdhcp` can now control the "secs" field in DHCPv4 and the "elapsed time" option in DHCPv6. Both are used to simulate clients not getting timely responses from the server, which is essential for triggering an HA failure (#1332). A number of test issues were fixed as reported by running unit-tests with reshuffle mode turned on. #1442
|
|
|
|
|
|
7. **Build improvements**. The messages printed when dependencies are missing have been reworded and it's now more obvious, which libraries are needed #1492. Config.h file is now included in fall .cc files. This ensures that the global parameters are really applied in all parts of the code #1453.
|
|
|
7. **Build improvements**. The messages printed when dependencies are missing have been reworded to make it clearer which libraries are needed (#1492). The Config.h file is now included in all .cc files, to ensure that the global parameters are really applied in all parts of the code. #1453
|
|
|
|
|
|
## Known Issues
|
|
|
|
... | ... | @@ -69,7 +68,7 @@ ISC provides detailed documentation, including installation instructions and usa |
|
|
|
|
|
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). Also we would 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.
|
|
|
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
|
|
|
|
... | ... | |