Stork 0.12.0, October 14th, 2020, Release Notes

Welcome to the Stork 0.12.0 release. This is a development release of the Stork dashboard.

The changes introduced in this version are:

1. BIND 9 fix for multiple addresses. Previous Stork agents had problems parsing BIND 9 configurations that had more than one address specified in their allow lists. This is now fixed. #411 (closed)

2. Events viewer. Previous Stork agents were able to display the last 15 events in a small panel in the dashboard. This was useful, but very basic. The capability has been now significantly expanded: the event viewer widget on the dashboard now has a paging mechanism, so earlier/later pages can be viewed, and there's an entirely new full page events viewer. #357 (closed)

3. Breadcrumbs navigation. Some users have reported that navigating around the Stork UI can be confusing. The newly added breadcrumbs navigation should make it more obvious and the navigation should be more intuitive. #337

4. Verbose mode for DB migration. Stork does not publish any DB schema; it provides a stork-db-migrate tool that performs the migration. This is more flexible, as over time there will be cases when the schema and data migration require some processing and cannot be easily done in plain SQL. However, we received a report that on certain systems the schema migration failed and it was difficult to diagnose the problem. stork-server and stork-db-migrate now allow users to migrate up and down to specific schema versions and enable logging all queries. #366 (closed)

We now have a solution for two issues reported: the ability to handle large configurations with thousands of subnets (#398 (closed)) and no more confusion for Stork if the Kea IP address changed (#409 (closed)). Both have candidate solutions that are at various stages of review, and they are expected to be part of the 0.13 release, expected next month.

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

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

* 105 [func] godfryd

    Added a new page with events table that allows filtering and
    paging events. Improved event tables on dashboard, machines and
    applications pages. Enabling and disabling monitoring now
    generates events.
    (Gitlab #380)

* 104 [bug] matthijs

    Stork was unable to parse inet_spec if there were multiple addresses in
    the 'allow' clause.  Also fix the same bug for 'keys'.
    (Gitlab #411)

* 103 [func] godfryd

    Introduced breadcrumb that shows current location in Stork
    web application.
    (Gitlab #337)

* 102 [func] tomek

    The stork-db-migrate tool can now migrate up and down to specific
    schema versions. The SQL tracing now works and can be used to
    export SQL schema to external file.
    (Gitlab #366)

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

We look forward to receiving your feedback.