# Stork 2.1.0 Release Notes, December 11, 2024

Welcome to Stork 2.1.0, the first development release of version 2. The
changes introduced in this version are:

1. **Default RNDC key detection:** BIND 9 uses the RNDC key to secure
the control channel; the Stork agent reads the imports in the BIND 9
configuration file to detect its location. However, the key path is
optional, and its default value points to a file in the `etc` directory.
The Stork agent now handles this case from the current version and
detects the RNDC key even if it isn't explicitly provided. This solves a
problem when BIND 9 is installed from the official Ubuntu repository and
implements such an approach in the default configuration.
2. **Improved software versions view:** In the last Stork release, we
introduced a software versions view that allows you to quickly check the
versions of all installed ISC software (Kea, BIND 9, and Stork) and see
which ones are outdated. In this release, we introduced some
improvements for a better user experience. The changes include
clarifying help tips and a new feedback message severity level when the
latest development release is detected.
3. **Subnet name feature:** The subnet list now includes a column with
the subnet name. The `subnet-name` may be any arbitrary label that
allows you to identify your subnets more straightforwardly than the
subnet prefixes. The subnet name is retrieved from the subnet's user
context in Kea; the Stork server reads a value associated with the
`subnet-name` key and displays it. In addition, we have added a JSON
viewer on the subnet page to display all of the user context
information. 
4. **Fixed LDAPS support:** We fixed a bug in the LDAP hook
implementation that prevented Stork from establishing a connection to
the LDAP server over the LDAPS protocol (a connection secured with TLS).
5. **LDAP hook in the demo:** We added support for the LDAP hook in the
Stork demo. The demo now runs with an OpenLDAP server instance and loads
the LDAP hook, so users may easily test its capabilities and see how
external authentication works in Stork.

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.0.0.

* 477 [bug] slawek

    Fixed a bug in the LDAP hook that made connecting to the server over
    the LDAPS (TLS) protocol impossible. Thanks to Cameron Ditchfield
    for proposing a fix.
    (Gitlab #1488)

* 476 [func] slawek

    The subnet's user context is now displayed on the subnet page. The
    "subnet-name" property value of the context is also shown on the
    subnet list.
    (Gitlab #459)

* 475 [func] piotrek

    The "Software versions" view was updated with a list of small
    changes, such as corrected help tooltip text, adjusted notification
    message severity for development releases, and improved badge
    notification displayed in the top menu.
    (Gitlab #1571)

* 474 [build] slawek

    The demo now loads the LDAP hook and starts the OpenLDAP server.
    (Gitlab #1554)

* 473 [bug] tomek

    The Stork agent can now detect the default RNDC key of BIND 9.
    The parser code can now handle algorithm definitions both quoted and
    unquoted.
    (Gitlab #1590)

Thank you again to everyone who assisted us in making this release
possible.

We look forward to receiving your feedback.