Werk 17146 was deleted. The following Werk is no longer relevant.
[//]: # (werk v2)
# Remove etc/apache/conf.d/var_www.conf
key | value
---------- | ---
date | 2024-07-15T12:21:48+00:00
version | 2.4.0b1
class | feature
edition | cre
component | multisite
level | 1
compatible | no
Checkmk used to come with an apache config file `etc/apache/conf.d/var_www.conf`.
By default this file added/enabled directory listing for sub-directories under `var/www/`.
The main folder `var/www` was not listed though since the URL is redirected to Checkmk.
In order to simplify the configuration we drop that file.
If you edited that file you will be asked if you want to keep it upon update.
If you relied on the directory listing you can enable it again e.g. by copying the file from an older version.
[//]: # (werk v2)
# Rest API: change response codes for some endpoints from 302 to 303
key | value
---------- | ---
date | 2024-07-11T14:48:17+00:00
version | 2.4.0b1
class | fix
edition | cre
component | rest-api
level | 1
compatible | no
Some endpoints accept some data (via POST, PUT), start a background job and then
redirect to other "wait-for-completion" endpoints. The wait-for-completion
endpoints however expected requests with the GET method.
Previously, we used the response code "302 Found" in these cases. Some clients,
like the python requests library, always change the method to GET on redirects,
but this is not according to the spec. As such "correct" clients ran into issues
so we made the decision to update these endpoints to use "303 See other"
instead. This status code guarantees a change to the GET method.
Affected endpoints:
* Execute service discovery on host
(`/domain-types/service_discovery_run/actions/start/invoke`)
* Rename a host
(`/objects/host_config/example.com/actions/rename/invoke`)
* Activate pending changes
(`/domain-types/activation_run/actions/activate-changes/invoke`)
[//]: # (werk v2)
# Rest API: change host rename wait for completion endpoint to GET
key | value
---------- | ---
date | 2024-07-11T14:16:49+00:00
version | 2.4.0b1
class | fix
edition | cre
component | rest-api
level | 1
compatible | no
The wait-for-completion endpoint for host renames was using the POST method.
This caused some issues and was inconsitent with other such endpoints.
This werk changes the endpoint to be GET, just like the other ones.
[//]: # (werk v2)
# Extraneous characters in rule representation
key | value
---------- | ---
date | 2024-07-15T07:23:03+00:00
version | 2.4.0b1
class | fix
edition | cre
component | multisite
level | 1
compatible | yes
With long rulesets, the rule representation (Export this rule for API) often
would display extraneous characters such as newlines or whitespace.
This did not affect the functionality of the feature, but could be confusing, so now
these characters are no longer displayed.
[//]: # (werk v2)
# Siemens PLC agent configuration: Take timeout parameter into account
key | value
---------- | ---
date | 2024-07-12T10:47:29+00:00
version | 2.4.0b1
class | fix
edition | cre
component | checks
level | 1
compatible | yes
When configuring the Siemens PLC agent, users could configure a per-device timeout. However, the
configured values had no effect. Instead, the agent always used a default value of 10 seconds. As
of this werk, users can instead configure one global timeout value, which is taken into account by
the agent.
Werk 17155 was adapted. The following is the new Werk, a diff is shown at the end of the message.
[//]: # (werk v2)
# Microsoft Teams: Use workflows instead of connectors
key | value
---------- | ---
date | 2024-07-15T08:57:21+00:00
version | 2.4.0b1
class | fix
edition | cre
component | notifications
level | 1
compatible | no
Since Microsoft announced the deprecation of connectors, the notification
plugin for Microsoft Teams was adjusted to use workflows.
Deprecation note:
https://devblogs.microsoft.com/microsoft365dev/retirement-of-office-365-con…
To configure a workflow within Microsoft Teams:
* Click the 3 dots on a channel and select “Workflows”
* Choose "Post to a channel when a webhook request is received"
* Choose name for the workflow, e.g. "Checkmk"
* Select team and channel where the webhook should post to
* Copy webhook URL
For further informations please see section "How do I transition from Office
365 connectors to Workflows?" in the deprecation note.
To configure the notification plugin within Checkmk:
* Post copied webhook URL to "Webhook URL" of your notification rule for MS Teams
If you used custom "Details for host notifications" or "Details for service
notifications", the line break "<br>" has to be replaced by "\\u00A0\\n".
As we now use Adaptive Cards instead of Message Cards, we can no longer use
colors.
------------------------------------<diff>-------------------------------------------
[//]: # (werk v2)
# Microsoft Teams: Use workflows instead of connectors
key | value
---------- | ---
date | 2024-07-15T08:57:21+00:00
version | 2.4.0b1
class | fix
edition | cre
component | notifications
level | 1
compatible | no
Since Microsoft announced the deprecation of connectors, the notification
plugin for Microsoft Teams was adjusted to use workflows.
Deprecation note:
https://devblogs.microsoft.com/microsoft365dev/retirement-of-office-365-con…
To configure a workflow within Microsoft Teams:
* Click the 3 dots on a channel and select “Workflows”
* Choose "Post to a channel when a webhook request is received"
* Choose name for the workflow, e.g. "Checkmk"
* Select team and channel where the webhook should post to
* Copy webhook URL
For further informations please see section "How do I transition from Office
365 connectors to Workflows?" in the deprecation note.
To configure the notification plugin within Checkmk:
* Post copied webhook URL to "Webhook URL" of your notification rule for MS Teams
If you used custom "Details for host notifications" or "Details for service
- notifications", the line break "<br\>" has to be replaced by "\\u00A0\\n".
? ^ ^^
+ notifications", the line break "<br>" has to be replaced by "\\u00A0\\n".
? ^^^^ ^^^^
As we now use Adaptive Cards instead of Message Cards, we can no longer use
colors.
Title: Support Azure Databases for MySQL flexible server
Class: feature
Compatible: compat
Component: checks
Date: 1720519796
Edition: cre
Level: 1
Version: 2.2.0p31
Microsoft is retiring the Azure resource "Database for MySQL single server" (see https://learn.microsoft.com/en-us/azure/mysql/migrate/whats-happening-to-my…).
With this Werk we now support monitoring the recommended Azure resource "Database for MySQL flexible server".
In the rule "Microsoft Azure" under "Azure services to monitor" users can now select the new option "Database for MySQL flexible server".
(Note that the former option "Database for MySQL" was renamed to "Database for MySQL single server" and stays in place.)
The metrics monitored for flexible servers correspond to those monitored for single servers and the same checks are used.
See the <a href="https://checkmk.com/integrations?distributions%5B%5D=check_mk&distribut…">check plugin catalog</a> for more details.
Werk 16431 was adapted. The following is the new Werk, a diff is shown at the end of the message.
Title: omd restore: Fix RuntimeError: Failed to determine site version
Class: fix
Compatible: compat
Component: omd
Date: 1718107423
Edition: cre
Level: 1
Version: 2.2.0p32
Due to a regression introduced by <a href="https://checkmk.com/werk/16422">Werk #16422</a>, the
command `omd restore <NEW_SITE> <ARCHIVE_PATH>` could fail:
C+:
File "/omd/versions/2.3.0p6.cee/lib/python3/omdlib/main.py", line 3522, in _restore_backup_from_tar
old_site.replacements(),
^^^^^^^^^^^^^^^^^^^^^^^
File "/omd/versions/2.3.0p6.cee/lib/python3/omdlib/contexts.py", line 136, in replacements
raise RuntimeError("Failed to determine site version")
C-:
The failure only occured, if the user provided a site name, which differed from the original name,
and the original site did no longer exist. This crash also affected the `Migrate existing Site`
function of the appliance.
If you are affected by this crash, but are unable to update, then you can start be restoring the
site without a new name. The site can then be renamed with `omd mv`.
------------------------------------<diff>-------------------------------------------
Title: omd restore: Fix RuntimeError: Failed to determine site version
Class: fix
Compatible: compat
Component: omd
Date: 1718107423
Edition: cre
Level: 1
- Version: 2.2.0p29
? -
+ Version: 2.2.0p32
? +
Due to a regression introduced by <a href="https://checkmk.com/werk/16422">Werk #16422</a>, the
command `omd restore <NEW_SITE> <ARCHIVE_PATH>` could fail:
C+:
File "/omd/versions/2.3.0p6.cee/lib/python3/omdlib/main.py", line 3522, in _restore_backup_from_tar
old_site.replacements(),
^^^^^^^^^^^^^^^^^^^^^^^
File "/omd/versions/2.3.0p6.cee/lib/python3/omdlib/contexts.py", line 136, in replacements
raise RuntimeError("Failed to determine site version")
C-:
The failure only occured, if the user provided a site name, which differed from the original name,
and the original site did no longer exist. This crash also affected the `Migrate existing Site`
function of the appliance.
If you are affected by this crash, but are unable to update, then you can start be restoring the
site without a new name. The site can then be renamed with `omd mv`.
Werk 17092 was adapted. The following is the new Werk, a diff is shown at the end of the message.
Title: Fix missing CSRF token issues
Class: fix
Compatible: compat
Component: wato
Date: 1719997630
Edition: cre
Level: 1
Version: 2.2.0p32
Werk #17090 in Checkmk 2.3.0p8 and 2.2.0p29 introduced additional CSRF token checks in the GUI.
This caused some buttons to not work anymore because the CSRF token was missing, including, but likely not limited to:
LI: "Synchronize users" in Setup > Users to manually trigger the LDAP sync (the background sync still runs)
LI: "Show analysis" and "Show bulks" in Setup > Events > Notifications
LI: Reordering notification rules via drag-and-drop in the same view
LI: "Bake agents" in the agent bakery (as a workaround, use "Bake and sign agents")
LI: "Acknowledge last baking result" when a bake job failed (as a workaround, delete the failed job instead)
This Werk fixes the issues by adding the token.
------------------------------------<diff>-------------------------------------------
Title: Fix missing CSRF token issues
Class: fix
Compatible: compat
Component: wato
Date: 1719997630
Edition: cre
Level: 1
- Version: 2.2.0p30
? ^
+ Version: 2.2.0p32
? ^
Werk #17090 in Checkmk 2.3.0p8 and 2.2.0p29 introduced additional CSRF token checks in the GUI.
This caused some buttons to not work anymore because the CSRF token was missing, including, but likely not limited to:
LI: "Synchronize users" in Setup > Users to manually trigger the LDAP sync (the background sync still runs)
LI: "Show analysis" and "Show bulks" in Setup > Events > Notifications
LI: Reordering notification rules via drag-and-drop in the same view
LI: "Bake agents" in the agent bakery (as a workaround, use "Bake and sign agents")
LI: "Acknowledge last baking result" when a bake job failed (as a workaround, delete the failed job instead)
This Werk fixes the issues by adding the token.