[Stork-dev] Stork 0.18.0 is now available

Michael McNally mcnally at isc.org
Wed Jun 2 19:33:16 UTC 2021


Stork 0.18.0 is a new development release of the Stork monitoring and
configuration dashboard and it can be downloaded from:

  https://www.isc.org/download#Stork

Documentation for Stork is available at https://stork.readthedocs.io.

-----

# Stork 0.18.0, June 2nd, 2021, Release Notes

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

* **Kea Config Viewer**: Stork has been able to show the most important
aspects of Kea configuration: shared networks, subnets, host
reservations, and leases. However, earlier versions lacked the ability
to present any other parameters. This release introduces the ability to
retrieve and display the full Kea configuration as a collapsible tree,
which lets users inspect all the configuration elements of the currently
running configuration [#531].

* **Leases in HR**: Host Reservation is a part of Kea configuration that
reserves certain resources for specific devices. This release of Stork
allows users to check the state of all host reservations - whether a
given device is actually using one, if there's a lease currently active
or expired, or if there's a conflict (i.e., the reserved address is used
by another device that is not supposed to use it) [#530].

* **Better process detection**: The process detection subsystem of the
Stork agent has been refactored. It is now much more robust in detecting
BIND 9 and Kea instances that are located in non-standard paths. The
most immediate benefit of this change is that Stork is now able to
detect BIND 9 when installed from packages provided by ISC. This change
was tested with BIND 9.11, 9.16, and 9.17 on CentOS 7 and Ubuntu 18.04
[#474].

* **Export TLS certificates**: The `stork-db-migrate` tool has been
renamed to `stork-tool`. In addition to its existing abilities, it can
now export TLS certificates, keys, and tokens from the database [#515].

* **Grafana templates in RPM packages**: The RPM packages now include
Grafana templates, which make them easier to deploy [#544].

* **Bugfixes**: The previously broken `listen-only` flag on the Stork
agent should now work properly [#536].

* **Testing**: Several testing-related areas have been improved. Kea
statistics are now tested [#439]; the qcow2 image generation is now
automated, which makes changes deployment in the CI environment much
easier [#545]; and several new tests have been added to detect various
BIND 9 versions [#474].

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

## Incompatible Changes

* **stork-db-migrate replaced by stork-tool**: The earlier tool
(`stork-db-migrate`) has been replaced with `stork-tool`, which provides
the same abilities with regards to database migration, but also has an
additional new feature of exporting TLS certificates. If you use this
tool in your automated deployment, make sure you update the tool name as
well as the environment variable names. See the manual page for
`stork-tool` for details.

## 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.
It is available on ReadTheDocs.io at
https://stork.readthedocs.io/en/latest/, and in source form in the docs/
directory.

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

Professional support for Stork will become available once it reaches the
1.0 milestone. Existing ISC customers that consider themselves *very*
early adopters may get involved in the development process, including
roadmap, features planning, and early testing, but the software maturity
level does not constitute a typical professional service before the 1.0
milestone.

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
0.17.0 release.

```
* 148 [func] godfryd

     Added including Grafana dashboard JSON files to RPM
     and deb packages.
     (Gitlab #544)

* 147 [func] godfryd

     Added system tests for collecting statistics from
     various versions of Kea app.
     (Gitlab #439)

* 146 [func] marcin

     Added new tab displaying a selected host reservation's details.
     The tab includes the information about the allocated leases
     for the reservation, e.g. if the reservation is in use by the
     client owning the reservation or there is a conflict (the lease
     is allocated to a different client). It also indicates whether
     the matching lease is declined, expired or there are no matching
     leases.
     (Gitlab #530)

* 145 [func] godfryd

     Refactored stork-db-migrate tool to stork-tool and added
     commands for certificates management.
     (Gitlab #515)

* 144 [func] slawek

     Added Kea daemon configuration preview in JSON format.
     (Gitlab #531)

* 143 [bug] ymartin-ovh

     Fixed honoring the listen-only flags in Stork Agent.
     (Gitlab #536)

* 142 [func] marcin

     Updated Stork demo to expose new features: leases search,
     Kea database backends and files locations.
     (Gitlab #542)

* 141 [func] godfryd

     Fixed and improved detecting various versions of BIND 9.
     (Gitlab #474)
```

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

We look forward to receiving your feedback.


More information about the stork-dev mailing list