# Stork 2.1.1 Release Notes, February 5, 2025 Welcome to Stork 2.1.1, the second development release in the 2.1 series. The changes introduced in this version are: 1. **Online version reporting** Starting with this release, Stork is now able to retrieve and update the information about available BIND 9, Kea, and Stork versions and report possible upgrade opportunities. For this feature to work, ISC implemented an online infrastructure. Feedback regarding this feature is most welcome [#1636]. The versions available in etc/versions.json were bumped up [#1685]. 2. **BIND 9 zone inventory**: Work is in progress to eventually display a list of views and zones from a BIND 9 server. While there are no user-visible elements in the UI yet, this release introduces one essential building block for the upcoming feature: a zone inventory. The Stork agent, when detecting BIND 9 with the statistics channel configured, will retrieve the zone and view information and cache it locally, either in memory, on disk, or both [#1647]. The Stork agent's HTTP client was refactored significantly [#1638]. 3. **Editable subnet names**: A previous Stork release introduced the ability to display subnet names, stored in the subnet's user-context. As of this release, it is possible to edit or add names for subnets easily, using the Stork UI [#1641]. Subnet names can be any information that is meaningful to the administrator. 4. **Security**: When the LDAP hook is loaded, LDAP is selected as the primary authentication method by default on the login screen [#1648]. The Stork agent can now automatically retrieve and use Kea credentials for the Control Agent (CA) [#1624]. 5. **UI improvements**: Many UI messages were reworded for clarity and grammar [#1673]. The "machines" view was refactored and many bug reports were addressed [#1681, #1677, #1600, #1616, #1657, #1533]. We removed an unused link to Prometheus from the configuration interface [#1609]. 6. **Bug fixes**: Earlier Stork versions didn't handle the dash separator in the `hw-address` correctly. This is now fixed [#1670]. We enabled timeouts for HTTP clients connecting to Kea, which should handle communication issues between Stork agents and Kea servers more gracefully [#1467]. The recently introduced MySQL and PostgreSQL Kea hooks are now listed properly [#1588]. We fixed a bug in the installation procedure that could set incorrect attributes in the destination directory. This affected only manual compilation and installation (`rake install:*` commands) [#1614]. 7. **Documentation**: The Stork ARM now covers the topic of LDAP configuration and authentication [#1652]. 8. **Build improvements**: The dependencies were updated [#1676]. 9. **Testing and CI**: New tests were implemented to ensure Stork is able to handle a new Kea feature: custom HTTP headers, in particular HSTS. It seems to be working fine and no changes in the Stork code were necessary [#1589]. The GitLab CI now includes a report about test execution and code coverage [#1659]. 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. 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, or report bugs at https://gitlab.isc.org/isc-projects/stork/-/issues/. 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 2.1.0. * 491 [bug] slawek Fixed a bug in the "install:*" commands that caused the overriding of attributes of the system directories on specific operating systems. (Gitlab #1614) * 490 [func] marcin Implemented a DNS "zone inventory" in the Stork agent. It adds the capability for the Stork agent to gather a list of views and zones from BIND 9 on startup. This list is stored in the agent's memory but is not yet available to the Stork server. This change provides no new user-visible capabilities to the Stork agent, but lays the foundation for the zone viewer feature. (Gitlab #1647) * 489 [doc] slawek, bscott Added an LDAP hook documentation. (Gitlab #1652) * 488 [doc] sgoldlust Editorial and grammatical corrections in UI components. (Gitlab #1673) * 487 [build] slawek Updated dependencies including the Go 1.23.5, and several JavaScript, Python, Ruby and Go packages. (Gitlab #1676) * 486 [func] piotrek Reworked filtering in Machines list view. Filters are now unified with other Stork views that display tables and allow data filtering. It is possible to search for machines globally by keyword regardless of the authorization state. (Gitlab #1533) * 485 [func] slawek The authentication methods provided by hooks are presented before the internal method on the login page. (Gitlab #1648) * 484 [bug] slawek Fixed adding a host reservation with a hex identifier delimited by a dash. (Gitlab #1670) * 483 [func] slawek Stork agent now retrieves the Basic Auth credentials from the Kea CA configuration file. It is no longer supported to provide the JSON file with a login and password to the Kea REST API. The agent selects credentials with a "stork" user name or prefix. If no user is found, it uses the first credentials entry. (Gitlab #1624) * 482 [func] slawek Added an input to alter the subnet name. (Gitlab #1641) * 481 [bug] marcin Enabled timeouts for HTTP client connecting to Kea. It should help to gracefully handle communication issues between Stork agents and Kea servers. (Gitlab #1467) * 480 [func] piotrek The feature which informs about used Kea, BIND 9, and Stork versions was improved to download the metadata about current software releases from an online source. The user may disable this feature in settings so the built-in offline JSON file can be used as a metadata source instead. (Gitlab #1636) * 479 [func] piotrek Anchors to Kea hooks documentation were improved to be automatically generated. This way the anchors will be always up-to-date with new Kea hooks. (Gitlab #1588) * 478 [build] tomek The native packages now have better descriptions. (Gitlab #1618) Thank you again to everyone who assisted us in making this release possible. We look forward to receiving your feedback.