[Stork-dev] Stork 0.16.0 is now available

Michael McNally mcnally at isc.org
Wed Apr 7 17:59:33 UTC 2021


Stork 0.16.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.16.0, April 7th, 2021, Release Notes

Welcome to the Stork 0.16.0 release, which has returned to a monthly
release cycle. The changes introduced in this version are:

* **Lease information**: In this release, the major effort was focused
on handling lease information: Stork is now able to do a lease
inspection. Leases can be searched by IP address, by MAC address, by
DUID (v6 only), or by client-id. The lookup shows results from all
servers, if available. This is particularly useful for inspecting leases
on a HA pair, which should match between partners in normal operation.
#509 Also, Stork can now show information about Kea backends; this
generic feature generic also displays the leases, host, and config
backend storage locations. #299

* **Design for incremental lease retrieval**: As of this release, Stork
is able to look up single leases, using `leaseX-get` API calls that have
been available since Kea 1.3.0. This API works well for single leases
but does not scale for massive updates for all leases, especially for
larger deployments. For this purpose, we came up with a design that
allows Stork to retrieve lease updates from Kea in a continuous manner.
The design is available here:
https://gitlab.isc.org/isc-projects/stork/-/wikis/Leases-Tracking. We'd
appreciate comments and feedback. This design has been completed in Kea
ticket #1230.

* **DHCPv6 dashboard for Grafana**: Stork has supported DHCPv6 from its
very early days, including exporting statistics to Prometheus. However,
until now, there was no DHCPv6 dashboard for Grafana that could take
advantage of that. We tried to make it look as similar to the DHCPv4
dashboard as possible, but there are some differences. There is no
concept of `ACK/NAK` packets in the DHCPv6 protocol; instead, the status
is conveyed with the `status-code` option. Another notable difference is
that it's infeasible to show pool utilization as a percentage.
Regardless of the number of devices in your IPv6 network, even the
smallest /64 networks have quintillions of addresses available. We're
eager to get your feedback and suggestions on how to expand this and
other Stork dashboards. #176, #469

* **TLS improvements**: We followed up on the TLS work done in the
previous release and improved several aspects related to testing. #487
The agent now checks the host information as specified by the user to
determine where to listen for incoming server connections. #504

* **Bugfixes and smaller improvements**: With the major task of adding
TLS mostly complete, we got back to fixing smaller bugs and made more
"quality-of-life" improvements. The demo is now more resilient with some
fixes in the connectivity between the Stork server and `agent-kea` #517;
the internal IDs used by our front-end code now follow a naming
convention that is very helpful for our QA dept, especially for
developing better automated tests #455; and we fixed the broken
Prometheus exporter on one of the demo containers. #494

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

## 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.15.0 release.

```
* 136 [func] marcin

     Implemented Leases Search.
     (Gitlab #509)

* 135 [func] godfryd

     Added Grafana dashboard for DHCPv6. Enabled generating
     DHCPv6 traffic in Stork Simulator. Adjusted Stork demo
     to handle DHCPv6 traffic.
     (Gitlab #176)

* 134 [bug] godfryd

     Fixed getting host address for listening in agent.
     (Gitlab #504)
```

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