Stork 0.16.0, April 7th, 2021, Release Notes
Welcome to the Stork 0.16.0 release, which has returned to a monthly release cycle. The changes introduced in this version are:
Lease information: In this release, the major effort was focused on handling lease information: Stork is now able to do a lease inspection. Leases can be searched by IP address, by MAC address, by DUID (v6 only), or by client-id. The lookup shows results from all servers, if available. This is particularly useful for inspecting leases on a HA pair, which should match between partners in normal operation [#509 (closed)].
Design for incremental lease retrieval: As of this release, Stork is able to look up single leases, using
leaseX-getAPI calls that have been available since Kea 1.3.0. This API works well for single leases but does not scale for massive updates for all leases, especially for larger deployments. For this purpose, we came up with a design that allows Stork to retrieve lease updates from Kea in a continuous manner. The design is available here: https://gitlab.isc.org/isc-projects/stork/-/wikis/Leases-Tracking. We'd appreciate comments and feedback. This design has been completed in Kea ticket [#1230].
DHCPv6 dashboard for Grafana: Stork has supported DHCPv6 from its very early days, including exporting statistics to Prometheus. However, until now, there was no DHCPv6 dashboard for Grafana that could take advantage of that. We tried to make it look as similar to the DHCPv4 dashboard as possible, but there are some differences. There is no concept of
ACK/NAKpackets in the DHCPv6 protocol; instead, the status is conveyed with the
status-codeoption. Another notable difference is that it's infeasible to show pool utilization as a percentage. Regardless of the number of devices in your IPv6 network, even the smallest /64 networks have quintillions of addresses available. We're eager to get your feedback and suggestions on how to expand this and other Stork dashboards [#176 (closed), #469 (closed)].
TLS improvements: We followed up on the TLS work done in the previous release and improved several aspects related to testing [#487 (closed)]. The agent now checks the host information as specified by the user to determine where to listen for incoming server connections [#504 (closed)].
Bugfixes and smaller improvements: With the major task of adding TLS mostly complete, we got back to fixing smaller bugs and made more "quality-of-life" improvements. The demo is now more resilient with some fixes in the connectivity between the Stork server and
agent-kea[#517 (closed)]; the internal IDs used by our front-end code now follow a naming convention that is very helpful for our QA dept, especially for developing better automated tests [#455 (closed)]; and we fixed the broken Prometheus exporter on one of the demo containers [#494 (closed)].
Please see this link for known issues: https://gitlab.isc.org/isc-projects/stork/-/wikis/Known-issues.
Stork has 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.
Stork is released under the Mozilla Public License, version 2.0.
The easiest way to install the software is to use native deb or RPM packages. They can be downloaded from:
The Stork source and PGP signature for this release may be downloaded from:
The signature was generated with the ISC code-signing key which is available at:
ISC provides documentation in the Stork Administrator Reference Manual. It is available on ReadTheDocs.io at https://stork.readthedocs.io/en/latest/, and in source form in the docs/ directory.
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.
Professional support for Stork will become available once it reaches the 1.0 milestone. Existing ISC customers that consider themselves very early adopters may get involved in the development process, including roadmap, features planning, and early testing, but the software maturity level does not constitute a typical professional service before the 1.0 milestone.
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.
The following summarizes changes and important upgrades since the Stork 0.15.0 release.
* 136 [func] marcin Implemented Leases Search. (Gitlab #509) * 135 [func] godfryd Added Grafana dashboard for DHCPv6. Enabled generating DHCPv6 traffic in Stork Simulator. Adjusted Stork demo to handle DHCPv6 traffic. (Gitlab #176) * 134 [bug] godfryd Fixed getting host address for listening in agent. (Gitlab #504)
Thank you again to everyone who assisted us in making this release possible.
We look forward to receiving your feedback.