# Stork 1.13.0 Release Notes, October 11, 2023

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

1. **Subnet management**: We have reached an important milestone in the 
long-term goal of managing Kea configuration in Stork: it is now 
possible to edit many properties of subnets configured in Kea servers. 
If a subnet is configured in several Kea servers, the configuration can 
be applied to all of them. It is also possible to specify different 
values for selected subnet parameters for each server. However, the 
ability to manage pools is not yet supported. The subnet management 
feature was tested, but due to its complexity should be used with 
caution. Feedback is appreciated [#958]. REST API calls to update an 
existing subnet were implemented [#957]. We fixed a problem with subnet, 
network, host, and possibly other tabs not being shown [#1176].

2. **LDAP hook**: One of the technical features that has made Kea a 
successful project - the ability to load external libraries - is coming 
to Stork. Stork now has the ability to load extensions. The hooks 
concept makes it much easier to implement complex, optional features, 
make them available to users who need them, and avoid complicating 
deployments for users who don't. The first hook to take advantage of 
this capability is a Lightweight Directory Access Protocol (LDAP) hook. 
If loaded, it allows the server to use LDAP to authenticate Stork users 
[#638]. A build pipeline for the LDAP hook was created [#1178]. The hook 
README was updated [#1183]. The logic was updated to not use the 
directory name in the hook filenames [#1184]. An experiment with 
`-trimpath` compiler flag was completed [#1182, #1188]. Support for a 
common hook prefix was implemented [#1180].

3. **ARM support**: Starting with this release, Stork is now officially 
supported on the ARM architecture. This includes the ability to build 
from sources as well as native deb and RPM packages [#472, #893, #1113].

4. **BIND improvements**: Stork agent is now better able to handle BIND 
deployments that use the chroot mechanism [#974].

5. **Security**: We have ended the use of self-signed certs by the Stork 
agent during registration to prevent cert validation errors by the Stork 
server, which expects trusted certs [#1154]. The govulncheck task now 
uses version guard in the Rakefile [#1116]. We updated several 
dependencies, as reported by dependabot [#1142].

6. **Build improvements**: the NPM version has been updated [#809]. A 
Docker base image for CI tasks has been prepared [#846]. We removed 
golang mock as it is no longer supported [#1117]. Better support for 
recent PostgreSQL releases has been added [#897, #1148]. The Ubuntu 
version used in the Stork demo has been updated [#689]. The API mock 
files are now generated with proper names [#1136]. The Kea version was 
updated in the demo, and the system tests version parsing was improved 
[#995].

7. **Bug fixes**: A misleading message in the review panel was 
corrected. The number of issues found is now clearly shown [#1131]. We 
fixed misaligned icons after a PrimeNG upgrade [#1014]. The traffic 
simulator, a part of the Stork demo, is working again [#1128]. Shared 
network statistic counter summaries have been corrected [#1135]. We 
fixed an issue whereby typing the appId or subnetId in the subnets 
filtering field resulted in wiping this field [#1140]. The shared 
networks are now clickable in the dashboard [#1133]. The agent-kea6 in 
the demo was fixed [#1156].

8. **Documentation**: The README and AUTHORS files were updated 
[#1125,#1126]. The incompatible changes are now marked with exclamation 
points in the changelog [#1143]. We have clarified the documentation to 
explain that the setup script is not available for Alpine [#1137].

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

## Incompatible Changes

There are no incompatible changes in this release.

## Release Model

Stork has bi-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 
previous Stork release, version 1.12.0.

* 340 [build] slawek

    Added Rake and CI tasks to build, test, package, and upload the Stork
    hooks.
    (Gitlab #1178)

* 339 [build] marcin

    Downgraded PrimeNG to avoid the bug with dynamic tab menu. See 
PrimeNG
    issue #13609.
    (Gitlab #1176)

* 338 [func] slawek

    Support for a new hook naming convention. The server-specific hooks 
should
    use the "stork-server-" prefix (e.g., stork-server-ldap.so).
    (Gitlab #1180)

* 337 [bug] slawek

    The agent no longer includes the TLS credentials in the requests 
sent to
    the server. Including them caused TLS verification errors during 
agent
    re-registration.
    (Gitlab #1154)

* 336 [bug] slawek

    Fix displaying statistics of the IPv4 shared networks.
    (Gitlab #1135)

* 335 [func] marcin

    Implemented a form for updating selected subnet parameters.
    (Gitlab #957, #958)

* 334 [bug] slawek

    Fixed the minor filtration issues on hosts, subnets and shared 
networks
    pages.
    (Gitlab #1140)

* 333 [func] slawek

    Added support for BIND 9 running in the chroot mode.
    (Gitlab #974)

* 332 [func] slawek

    Added support for Postgres 15+. System tests now run on Postgres 16.
    Updated the docs to recommend granting all privileges on the public 
schema
    for the Stork user to avoid problems with some Postgres 15 (and 
above)
    installations.
    (Gitlab #1148)

* 331 [build] slawek

    Fixed the security vulnerabilities reported by the Github Dependabot 
and
    updated dependencies including the Go 1.21, Angular 16, PrimeNG, 
GoSwagger,
    OpenAPI Generator and several Python and Ruby packages.
    (Gitlab #1142)

* 330 [bug] slawek

    Fixed the problem of missing issues count in the configuration 
review panel
    header when the number of issues was zero. It resulted in a confusing
    message suggesting that some issues were found.
    (Gitlab #1131, #1141)

* 329 [build] slawek

    Updated the dependency versions used in the CI.
    (Gitlab #689)

* 328 [bug] razvan

    Fix alignment of some UI components (spinner, help tip component).
    (Gitlab #1014)

* 327 [func] slawek

    Links to IPv6 shared networks on the dashboard.
    (Gitlab #1133)

* 326 [build] slawek

    Added support for building Stork components on the ARM architecture. 
Added
    support for an experimental cross-compilation for arbitrary 
platforms.
    (Gitlab #381, #472, #893, #1113)

* 325 [doc] slawek

    Removed the documentation section referring to the non-existing 
Alpine
    script on CloudSmith.
    (Gitlab #1137)

* 324 [func] slawek

    Added support for configuring the Stork server hooks.
    (Gitlab #638)

* 323 [build] razvan

    Updated Kea version to 2.4.0 in demo and system tests.
    (Gitlab #995)


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

We look forward to receiving your feedback.