[stork-users] Stork 1.11.0 is now available

Everett B. Fulton ebf at isc.org
Wed Jun 7 13:59:48 UTC 2023 

Stork 1.11.0 is a new development release of the Stork dashboard for
monitoring Kea servers.

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://www.isc.org/download#Stork

Documentation for Stork is available at:

      https://stork.readthedocs.io

-----
# Stork 1.11.0 Release Notes, June 7, 2023

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

**Lease user context**: The user context for leases can now be inspected
in the lease details view [#999].

**Better BIND 9 detection**: The BIND 9 detection now works properly,
even if the RNDC key is specified outside the default RNDC key file. We
also fixed a rare bug where the Stork server crashes if an error occurs
on a particular stage of BIND 9 detection [#1031].

**Subnet management**: The REST API now returns much more information
about subnets. That information, however, is not yet displayed in the UI
[#1034]. The pools have been moved from the subnet to a local subnet.
This logical change will be particularly useful for tracking subnets
covered by an HA pair; Stork now has a better understanding of which
pools are covered by which partner [#959]. Substantial progress was made
with the subnet UI. However, this code has not been reviewed yet and is
not included in this release [#931].

**UI improvements**: The separate DHCP options are now displayed
properly after editing, without the need to refresh the page [#1017].
The proper font is now used on the logo page [#1000].

**Bug fixes**: We fixed a server crash that occurred when the Stork
agent detected an unusual Kea configuration [#1024]. We fixed a bug in
handling the empty database host that caused user login failures in the
UI. We also fixed the rejection of database usernames containing a dash,
and fixed the printing of error messages related to database
authentication problems [#1022]. We addressed a problem with propagating
the database password to the session manager [#1018]. The include
statements in the Kea Control Agent are now working correctly, even when
the included files have an extension other than `.json` [#1036]. We
corrected subnet filtration that was not working [#1016]. The DB update
statements were corrected to exclude the `created_at` field [#1007].

**Build improvements**: The Python code is now checked against `pylint`
and `flake8` linters, allowing the developers to maintain and improve
code quality [#991]. The `stork-tool` help text was aligned properly
[#1015]. Sed errors were fixed on MacOS [#1019]. A problem with a `rake
prepare:dev` failure when installing gems was fixed [#894]. The
generated files are now excluded from diffs and merge conflicts [#961].

**Testing**: We added system tests for a Stork server and database
running in the same Docker container [#1025]. We corrected a
RunHookInspectFile test failure on Mac [#1005].

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

* 306 [bug] slawek

     Fixed propagating database password to the session manager.
     (Gitlab #1018)

* 305 [bug] slawek

     Fixed a problem with improperly using the rndc command that prevented
     detecting BIND 9 daemons if the RNDC key was specified outside the
default
     RNDC key file. Fixed a rare bug when the Stork server crashes if an
error
     occurs on a particular stage of BIND 9 detection.
     (Gitlab #1031)

* 304 [bug] slawek

     Fixed a bug in handling the empty database host that caused user
login
     failures in the UI. Fixed rejecting the database usernames
containing a
     dash. Fixed printing of the error messages related to the database
     authentication problems.
     (Gitlab #1022)

* 303 [func] razvan

     The lease search page can now display the content of the lease user
     context.
     (Gitlab #999)

* 302 [bug] marcin

     Fixed a bug in the Stork server that resulted in temporarily holding
wrong
     DHCP options for an edited host reservation. This problem occurred
when
     different options were specified for different servers owning the
same
     host reservation. In addition, fixed a similar bug in specifying
different
     client classes for different servers.
     (Gitlab #1017)

* 301 [bug] slawek

     Stork resolves now the include statements in the Kea configuration
with any
     file extension.
     (Gitlab #1036)

* 300 [bug] slawek

     Fixed a bug in one of the config review checkers that caused a
server crash
     if the Kea configuration contained a subnet prefix with a zero mask.
     (Gitlab #1024)

* 299 [bug] marcin

     Fixed a bug in the Stork server that could sometimes cause a
modification
     of the timestamps of various records in the database during the
update.
     This bug is unlikely to have a real impact on the users.
     (Gitlab #1007)


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

We look forward to receiving your feedback.

-- 
Everett B. Fulton
ISC Support

More information about the Stork-users mailing list