# Stork 1.12.0 Release Notes, August 2, 2023 Welcome to Stork 1.12.0, another development release. The changes introduced in this version are: **Subnets and shared networks views**: Subnet details can now be inspected via a subnet view [#931]. In particular, it provides insight into the global/network/subnet parameters inheritance [#953]. Another view was added that allows inspection of shared networks and their parameters [#1119]. **BIND 9 support**: The Stork Agent now detects BIND 9 instances properly, even if the `-c` flag is not used [#1057]. Gzip compression for communication between the Stork server and agent enables retrieval of large batches of BIND 9 statistics. Stork now accepts payloads up to 40MiB uncompressed size. This may also help with large Kea deployments [#1059]. **User experience**: The Stork agent no longer prints a long list of errors about missing certificates [#973]. The log messages produced by the Stork agent during startup have been refactored to be more straightforward and user-friendly [#1056]. Long IPv6 subnets are no longer truncated in the UI [#1060]. Several small UI problems were fixed [#1053]. **Kea configuration checks**: A new check was added: Stork now prints a warning if Kea is missing the configuration for a control socket. Kea can run without a control socket, but it will not be able to receive any commands [#1045]. **Host reservations**: Hosts can now be filtered by subnet ID. This allows searching for hosts related to a particular subnet [#1058]. **Bug fixes**: A bug was fixed in the script to install the Stork agent using a server token, which caused installation errors due to incorrect paths to the deployed packages. The script no longer requires all Stork agent package formats to be deployed on the Stork server, and it uses the available formats for the matching operating systems where the Stork agent is installed [#932]. Displaying of empty HA failure time was fixed [#1123]. **Testing and QA**: Python test-code quality was improved; it now achieves the maximum 10.0 score on pylint [#1044]. A problem was fixed related to a test failing when running with a DB running in Docker [#1052]. CI pipelines were updated [#1115, #1118]. **Documentation**: An example for configuring an Apache web server to access Stork in a subdirectory was added [#1039]. The Developer's Guide is now a stand-alone document [#786]. 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.11.0. * 322 [func] slawek Added a configuration option to handle requests directed to URL subdirectory (instead of URL root). Included an example Apache configuration file. (Gitlab #1039) * 321 [build] slawek Refactored and formatted to the Python codebase to reach the highest quality rate from the linter. (Gitlab #1044) * 320 [bug] slawek Fixed a bug in the script installing the Stork agent using a server token. This bug caused installation errors due to wrong paths to the deployed packages. The script no longer requires all Stork agent package formats to be deployed in the Stork server, and it will use the available formats for the matching operating systems where the Stork agent is installed. (Gitlab #932) * 319 [func] marcin Created shared network view in the WebUI that contains shared network details, including DHCP parameters and options. (Gitlab #1119) * 318 [func] slawek Added a new checker to verify if the Kea Control Agent configuration includes the control sockets. Added a descriptive message about possibly missing control socket configuration of the Kea DHCP daemons. (Gitlab #1045) * 317 [bug] slawek Fixed bug with detecting RNDC key if the -c flag is not used to set the config path in BIND 9. (Gitlab #1057) * 316 [func] slawek Refactored the log messages produced on the Stork agent initialization to be more straightforward and user-friendly. (Gitlab #1056) * 315 [bug] slawek Enabled gzip compression for all communication between the Stork server and agent. It fixes handling a big response of named statistics endpoint. Stork accepts payloads (i.e., responses from Kea and BIND 9 endpoints) up to 40MiB uncompressed size. (Gitlab #1059) * 314 [bug] slawek Fixed a UI problem that caused the IPv6 subnet bars to be unreadable for long addresses. (Gitlab #1060) * 313 [bug] slawek Fixed a rare crash occurring when the state puller schedules the config review for an existing daemon. Set the focus on the login page to the first input. Shrank the width of the lease user context viewer to its content. Fixed a problem with the DHCP identifier button's width. (Gitlab #1053) * 312 [build] slawek Refactored mock file suffixes. The mocks no longer need to be manually registered in the Rake file. (Gitlab #1006) * 311 [func] marcin Subnet view contains DHCP parameters and options. (Gitlab #953) * 310 [func] marcin Filter host reservations by subnet ID. (Gitlab #1058) * 309 [func] marcin A tab with the subnet details is opened after clicking on the subnet. (Gitlab #931) * 308 [doc] tomek The Stork Developer's Guide is now a stand-alone document. You can build it using rake `build:devguide` command. (Gitlab #786) * 307 [bug] marcin Fixed the simulator in Stork demo. (Gitlab #1054) Thank you again to everyone who assisted us in making this release possible. We look forward to receiving your feedback.