Skip to content

Changes

Page history
Update Known issues authored by Slawek Figiel's avatar Slawek Figiel
Hide whitespace changes
Inline Side-by-side
Known-issues.md
View page @ ff0d13e5
# Known Issues in Stork
The following is the list of known issues in current and previous versions of Stork. You can also see all Stork issues under [this link](https://gitlab.isc.org/isc-projects/stork/issues?label_name[]=bug).
## Stork 1.16.0
If neither `--server-url` flag nor the `STORK_AGENT_SERVER_URL` environment variable is specified, the agent certificates and tokens are not validated. In this case, the Stork agent may run without some required certificates or with invalid ones. It may produce cryptic errors on every connection attempt [#1352].
## Stork 1.15.0
- A problem running demo and system tests were observed when running on Docker 25.x. The early investigation suggests it is a Docker issue. The matter is being investigated. One possible workaround is to downgrade Docker to version 23.x, which was proven to work [#1192].
## Stork 1.11.0
- The BIND9 detection may not work correctly, if BIND9's configuration is specified with the `-c` parameter. This bug (#1057) was discovered too late before 1.11.0 release. It will be fixed in the upcoming 1.12.0 release.
## Stork 1.10.0
- Stork server may crash if the connected stork agent detects Kea has some invalid subnet configuration. The issue is fixed in #1024 and will be released in 1.11. There is a viable workaround: Select `Configuration` > `Config checkers` from the top navbar and switch the `overlapping_subnet` config review checker to the "Disabled" state. For details, patch and discussion see #1024.
## Stork 1.5.0
- Stork Agent fails on every second request to the BIND9 statistics endpoint for BIND9 versions greater or equal to 9.18. It produces a lot of error messages in the logs. Previous Stork Agent releases are affected too.
## Stork 1.0.0
- The Stork Agent doesn't interpret the comments in the Kea Control Agent configuration file.
It concerns the `http-host`, `http-port`, `trust-anchor`, `cert-file`, `key-file`, `cert-required` columns. The Agent will read the first occurring value even if it is commented out.
## Stork 0.22.0
* The Stork documentation project hosted at https://stork.readthedocs.io/ started having build failures
in October. This was not a single occurrence and happened with multiple projects which is documented
[here](https://blog.readthedocs.com/build-errors-docutils-0-18/). It caught the release of v0.22.0 off
guard. This was fixed with #608 in master, but to keep the `v0.22.0` reflecting the released
sources, instead of moving it, `v0.22.0-fix` was added. This is what the version that appears in
the Read the Docs sidebar and it should be interpreted as having `v0.22.0` documentation.
In reality, it only has the documentation build fix on top.
## Stork 0.18.0
- Some of the dependencies have security deficiencies reported. The versions used by Stork have not been updated to their latest, patched versions. This will be addressed in the upcoming 0.19.0 release. Notable problems discovered during audit are: [xmlhttprequest-ssl](https://www.npmjs.com/advisories/1665), [y18n](https://npmjs.com/advisories/1654), [url-parse](https://www.npmjs.com/advisories/1678), [ua-parser-js](https://www.npmjs.com/advisories/1679), [lodash](https://www.npmjs.com/advisories/1679), [dns-packet](https://npmjs.com/advisories/1745).
## Stork 0.15.0
- The Stork Agent's ``--host`` command line option doesn't work. This command line option should configure the agent to use a specific IP address to receive the connections from the ``Stork Server`` over gRPC. The agent always uses the default 0.0.0.0 address regardless of the ``--host`` setting. See #504 for details.
## Stork 0.14.0
- Events panel presented for a machine is not refreshed when switching between machine tabs. As a result, this panel may show events referring to a different machine than currently selected. Clicking on the `Machines` tab (the tab listing all machines) and returning to the selected machine's tab is a known workaround to ensure that the correct list of events is displayed for the machine. See #463 for details.
## Stork 0.13.0
- When starting to monitor a machine running Kea with many subnets configured, some errors may be observed in the Stork server logs indicating database unique constraint violations. This is caused by bottlenecks in the process of machine state fetching which may sometimes lead to concurrent updates of the same information in the database. Nevertheless, this should not cause any data integrity issues in Stork database.
## Stork 0.10.0
- If upgrading from previous releases, see known issues for 0.8.0 below.
- When deploying stork agent, make sure that only legitimate stork server is able to connect. A better access control is expected in future Stork versions, but for the time being please use firewall to restrict who can connect to the agent.
## Stork 0.9.0
- If upgrading from previous releases, see known issues for 0.8.0 below.
## Stork 0.8.0
- There are appearing problems with starting Stork demo using `rake docker_up` command on Ubuntu 20.04. This is due to a kernel bug and a workaround in Go runtime. GitLab https://gitlab.isc.org/isc-projects/stork/-/issues/306
- When upgrading Stork Server or Stork Agent from 0.8.0 or 0.9.0 using RPM packages, the upgrade procedure will fail complaining about stork-agent or stork-server account. The workaround for this is to not do upgrade, but remove the old package first and then install new one. This problem is fixed in 0.10.0, so future upgrades to 0.11 and beyond will work. However, the underlying problem is in 0.9.0 and earlier install scripts. If you upgrade from 0.8.0 and encounter problems with missing stork-agent or stork-server accounts, the issue may be fixed using `yum reinstall isc-stork-server` or `yum reinstall isc-stork-agent` on a version 0.10 or later.
## Stork 0.6.0
- It's not possible to install both Agent and Server deb packages on the same machine. The server package contains too many files that conflict with the agent package. This issue will be resolved with updated packages in the near future.
# Known Issues in Stork
The following is the list of known issues in current and previous versions of Stork. You can also see all Stork issues under [this link](https://gitlab.isc.org/isc-projects/stork/issues?label_name[]=bug).
## Stork 1.19.0
Performing any operation that alters the Kea configuration (i.e., editing subnets, shared networks, host reservations, or global parameters) breaks the Kea instance if Kea has a database configured (e.g., lease database, hosts database, or config backend database) and the [`retry-on-startup`](https://kea.readthedocs.io/en/latest/arm/database-connectivity.html#database-connectivity) parameter is set in this database settings. The problem affects all Kea versions from 2.5.5 to 2.7.4.
## Stork 1.16.0
If neither `--server-url` flag nor the `STORK_AGENT_SERVER_URL` environment variable is specified, the agent certificates and tokens are not validated. In this case, the Stork agent may run without some required certificates or with invalid ones. It may produce cryptic errors on every connection attempt [#1352].
## Stork 1.15.0
- A problem running demo and system tests were observed when running on Docker 25.x. The early investigation suggests it is a Docker issue. The matter is being investigated. One possible workaround is to downgrade Docker to version 23.x, which was proven to work [#1192].
## Stork 1.11.0
- The BIND9 detection may not work correctly, if BIND9's configuration is specified with the `-c` parameter. This bug (#1057) was discovered too late before 1.11.0 release. It will be fixed in the upcoming 1.12.0 release.
## Stork 1.10.0
- Stork server may crash if the connected stork agent detects Kea has some invalid subnet configuration. The issue is fixed in #1024 and will be released in 1.11. There is a viable workaround: Select `Configuration` > `Config checkers` from the top navbar and switch the `overlapping_subnet` config review checker to the "Disabled" state. For details, patch and discussion see #1024.
## Stork 1.5.0
- Stork Agent fails on every second request to the BIND9 statistics endpoint for BIND9 versions greater or equal to 9.18. It produces a lot of error messages in the logs. Previous Stork Agent releases are affected too.
## Stork 1.0.0
- The Stork Agent doesn't interpret the comments in the Kea Control Agent configuration file.
It concerns the `http-host`, `http-port`, `trust-anchor`, `cert-file`, `key-file`, `cert-required` columns. The Agent will read the first occurring value even if it is commented out.
## Stork 0.22.0
* The Stork documentation project hosted at https://stork.readthedocs.io/ started having build failures
in October. This was not a single occurrence and happened with multiple projects which is documented
[here](https://blog.readthedocs.com/build-errors-docutils-0-18/). It caught the release of v0.22.0 off
guard. This was fixed with #608 in master, but to keep the `v0.22.0` reflecting the released
sources, instead of moving it, `v0.22.0-fix` was added. This is what the version that appears in
the Read the Docs sidebar and it should be interpreted as having `v0.22.0` documentation.
In reality, it only has the documentation build fix on top.
## Stork 0.18.0
- Some of the dependencies have security deficiencies reported. The versions used by Stork have not been updated to their latest, patched versions. This will be addressed in the upcoming 0.19.0 release. Notable problems discovered during audit are: [xmlhttprequest-ssl](https://www.npmjs.com/advisories/1665), [y18n](https://npmjs.com/advisories/1654), [url-parse](https://www.npmjs.com/advisories/1678), [ua-parser-js](https://www.npmjs.com/advisories/1679), [lodash](https://www.npmjs.com/advisories/1679), [dns-packet](https://npmjs.com/advisories/1745).
## Stork 0.15.0
- The Stork Agent's ``--host`` command line option doesn't work. This command line option should configure the agent to use a specific IP address to receive the connections from the ``Stork Server`` over gRPC. The agent always uses the default 0.0.0.0 address regardless of the ``--host`` setting. See #504 for details.
## Stork 0.14.0
- Events panel presented for a machine is not refreshed when switching between machine tabs. As a result, this panel may show events referring to a different machine than currently selected. Clicking on the `Machines` tab (the tab listing all machines) and returning to the selected machine's tab is a known workaround to ensure that the correct list of events is displayed for the machine. See #463 for details.
## Stork 0.13.0
- When starting to monitor a machine running Kea with many subnets configured, some errors may be observed in the Stork server logs indicating database unique constraint violations. This is caused by bottlenecks in the process of machine state fetching which may sometimes lead to concurrent updates of the same information in the database. Nevertheless, this should not cause any data integrity issues in Stork database.
## Stork 0.10.0
- If upgrading from previous releases, see known issues for 0.8.0 below.
- When deploying stork agent, make sure that only legitimate stork server is able to connect. A better access control is expected in future Stork versions, but for the time being please use firewall to restrict who can connect to the agent.
## Stork 0.9.0
- If upgrading from previous releases, see known issues for 0.8.0 below.
## Stork 0.8.0
- There are appearing problems with starting Stork demo using `rake docker_up` command on Ubuntu 20.04. This is due to a kernel bug and a workaround in Go runtime. GitLab https://gitlab.isc.org/isc-projects/stork/-/issues/306
- When upgrading Stork Server or Stork Agent from 0.8.0 or 0.9.0 using RPM packages, the upgrade procedure will fail complaining about stork-agent or stork-server account. The workaround for this is to not do upgrade, but remove the old package first and then install new one. This problem is fixed in 0.10.0, so future upgrades to 0.11 and beyond will work. However, the underlying problem is in 0.9.0 and earlier install scripts. If you upgrade from 0.8.0 and encounter problems with missing stork-agent or stork-server accounts, the issue may be fixed using `yum reinstall isc-stork-server` or `yum reinstall isc-stork-agent` on a version 0.10 or later.
## Stork 0.6.0
- It's not possible to install both Agent and Server deb packages on the same machine. The server package contains too many files that conflict with the agent package. This issue will be resolved with updated packages in the near future.
We would appreciate feedback on usability and reports of any Stork bugs. Please contribute your experiences to the Stork users mailing list: https://lists.isc.org/mailman/listinfo/stork-dev or submit [new gitlab issues](https://gitlab.isc.org/isc-projects/stork/-/issues).
\ No newline at end of file