Werk #14647: Agent Bakery: Configure generic agents for any folder

Component Agent bakery
Title Agent Bakery: Configure generic agents for any folder
Date Sep 15, 2022
Checkmk Edition Checkmk Enterprise (CEE)
Checkmk Version 2.1.0p13 2.2.0b1
Level Trivial Change
Class New Feature
Compatibility Compatible - no manual interaction needed

Users can now configure Checkmk to bake generic agents for any folder.

Previously this was only (and always) done for the root folder (usually called Main). All rules that match the root folder without any host condition where used to create an agent configuration. The resulting agent package was refered to as "GENERIC".

The same logic can now be used to bake a generic agent for any other folder.

To activate this users can check the box "Bake agent packages" in the folders settings. An generic agent is then created for this very folder (not for its children), even if the folder is empty. The default behaviour is unchanged, only the root folders package will be created.

As a side effect, the names on the download pages are changed from

  GENERIC, VANILLA, MyHost1, MyHost2

to

  Vanilla (factory settings)
  Folders: / (root folder)
  Hosts: MyHost1, MyHost2

In the REST API users can download these generic agents by setting agent_type='generic' and adding the folder_name field to the request. Omiting the folder_name will default to the generic agent of the root folder, to provide compatibility.

To the list of all Werks