# Stork 0.9.0, July 1st, 2020, Release Notes

Welcome to the Stork 0.9.0 release. This is a development release of
the Stork project, which is a modern, responsive, and scalable
dashboard for Kea and BIND 9 with a well-defined REST API interface.
The long-term goal of the project is to provide a monitoring and
management solution for BIND 9 and Kea DHCP.

This release does not feature any major new features. Instead, the
team decided to spend some time fixing bugs and generally improving
the quality of the software.

The bug fixes and changes introduced in this version are:

1. **Dashboard tweaks**. Several small adjustments were made in the
Stork dashboard; the most notable one is that it now shows pool
utilization as a progress bar. #235

2. **Build improvements**. A workaround for building in Docker
running on Ubuntu 20.04 was added (#323), the database setup and
cleanup for building and running unit-tests were improved (#322), and
the binaries can now return their own compilation version: try
`stork-server --version` or `stork-agent -v` (#265).

3. **BIND 9 Prometheus improvements**. BIND 9 handling routines now
correctly unregister all collectors (#326), and do not log an error
on missing BIND 9 stats (#319).

4. **Security hardening**. Issues with the initial retrieval of user
groups has been fixed (#331), the traffic generators used in the demo
are functional again (#329), and the 403 (access forbidden) error now
has its own landing page (#327).

5. **Bugfixes**. A problem with showing a blank page after logging in
has been fixed (#330), pulling host reservations from a Kea server
should now work better (#305), and we have implemented our own
DefaultRegisterer (#261).

## Release Model

Stork has monthly development releases on the first Wednesday of each
month (with some exceptions around holidays), although we sometimes
delay it a bit for last-minute changes.

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
This version of 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 currently available only in the source form in the
docs/ directory, and the Sphinx tool is required to build it. This is
expected to change in a future release.

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

```
* 76 [func] marcin

    Pool utilization in the Stork dashboard is shown with a progress
    bar.
    (Gitlab #235)

* 75 [bug] matthijs

    BIND exporter did not unregister all Prometheus collectors on
    shutdown.
    (Gitlab #326)

* 74 [bug] marcin

    Fixed a security problem whereby an unlogged user had access to
    some restricted pages. If the unlogged user tries to access a
    restricted page, the user is redirected to the login page.
    If the user tries to access a page without proper privileges,
    the HTTP 403 page is displayed.
    (Gitlab #119)

* 73 [func] marcin

    Monitor communication issues between Stork and the applications.
    If there is a communication problem with any app it is highlighted
    via appropriate icon and a text that describes the problem. The
    server logs were adjusted to indicate if the communication issue
    is new or has been occurring for a longer period of time.
    (Gitlab #305)

* 72 [func] tomek

    Implemented version reporting in agent and server.
    (Gitlab #265)
```

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

We look forward to receiving your feedback.