[stork-users] Stork 1.6.0 is now available

Everett B. Fulton ebf at isc.org
Wed Sep 7 17:20:22 UTC 2022


Stork 1.6.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.6.0, September 7th, 2022, Release Notes

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

1. **Host Reservation improvements**: Stork is now able to edit existing
Host Reservations (HR) in Kea [#838]. Reserved DHCP options are now
shown when viewing existing HR [#827].

2. **BIND 9 improvements**: Better integration with BIND 9.18 has been
added: the Prometheus exporter now uses an empty body HTTP request. This
addresses an interoperability problem in which BIND 9.18 periodically
rejected statistic-gathering requests [#798]. Stork-agent no longer
reports an error if BIND's current directory cannot be read [#799].

3. **New checker: overlapping subnets**: The Stork server has a new way
to sanitize Kea configuration. The new check verifies whether defined
subnets and pools overlap [#755, #763].

4. **Configuration checkers can be disabled**: Stork can check Kea
configurations for various problems and misconfigurations, but in some
deployments there are good reasons for unusual configurations. In such
cases, Stork's repeated suggestions to alter Kea's configuration may be
annoying. It is now possible to disable certain checkers, globally or on
a per-daemon basis [#610].

5. **Build and packaging**: Stork now builds properly on FreeBSD and
OpenBSD [#193]. Native packages for Alpine 3.15 are now available [#745,
#736]. A bug was fixed that prevented isc-stork-agent from being
uninstalled due to an empty path in a pre-remove script [#851]. Stork
once again builds on MacOS [#848]. The server's default paths for
locating HTML content are now more reasonable, which makes the server
easier to use, even with fewer environment variables [#825]. An outdated
dependency, PrimeFlex, has been migrated from 2.0 to 3.0 [#731].

6. **Testing**: Some scenarios being tested on the internal build farm
were migrated from CentOS to the RedHat Universal Base image [#752].
System tests related to testing packages have now been updated [#746].
Demo deployment now works properly [#810]. A missing Kea dependency
problem has been fixed, which caused system tests to fail [#822].

7. **Security**: Several npm dependencies have been updated to more
secure versions [#849].

8. **Bug fixes**: A manually provided DHCP option in host reservations
no longer causes a backend error [#812]. An unstable
TestRpsWorkerPullRps test was fixed [#828]. The `stork-demo.sh` script
now works properly on MacOS [#824]. Stork now properly detects HR
changes in Kea. Previously, any changes done externally were ignored,
unless they changed the IP or DHCP identifier [#814].

Please see this link for known issues:
https://gitlab.isc.org/isc-projects/stork/-/wikis/Known-issues.

## Incompatible Changes

None

## Release Model

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.

## 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 Stork
1.5.0 release.

* 239 [build] slawek

     Upgraded Angular to version 14.2.0.
     (Gitlab #849)

* 238 [bug] slawek

     Prometheus exporter for BIND 9 sends the HTTP requests with an empty
body.
     BIND 9.18 periodically rejects requests that include a body, causing
errors
     in gathering the statistics.
     (Gitlab #798)

* 237 [func] slawek

     Added the possibility to enable or disable the configuration review
     checkers globally or only for selected daemons.
     (Gitlab #610)

* 236 [build] slawek

     Refactored the FreeBSD and OpenBSD support for building agent
packages.
     (Gitlab #193)

* 235 [func] marcin

     Enable updating host reservations in Stork.
     (Gitlab #838)

* 234 [build] slawek

     Added scripts for building native APK packages with Stork Server and
     Stork Agent. They are prepared for Alpine 3.15.
     (#736)

* 233 [func] slawek

     Added two Kea configuration checkers. The first one finds the
overlapping
     subnets based on the subnet prefixes. The second checker validates
the
     subnet prefixes.
     (Gitlab #763)

* 232 [func] marcin

     Display DHCP options in the host reservation view.
     (Gitlab #827)

* 231 [func] slawek

     Added a system test validating Stork upgrade to the most recent
version
     using Cloudsmith repository.
     (Gitalb #746)

* 230 [bug] slawek

     Fixed a problem with running the demo by shell script on macOS.
     (Gitlab #824)

* 229 [bug] slawek

     Corrected a bug in the host puller, causing the Stork Server not to
notice
     an update in the reserved hostnames in Kea configuration when
neither an
     IP address nor DHCP identifier has been changed.
     (Gitlab #814)

* 228 [build] marcin

     Migrated to PrimeFlex 3.0.1.
     (Gitlab #731)


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