# Stork 1.4.0, June 1st, 2022, Release Notes

Welcome to Stork 1.4.0, another development release. Due to a shorter 
release cycle than usual, the set of changes is modest this time. The 
changes introduced in this version are:

**Stork agent daemon detection**: The agent will now print a warning if 
Kea/BIND9 process detection ends without detecting any running daemons 
[#713].

**Log colors**: The logging colorization can now be controlled with the 
`CLICOLOR` and `CLICOLOR_FORCE` environment variables [#722].

**Bug fix: download troubleshooting info**: A bug that previously caused 
the troubleshooting information to often not include any event details 
has been fixed [#707, #743]. 

**Bug fix: servers without stat_cmds**: The Stork server no longer sends 
statistics queries to the Kea servers without using the stat_cmds hook 
library. Sending such queries caused unnecessary command processing by 
the Kea servers and excessive error logs in Stork [#742].

**Documentation**: The Stork gallery on wiki and README file have been 
updated [#643].

**UI tweaks**: The shared network and subnet pool utilization bars are 
now spaced properly to make them more readable [#741].

**Testing**: The `rake unittest:backend_db` command now properly uses 
the PostgreSQL container for testing [#733].

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

* 212 [bug] slawek

    Corrected a bug, which resulted in returning a null value instead of 
    a list of events in a machine dump tarball.
    (Gitlab #743)

* 211 [bug] slawek

    The Stork server no longer sends statistics queries to the Kea
    servers not using the stat_cmds hooks library. Sending such
    queries caused unnecessary commands processing by the Kea
    servers and excessive error logs in Stork.
    (#742)

* 210 [bug] slawek

    Fixed the rake tasks that ran the database in a Docker container but 
    were connecting to the database on localhost.
    (#733)

* 209 [func] slawek

    Log a warning message when no monitored application is detected.
    (Gitalab #713)

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

We look forward to receiving your feedback.