# Stork 1.16.0 Release Notes, April 5, 2024

Welcome to Stork 1.16.0, another development release. The changes
introduced in this version are:

1. **Security**: Updated GO to version 1.22.2, which includes a fix for
CVE-2023-45288 [#1353]. The documentation has been expanded to reference
an ISC KB article that explains how to generate certificates and keys
[#1341].

2. **New Features**: Stork can now monitor the new HA hub-and-spoke
configuration recently implemented in Kea [#1274]. It is capable of
detecting inconsistent or duplicated DHCP data across different host
data sources and will highlight these discrepancies with labels in the
host list [#977].

3. **UI Improvements**: Machines being authorized will now appear greyed
out in the UI table for the duration of the authorization process
[#1269]. The UI will display a message indicating the absence of data
instead of showing an empty table [#1307]. Addresses of long subnets
will no longer wrap to two lines in the subnet bar [#1299]. Stork will
display an alert about connectivity issues between the server and
monitored machines [#1222].

4. **Bug Fixes**: Fixed a hang in the Stork server shutdown process when
there are open SSE connections [#1244]. Stork will no longer attempt to
query for leases when a DIUD of length less than three is entered into
the search box [#1301]. Resolved issues with filtering in global host
reservations when used in combination with other filters [#1282].

5. **Package Update Process**: Scripts for package installation have
been updated to ensure that the Stork systemd service remains active
during updates [#1319].

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

* 398 [build] piotrek

    Updated dependencies including the Go 1.22.2, Angular 17.3.2,
    and several Python packages. Updated Alpine CI image to include
    new Go 1.22.2 package.
    (Gitlab #1353)

* 397 [func] piotrek

    Improved UI/UX when Machine is being authorized. This process may
    take some time, so for the time when this operation is in progress,
    machines table UI is greyed out. The same improvement was added
    when authorizing more than one machine at once.
    (Gitlab #1269)

* 396 [func] piotrek

    Added information about empty dataset to tables in views:
    Hosts list, Shared networks list, Subnets list, Users list.
    Now, whenever there is no data to be displayed, the feedback
    about that fact is shown.
    (Gitlab #1307)

* 395 [bug] piotrek

    Fixed a minor UI issue where a longer subnet prefix could break in
    two lines in the subnet bar. Now, the subnet bar should always be
    displayed in one line.
    (Gitlab #1299)

* 394 [build] slawek

    Improved the package installation scripts to avoid turning off the
    Stork systemD service on update.
    (Gitlab #1319)

* 393 [bug] slawek

    Stork now respects the minimum DUID length of 3 enforced by Kea
    2.3.8+ and does not query it for leases when too short DUID is
    specified in the lease search box.
    (Gitlab #1301)

* 392 [func] marcin

    High Availability status for a daemon now contains the state of
    all HA relationships. It facilitates monitoring the hub-and-spoke
    configuration recently implemented in Kea.
    (Gitlab #1274)

* 391 [bug] marcin

    Enabled some dead events for BIND 9 and added the events panel on
    the BIND9 app tab.
    (Gitlab #1303)

* 390 [doc] marcin

    Added reference to the ISC KB article describing how to generate
    the certificates and keys.
    (Gitlab #1341)

* 389 [bug] slawek

    Fixed unavailable Prometheus metrics endpoint of the Stork server in
    the demo environment. Use Stork server logger in the Prometheus
    metrics collector.
    (Gitlab #1289)

* 388 [func] slawek

    Stork now detects a given daemon's inconsistent or duplicated DHCP
    data in different host data sources and displays them as labels on
    the host list.
    (Gitlab #977)

* 387 [bug] slawek

    Fixed filtering global host reservations with a combination of other
    filters. Previously, global hosts were appended to the hosts
    returned by other filters. Now, a subset of global hosts matching
    other filters is returned.
    (Gitlab #1282)

* 386 [bug] slawek

    Fixed setting the application state puller interval. Its input box
    value was not used.
    (Gitlab #1258)

* 385 [func] marcin

    Show an alert in a prominent place about the connectivity issues
    between the Stork server and the monitored machines.
    (Gitlab #1222)

* 384 [build] marcin

    Enabled building Stork and the demo on Apple M3 chipset.
    (Gitlab #1321)

* 383 [bug] marcin

    Prevent a hang in the Stork server shutdown when there are
    open SSE connections.
    (Gitlab #1244)

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

We look forward to receiving your feedback.