# Stork 1.2.0, March 2nd, 2022, Release Notes

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

**A design for Kea Configuration Management**. One of two major areas 
being worked on is the ability of Stork to change Kea's configuration. 
As the first step towards that goal,  the team wrote the requirements 
(https://gitlab.isc.org/isc-projects/stork/-/wikis/designs/config-require
ments) and a preliminary design 
(https://gitlab.isc.org/isc-projects/stork/-/wikis/designs/config-design)
 document. While there is no code written yet, some of the use cases and 
design assumptions will affect many users; users are requested to 
provide feedback by sending comments to the stork-users mailing list 
(https://lists.isc.org/mailman/listinfo/stork-users) or as comments on 
GitLab [#599].

**Testing improvements**. Test improvements are the other significant 
activity for the team: we are working on creating the framework to run 
and efficiently develop new system tests. While the tests themselves are 
probably not directly useful for end users, they're a tremendous help 
for the developers to test new functionalities and, even more 
importantly, give us a way to easily and frequently verify that existing 
functionalities are not affected by new changes [#709]. The PrimeNG 
errors during UI unit tests have been fixed [#654].

**Improved performance of per-subnet statistics**. Earlier Stork Agent 
code had a bug that periodically processed per-subnet statistics, even 
when they were disabled. This problem has been fixed [#614].

**Crash fixed for large configurations**. A problem has been detected 
for large Kea configurations. Internal tests indicated that a 29MB Kea 
config file caused Stork to crash. The underlying problem is now fixed. 
[#682].

**Stork tool database creation fix**. The `stork-tool db-create` command 
now initializes the database with `pgcrypto` extensions enabled [#701].

**Updated dependencies**. We updated Angular to version 13.2.2 and 
PrimeNG to version 13.1.0 [#690].

**Demo: traffic simulator fix**. Stork features a demo that comes with 
many Kea containers and a DHCP/DNS traffic generator. A problem has been 
fixed in the generator that prevented it from operating [#705].

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

* 201 [bug] slawek

    Prevent issues with parsing and storing large Kea
    configurations in the Stork database
    (Gitlab #682)

* 200 [bug] marcin

    stork-tool db-create command creates the pgcrypto extension.
    (Gitlab #701)

* 199 [build] marcin

    Updated Angular to version 13.2.2 and PrimeNG to version 13.1.0.
    (Gitlab #690)


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

We look forward to receiving your feedback.