[stork-users] Stork 1.12.0 is now available
Everett B. Fulton
ebf at isc.org
Wed Aug 2 15:17:42 UTC 2023
Stork 1.12.0 is a new development release of the Stork dashboard for
monitoring Kea servers.
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
-----
# Stork 1.12.0 Release Notes, August 2, 2023
Welcome to Stork 1.12.0, another development release. The changes
introduced in this version are:
**Subnets and shared networks views**: Subnet details can now be
inspected via a subnet view [#931]. In particular, it provides insight
into the global/network/subnet parameters inheritance [#953]. Another
view was added that allows inspection of shared networks and their
parameters [#1119].
**BIND 9 support**: The Stork Agent now detects BIND 9 instances
properly, even if the `-c` flag is not used [#1057]. Gzip compression
for communication between the Stork server and agent enables retrieval
of large batches of BIND 9 statistics. Stork now accepts payloads up to
40MiB uncompressed size. This may also help with large Kea deployments
[#1059].
**User experience**: The Stork agent no longer prints a long list of
errors about missing certificates [#973]. The log messages produced by
the Stork agent during startup have been refactored to be more
straightforward and user-friendly [#1056]. Long IPv6 subnets are no
longer truncated in the UI [#1060]. Several small UI problems were fixed
[#1053].
**Kea configuration checks**: A new check was added: Stork now prints a
warning if Kea is missing the configuration for a control socket. Kea
can run without a control socket, but it will not be able to receive any
commands [#1045].
**Host reservations**: Hosts can now be filtered by subnet ID. This
allows searching for hosts related to a particular subnet [#1058].
**Bug fixes**: A bug was fixed in the script to install the Stork agent
using a server token, which caused installation errors due to incorrect
paths to the deployed packages. The script no longer requires all Stork
agent package formats to be deployed on the Stork server, and it uses
the available formats for the matching operating systems where the Stork
agent is installed [#932]. Displaying of empty HA failure time was fixed
[#1123].
**Testing and QA**: Python test-code quality was improved; it now
achieves the maximum 10.0 score on pylint [#1044]. A problem was fixed
related to a test failing when running with a DB running in Docker
[#1052]. CI pipelines were updated [#1115, #1118].
**Documentation**: An example for configuring an Apache web server to
access Stork in a subdirectory was added [#1039]. The Developer's Guide
is now a stand-alone document [#786].
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.11.0.
* 322 [func] slawek
Added a configuration option to handle requests directed to URL
subdirectory (instead of URL root). Included an example Apache
configuration
file.
(Gitlab #1039)
* 321 [build] slawek
Refactored and formatted to the Python codebase to reach the highest
quality rate from the linter.
(Gitlab #1044)
* 320 [bug] slawek
Fixed a bug in the script installing the Stork agent using a server
token.
This bug caused installation errors due to wrong paths to the
deployed
packages. The script no longer requires all Stork agent package
formats to
be deployed in the Stork server, and it will use the available
formats for
the matching operating systems where the Stork agent is installed.
(Gitlab #932)
* 319 [func] marcin
Created shared network view in the WebUI that contains shared network
details, including DHCP parameters and options.
(Gitlab #1119)
* 318 [func] slawek
Added a new checker to verify if the Kea Control Agent configuration
includes the control sockets. Added a descriptive message about
possibly
missing control socket configuration of the Kea DHCP daemons.
(Gitlab #1045)
* 317 [bug] slawek
Fixed bug with detecting RNDC key if the -c flag is not used to set
the
config path in BIND 9.
(Gitlab #1057)
* 316 [func] slawek
Refactored the log messages produced on the Stork agent
initialization to be
more straightforward and user-friendly.
(Gitlab #1056)
* 315 [bug] slawek
Enabled gzip compression for all communication between the Stork
server and
agent. It fixes handling a big response of named statistics endpoint.
Stork accepts payloads (i.e., responses from Kea and BIND 9
endpoints) up
to 40MiB uncompressed size.
(Gitlab #1059)
* 314 [bug] slawek
Fixed a UI problem that caused the IPv6 subnet bars to be unreadable
for
long addresses.
(Gitlab #1060)
* 313 [bug] slawek
Fixed a rare crash occurring when the state puller schedules the
config
review for an existing daemon. Set the focus on the login page to
the first
input. Shrank the width of the lease user context viewer to its
content.
Fixed a problem with the DHCP identifier button's width.
(Gitlab #1053)
* 312 [build] slawek
Refactored mock file suffixes. The mocks no longer need to be
manually
registered in the Rake file.
(Gitlab #1006)
* 311 [func] marcin
Subnet view contains DHCP parameters and options.
(Gitlab #953)
* 310 [func] marcin
Filter host reservations by subnet ID.
(Gitlab #1058)
* 309 [func] marcin
A tab with the subnet details is opened after clicking on the subnet.
(Gitlab #931)
* 308 [doc] tomek
The Stork Developer's Guide is now a stand-alone document. You can
build it using rake `build:devguide` command.
(Gitlab #786)
* 307 [bug] marcin
Fixed the simulator in Stork demo.
(Gitlab #1054)
Thank you again to everyone who assisted us in making this release
possible.
We look forward to receiving your feedback.
--
Everett B. Fulton
ISC Support
More information about the Stork-users
mailing list