# Stork 1.14.0 Release Notes, December 6, 2023 Welcome to Stork 1.14.0, another development release. The changes introduced in this version are: 1. **Pool management**: We have extended the subnet-editing UI form with new components to manage address pools (v4 and v6) and prefix delegation pools (v6-only). Both pool forms allow for specifying Kea-specific parameters such as client class and required client classes. They also allow for specifying pool-level DHCP options. Excluded prefixes can be specified for the prefix delegation pools. Since subnets can be shared between several Kea instances, the new pool management mechanism lets the user select which Kea servers sharing a subnet should also use a given pool. For example: two Kea servers using the same subnet may have different sets of pools configured for this subnet, which may be useful in cases when two servers are connected to the same lease database. An administrator may wish to use non-overlapping address spaces between the Kea servers to avoid address assignment collisions [#1208]. 2. **Relay address in subnet**: The subnet form now provides a way to specify relay agent addresses. The Kea server uses the addresses to select the subnet for DHCP requests received from any of these addresses [#1230]. 3. **New UI features**: We added a button on the Kea applications page to trigger forcibly re-fetching configurations from the Kea servers. The need to use this button is rare but may be helpful in cases when the Kea configuration information diverges between Stork and the Kea servers, which may be a result of a software bug [#1206]. The settings page now has the ability to specify custom apps state puller and metrics collector intervals [#1210]. 4. **Build improvements**: Compatibility of the Stork binaries with Ubuntu 20.04 and Ubuntu 18.04 has been restored [#1201]. We resolved Stork build issues on OpenBSD and 32-bit ARM architectures [#1231, #1169]. 5. **Security**: Several vulnerabilities in the UI and backend dependencies were addressed [#1233]. TLS 1.0 and TLS 1.1 are now disabled in communications between the server and agent. TLS 1.3 is now used by default [#1197]. 6. **Bug fixes**: We fixed issues with specifying the environment file location with the `--use-env` CLI flag, and removed the unused `--prometheus-bind9-exporter-interval` CLI flag [#1219]. The allowed ranges for T1 percent and T2 percent parameters and initialization of the valid lifetime parameter in the subnet form have been corrected [#1195]. The Stork server now correctly parses the `output-options` parameter alias in the Kea logging configuration. The introduction of this alias confused the Kea configuration parser in Stork and resulted in a log viewer malfunction [#1198]. 7. **Documentation**: We added documentation for the hook framework [#779]. Register command arguments in the stork-agent man file are now documented [#1158]. We corrected links to the Kea hooks Administrator Reference Manual (ARM) on the Kea application page [#915]. Please see this link for known issues: https://gitlab.isc.org/isc-projects/stork/-/wikis/Known-issues. ## Incompatible Changes There are no incompatible changes in this release. ## Release Model Stork has bi-monthly development releases, with some exceptions. We encourage users to test the development releases and report back their findings on the stork-users mailing list, available at https://lists.isc.org/mailman/listinfo/stork-users. This text references issue numbers. For more details, visit the Stork GitLab page at https://gitlab.isc.org/isc-projects/stork/issues. ## License Stork is released under the Mozilla Public License, version 2.0. https://www.mozilla.org/en-US/MPL/2.0 ## Download The easiest way to install the software is to use native deb or RPM packages. They can be downloaded from: https://cloudsmith.io/~isc/repos/stork/ The Stork source and PGP signature for this release may be downloaded from: https://downloads.isc.org/isc/stork The signature was generated with the ISC code-signing key, which is available at: https://www.isc.org/pgpkey ISC provides documentation in the Stork Administrator Reference Manual (ARM). It is available on ReadTheDocs.io at https://stork.readthedocs.io/en/latest/, and in source form in [the doc/ directory](https://gitlab.isc.org/isc-projects/stork/-/tree/master/doc). 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 stork-users mailing list (https://lists.isc.org/mailman/listinfo/stork-users). We would also like to hear whether the documentation is adequate and accurate. Please open tickets in the Stork GitLab project for bugs, documentation omissions and errors, and enhancement requests. We want to hear from you even if everything worked. ## 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/mailinglists/. If you have any comments or questions about working with Stork, please share them to the stork-users list (https://lists.isc.org/mailman/listinfo/stork-users). Bugs and feature requests may be submitted via GitLab at https://gitlab.isc.org/isc-projects/stork/issues. ## Changes The following summarizes changes and important upgrades since the previous Stork release, version 1.12.0. * 357 [bug] piotrek Corrected wrong anchors to Kea hooks ARM docs in Kea application page. For Kea version >= 2.4 new std-ischooklib-* anchors are used. (Gitlab #915) * 356 [doc] slawek Added the hook framework documentation. (Gitlab #779) * 355 [bug] slawek Restored compatibility of the Stork binaries with Ubuntu 18.04 and Ubuntu 20.04. (Gitlab #1201) * 354 [sec] marcin Upgraded some UI and backend dependencies to remove critical vulnerabilities for Stork 1.14.0. (Gitlab #1233) * 353 [bug] slawek Fixed issues with specifying the environment file location with the --use-env CLI flag. Removed unused --prometheus-bind9-exporter-interval CLI flag. (Gitlab #1219) * 352 [build] slawek Enhanced the build system to recognize ARM64 architecture on the OpenBSD operating system. (Gitlab #1231) * 351 [sec] slawek Disabled the TLS 1.0 and 1.1 protocols in the GRPC server of the Stork agent. The Stork server communicates with the Stork agent over TLS 1.3 by default. (Gitlab #1197) * 350 [func] marcin Extended subnet form for specifying relay addresses. (Gitlab #1230) * 349 [build] slawek Updated the simulator Python dependencies. (Gitlab #1166) * 348 [func] marcin Added a button to manually trigger updating Kea configurations in the Stork database from the Kea servers. (Gitlab #1206) * 347 [func] marcin Enabled subnet form with the pool management. (Gitlab #1208) * 346 [func] marcin Extended the settings page with the ability to specify custom apps state puller and metrics collector intervals. (Gitlab #1210) * 345 [doc] marcin Documented register command arguments in the stork-agent man file. (Gitlab #1158) * 344 [bug] marcin Corrected allowed ranges for T1 Percent and T2 Percent parameters in the subnet edit form. Corrected initializing the Valid Lifetime parameter value in the subnet form. (Gitlab #1195) * 343 [bug] marcin The agent recognizes a new alias output-options introduced in Kea 2.5 logger configuration. (Gitlab #1198) * 342 [build] slawek Changed the convention of preparing the ChangeLog file to avoid merge request conflicts. (Gitlab #1120) * 341 [build] slawek Fixed the cross-compilation problem for 32-bit ARM architectures caused by invalid architecture labels. (Gitlab #1169) Thank you again to everyone who assisted us in making this release possible. We look forward to receiving your feedback.