Add Checkmk OS info plugin

os-info/README.md

@@ -0,0 +1,161 @@
+# Checkmk OS Info
+
+MKP-Erweiterung für **Checkmk Community 2.5.x**, die auf überwachten Hosts einen eigenen Service **„Betriebssystem“** bereitstellt.
+
+## Funktionen
+
+Der Service zeigt unter anderem:
+
+- Betriebssystem bzw. Linux-Distribution
+- Betriebssystem-Version / Windows-Build
+- Architektur
+- Kernel-Version
+- OS-ID und Version-ID
+
+Unterstützt werden Linux, Windows und grundsätzlich auch macOS.
+
+## Repository-Struktur
+
+```text
+checkmk-os-info/
+├── src/
+│   ├── agents/
+│   │   ├── plugins/
+│   │   │   └── os_info
+│   │   └── windows/
+│   │       └── plugins/
+│   │           └── os_info.ps1
+│   └── cmk_addons_plugins/
+│       └── os_info/
+│           ├── agent_based/
+│           │   └── os_info.py
+│           └── checkman/
+│               └── os_info
+├── dist/
+│   └── os_info-1.0.0.mkp
+├── CHANGELOG.md
+├── LICENSE
+└── README.md
+```
+
+## Installation des MKP
+
+Das fertige Paket befindet sich unter:
+
+```text
+dist/os_info-1.0.0.mkp
+```
+
+Auf den Checkmk-Server kopieren und als Site-Benutzer installieren:
+
+```bash
+mkp add /tmp/os_info-1.0.0.mkp
+mkp enable os_info 1.0.0
+cmk -R
+```
+
+Kontrolle:
+
+```bash
+mkp list
+```
+
+Der Eintrag `os_info` sollte als `Enabled (active on this site)` erscheinen.
+
+## Agent-Plug-in für Linux/macOS
+
+Nach Aktivierung des MKP liegt das Plug-in im lokalen Site-Verzeichnis:
+
+```text
+~/local/share/check_mk/agents/plugins/os_info
+```
+
+Auf den Zielhost kopieren:
+
+```bash
+scp ~/local/share/check_mk/agents/plugins/os_info \
+root@HOST:/usr/lib/check_mk_agent/plugins/os_info
+```
+
+Danach auf dem Zielhost:
+
+```bash
+chmod 755 /usr/lib/check_mk_agent/plugins/os_info
+/usr/lib/check_mk_agent/plugins/os_info
+```
+
+Die Ausgabe muss mit folgender Sektion beginnen:
+
+```text
+<<<os_info:sep(9)>>>
+```
+
+## Agent-Plug-in für Windows
+
+Nach Aktivierung liegt die PowerShell-Datei auf dem Checkmk-Server unter:
+
+```text
+~/local/share/check_mk/agents/windows/plugins/os_info.ps1
+```
+
+Auf dem Windows-Host nach folgendem Verzeichnis kopieren:
+
+```text
+C:\ProgramData\checkmk\agent\plugins\os_info.ps1
+```
+
+## Service Discovery
+
+Auf dem Checkmk-Server zunächst prüfen, ob die Agent-Sektion ankommt:
+
+```bash
+cmk -d HOSTNAME | grep -A2 '^<<<os_info'
+```
+
+Danach die Service-Erkennung ausführen:
+
+```bash
+cmk -vI HOSTNAME
+cmk -R
+```
+
+Anschließend erscheint beim Host der Service:
+
+```text
+Betriebssystem
+```
+
+## Fehlersuche
+
+Installierte Dateien des MKP suchen:
+
+```bash
+find ~/local -type f -name 'os_info*'
+```
+
+Status des Pakets:
+
+```bash
+mkp list
+```
+
+Agent-Ausgabe kontrollieren:
+
+```bash
+cmk -d HOSTNAME | grep -A2 '^<<<os_info'
+```
+
+## Kompatibilität
+
+Entwickelt für:
+
+- Checkmk Community 2.5.x
+- Check API V2
+- Linux-Agent
+- Windows-Agent
+
+Aktuelle Paketversion: **1.0.0**
+
+## Lizenz
+
+GPL-2.0