[stork-users] Stork 1.14.0 released
Victoria Risk
vicky at isc.org
Wed Dec 6 13:50:45 UTC 2023
Stork 1.14.0 is available now.
This release extends the functionality for managing subnets and pools
(for users with the Subnet Commands hook installed with Kea).
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://www.isc.org/download#Stork
Documentation for Stork is available at:
https://stork.readthedocs.io <https://stork.readthedocs.io/>
------------
# Stork 1.14.0 Release Notes, December 6, 2023
Welcome to Stork 1.14.0, another development release. The changes
introduced in this version are:
1. **Pool management**: We have extended the subnet-editing UI form with
new components to manage address pools (v4 and v6) and prefix delegation
pools (v6-only). Both pool forms allow for specifying Kea-specific
parameters such as client class and required client classes. They also
allow for specifying pool-level DHCP options. Excluded prefixes can be
specified for the prefix delegation pools. Since subnets can be shared
between several Kea instances, the new pool management mechanism lets
the user select which Kea servers sharing a subnet should also use a
given pool. For example: two Kea servers using the same subnet may have
different sets of pools configured for this subnet, which may be useful
in cases when two servers are connected to the same lease database. An
administrator may wish to use non-overlapping address spaces between the
Kea servers to avoid address assignment collisions [#1208].
2. **Relay address in subnet**: The subnet form now provides a way to
specify relay agent addresses. The Kea server uses the addresses to
select the subnet for DHCP requests received from any of these addresses
[#1230].
3. **New UI features**: We added a button on the Kea applications page
to trigger forcibly re-fetching configurations from the Kea servers. The
need to use this button is rare but may be helpful in cases when the Kea
configuration information diverges between Stork and the Kea servers,
which may be a result of a software bug [#1206]. The settings page now
has the ability to specify custom apps state puller and metrics
collector intervals [#1210].
4. **Build improvements**: Compatibility of the Stork binaries with
Ubuntu 20.04 and Ubuntu 18.04 has been restored [#1201]. We resolved
Stork build issues on OpenBSD and 32-bit ARM architectures [#1231,
#1169].
5. **Security**: Several vulnerabilities in the UI and backend
dependencies were addressed [#1233]. TLS 1.0 and TLS 1.1 are now
disabled in communications between the server and agent. TLS 1.3 is now
used by default [#1197].
6. **Bug fixes**: We fixed issues with specifying the environment file
location with the `--use-env` CLI flag, and removed the unused
`--prometheus-bind9-exporter-interval` CLI flag [#1219]. The allowed
ranges for T1 percent and T2 percent parameters and initialization of
the valid lifetime parameter in the subnet form have been corrected
[#1195]. The Stork server now correctly parses the `output-options`
parameter alias in the Kea logging configuration. The introduction of
this alias confused the Kea configuration parser in Stork and resulted
in a log viewer malfunction [#1198].
7. **Documentation**: We added documentation for the hook framework
[#779]. Register command arguments in the stork-agent man file are now
documented [#1158]. We corrected links to the Kea hooks Administrator
Reference Manual (ARM) on the Kea application page [#915].
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.
* 357 [bug] piotrek
Corrected wrong anchors to Kea hooks ARM docs in
Kea application page.
For Kea version >= 2.4 new std-ischooklib-* anchors are
used.
(Gitlab #915)
* 356 [doc] slawek
Added the hook framework documentation.
(Gitlab #779)
* 355 [bug] slawek
Restored compatibility of the Stork binaries with Ubuntu 18.04 and
Ubuntu
20.04.
(Gitlab #1201)
* 354 [sec] marcin
Upgraded some UI and backend dependencies to remove critical
vulnerabilities for Stork 1.14.0.
(Gitlab #1233)
* 353 [bug] slawek
Fixed issues with specifying the environment file location with the
--use-env CLI flag. Removed unused
--prometheus-bind9-exporter-interval CLI
flag.
(Gitlab #1219)
* 352 [build] slawek
Enhanced the build system to recognize ARM64 architecture on the
OpenBSD
operating system.
(Gitlab #1231)
* 351 [sec] slawek
Disabled the TLS 1.0 and 1.1 protocols in the GRPC server of the
Stork
agent. The Stork server communicates with the Stork agent over TLS
1.3 by
default.
(Gitlab #1197)
* 350 [func] marcin
Extended subnet form for specifying relay addresses.
(Gitlab #1230)
* 349 [build] slawek
Updated the simulator Python dependencies.
(Gitlab #1166)
* 348 [func] marcin
Added a button to manually trigger updating Kea configurations in the
Stork database from the Kea servers.
(Gitlab #1206)
* 347 [func] marcin
Enabled subnet form with the pool management.
(Gitlab #1208)
* 346 [func] marcin
Extended the settings page with the ability to specify custom apps
state puller and metrics collector intervals.
(Gitlab #1210)
* 345 [doc] marcin
Documented register command arguments in the stork-agent man file.
(Gitlab #1158)
* 344 [bug] marcin
Corrected allowed ranges for T1 Percent and T2 Percent parameters in
the subnet edit form. Corrected initializing the Valid Lifetime
parameter value in the subnet form.
(Gitlab #1195)
* 343 [bug] marcin
The agent recognizes a new alias output-options introduced in Kea 2.5
logger configuration.
(Gitlab #1198)
* 342 [build] slawek
Changed the convention of preparing the ChangeLog file to avoid merge
request conflicts.
(Gitlab #1120)
* 341 [build] slawek
Fixed the cross-compilation problem for 32-bit ARM architectures
caused by
invalid architecture labels.
(Gitlab #1169)
Thank you again to everyone who assisted us in making this release
possible.
We look forward to receiving your feedback.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.isc.org/pipermail/stork-users/attachments/20231206/5b61665f/attachment.htm>
More information about the Stork-users
mailing list