[stork-users] Stork 0.17.0 is now available

[Michael McNally]

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.17.0, May 7th, 2021, Release Notes

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

* **Backend information**: In this release, Stork is now able to show
more information about leases, hosts, and config backends, such as the
file location for memfile or database name and the host address for
databases. If forensic logging is used and configured to use a database,
this information is provided as well [#299].

* **Declined leases information**: The lease search has been expanded to
cover declined leases, which are a sure sign of duplicate address
problems in a network, if they appear. To search for declined leases,
use `state:declined` as a filter [#510].

* **UI tweaks**: The number of machines waiting for authorization is now
shown on the `Unauthorized` button, making it easier to notice [#492].

* **Documentation updates**: It is possible to configure the Stork
server to run on a non-standard port. That capability is now better
documented [#480]. The crypto library being used is now clearly
documented [#511].

* **Work in progress**: The team also made substantial progress on three
new featureswhich are expected to be available in the next release. The
first feature is insight into the state of a host reservation: it will
show whether the reserved address is available, in use, or expired, or
if there is a conflict and someone else is currently using the address
[#530]. The second feature is a more robust BIND 9 and Kea detection
mechanism, which should cover cases like running in a non-standard
location, on non-standard ports, etc. [#474]. The third feature is a Kea
configuration browser. The current Stork version has views dedicated to
the most common configuration elements: subnets, reservations, networks,
etc. However, Kea has many more configuration options and thus a
dedicated view is needed to show the whole configuration [#531].

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

```
* 140 [func] godfryd

     Added displaying number of unauthorized machines on machines
     page in select button.
     (Gitlab #492)

* 139 [func] marcin

     New information presented in the Kea tab includes
     locations of a lease file, forensic logging file and the
     information about database backends used by the particular
     Kea instance.
     (Gitlab #299)

* 138 [func] marcin

     Implemented declined leases search.
     (Gitlab #510)

* 137 [func] godfryd

     Added system tests for new agent registration.
     (Gitlab #507)
```

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

We look forward to receiving your feedback.