Unit Instance

HTTP 200 OK
Allow: GET, PUT, PATCH, DELETE, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "translation": "https://translate.checkmk.com/api/translations/checkmk/dev/de/?format=api",
    "source": [
        "This rule provides a simple way to add files to agent bakery packages without the need to write a bakery plugin.<br><i>Custom files</i> are organized in folders under <tt>{omd_root}/local/share/check_mk/agents/custom</tt>.<br>To add a set of custom files to the agent, please create a subfolder there with a meaningful name of your choice.<br>Added folders will be shown in this rule for activation.<br><br>Since the agent installation paths are customizable by other rules, the file structure below these sets doesn't resemble directly to the agent installation.<br>Instead, the structure is organized in <i>logical paths</i> that map to certain target folders in the final agent installation.<br>Files placed under a <i>logical path</i> will also apply the ownership and permissions based on the agent installation.<br><br><h2>Mapping under Linux/UNIX:</h2><br>Ownership and permissions on the Checkmk site's file structure don't matter, with one exception: Executable flags on files will be preserved.<br><br>Overview of <i>logical paths</i> and their targets:<ul><li><tt>lib</tt>: Internal agent files (<tt>MK_LIBDIR</tt> on the host)</li><li><tt>bin</tt>: Executables (<tt>MK_BIN</tt> on the host)</li><li><tt>var</tt>: Runtime data (<tt>MK_VARDIR</tt> on the host)</li><li><tt>config</tt>: Configuration files (<tt>MK_CONFDIR</tt> on the host)</li><li><tt>lib/plugins</tt>: Agent plugins</li><li><tt>lib/local</tt>: Local checks</li></ul><b>Example</b>: Let's say you place the following files:<br><tt>{omd_root}/local/share/check_mk/agents/custom/myset/bin/some_executable</tt><br><tt>{omd_root}/local/share/check_mk/agents/custom/myset/lib/local/my_local_check</tt><br><tt>{omd_root}/local/share/check_mk/agents/custom/myset/some_file</tt><br>and activate <i>myset</i> in this rule.<br>Then, the following files will be deployed to target hosts when not further configuring agent paths:<br><tt>/usr/bin/some_executable</tt><br><tt>/usr/lib/check_mk_agent/local/my_local_check</tt><br><tt>/usr/lib/check_mk_agent/some_file</tt><br>When activating the single directory deployment in the <i>Customize agent package</i> ruleset:<br><tt>/opt/checkmk/agent/default/package/bin/some_executable</tt><br><tt>/opt/checkmk/agent/default/package/local/my_local_check</tt><br><tt>/opt/checkmk/agent/default/package/some_file</tt><br><br><h2>Mapping under Windows:</h2><br>Other than the Linux/UNIX agent installation, the Windows agent installation uses fixed paths, so there is also a fixed mapping from logical path to folders on the host.<br>Like other agent plugins, custom files install to the working directory under <tt>C:\\ProgramData\\checkmk\\agent</tt>:<ul><li><tt>lib</tt>: <tt>..\\agent</tt></li><li><tt>bin</tt>: <tt>..\\agent\\bin</tt></li><li><tt>var</tt>: <tt>..\\agent</tt></li><li><tt>config</tt>: <tt>..\\agent\\config</tt></li><li><tt>lib/plugins</tt>: <tt>..\\agent\\plugins</tt></li><li><tt>lib/local</tt>: <tt>..\\agent\\local</tt></li></ul>"
    ],
    "previous_source": "",
    "target": [
        "Diese Regel bietet eine einfache Möglichkeit, Dateien zu Paketen der Agentenbäckerei hinzuzufügen, ohne ein Bäckerei-Plugin schreiben zu müssen.<br><i>Benutzerdefinierte Dateien</i> sind in Ordnern unter <tt>{omd_root}/local/share/check_mk/agents/custom</tt> organisiert.<br>Um einen Satz benutzerdefinierter Dateien zum Agenten hinzuzufügen, erstellen Sie dort einen Unterordner mit einem aussagekräftigen Namen Ihrer Wahl.<br>Die hinzugefügten Ordner werden in dieser Regel zur Aktivierung angezeigt.<br><br>Da die Installationspfade des Agenten durch andere Regeln angepasst werden können, ähnelt die Dateistruktur unterhalb dieser Sätze nicht direkt der Agenteninstallation.<br>Stattdessen ist die Struktur in <i>logischen Pfaden</i> organisiert, die bestimmten Zielordnern in der endgültigen Agenteninstallation zugeordnet sind.<br>Für Dateien, die unter einem <i>logischen Pfad</i> platziert werden, gelten auch die Eigentumsverhältnisse und Berechtigungen, die auf der Agenteninstallation basieren.<br>Eigentum und Berechtigungen in der Dateistruktur der Checkmk-Instanz spielen keine Rolle, mit einer Ausnahme: Ausführbare Flags für Dateien bleiben erhalten.<br><br>Überblick der <i>logischen Pfade</i> und ihrer Ziele:<ul><li><tt>lib</tt>: Interne Agentendateien (<tt>MK_LIBDIR</tt> auf dem Host)</li><li><tt>bin</tt>: Ausführbare Dateien (<tt>MK_BIN</tt> auf dem Host)</li><li><tt>var</tt>: Laufzeitdaten (<tt>MK_VARDIR</tt> auf dem Host)</li><li><tt>config</tt>: Konfigurationsdateien (<tt>MK_CONFDIR</tt> auf dem Host)</li><li><tt>lib/plugins</tt>: Agenten-Plugins</li><li><tt>lib/local</tt>: Lokale Checks</li></ul><b>Beispiel</b>: Angenommen, Sie platzieren die folgenden Dateien:<br><tt>{omd_root}/local/share/check_mk/agents/custom/myset/bin/some_executable</tt><br><tt>{omd_root}/local/share/check_mk/agents/custom/myset/lib/local/my_local_check</tt><br><tt>{omd_root}/local/share/check_mk/agents/custom/myset/some_file</tt><br>und aktivieren <i>myset</i> in dieser Regel.<br>Dann werden die folgenden Dateien auf den Ziel-Hosts verteilt, wenn die Agentenpfade nicht weiter konfiguriert werden:<br><tt>/usr/bin/some_executable</tt><br><tt>/usr/lib/check_mk_agent/local/my_local_check</tt><br><tt>/usr/lib/check_mk_agent/some_file</tt><br>Beim Aktivieren der einzelnen Verzeichnisverteilung im Regelsatz <i>Agentenpaket anpassen</i>:<br><tt>/opt/checkmk/agent/default/package/bin/some_executable</tt><br><tt>/opt/checkmk/agent/default/package/local/my_local_check</tt><br><tt>/opt/checkmk/agent/default/package/some_file</tt><br><br><b>Hinweis</b>: Bei der Verwendung des Windows-Agenten verweisen alle logischen Pfade auf denselben Ort - das Installationsverzeichnis des Agenten."
    ],
    "id_hash": 6769439224792619853,
    "content_hash": 6769439224792619853,
    "location": "cmk/gui/cee/plugins/wato/agent_bakery/rulespecs/custom_files.py:47",
    "context": "",
    "note": "",
    "flags": "python-brace-format",
    "labels": [],
    "state": 10,
    "fuzzy": true,
    "translated": false,
    "approved": false,
    "position": 17710,
    "has_suggestion": false,
    "has_comment": false,
    "has_failing_check": true,
    "num_words": 256,
    "source_unit": "https://translate.checkmk.com/api/units/2392925/?format=api",
    "priority": 100,
    "id": 2392940,
    "web_url": "https://translate.checkmk.com/translate/checkmk/dev/de/?checksum=ddf1e11be25c1b4d",
    "url": "https://translate.checkmk.com/api/units/2392940/?format=api",
    "explanation": "",
    "extra_flags": "",
    "pending": false,
    "timestamp": "2025-05-15T05:03:10.071081Z"
}