From 23061a2a4dd79377493e566b84fe676475e58ff4 Mon Sep 17 00:00:00 2001
From: Markus <82206269+markus-gitdev@users.noreply.github.com>
Date: Sun, 17 Jul 2022 15:11:17 +0200
Subject: [PATCH] Create u_e-checkmk.de.md

---
 docs/manual-guides/checkmk/u_e-checkmk.de.md | 44 ++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 docs/manual-guides/checkmk/u_e-checkmk.de.md

diff --git a/docs/manual-guides/checkmk/u_e-checkmk.de.md b/docs/manual-guides/checkmk/u_e-checkmk.de.md
new file mode 100644
index 000000000..42d691625
--- /dev/null
+++ b/docs/manual-guides/checkmk/u_e-checkmk.de.md
@@ -0,0 +1,44 @@
+Mailcow bietet mittels dem eigenen Update-Script die Möglichkeit zu prüfen ob Updates vorhanden sind.
+
+Sofern mailcow-Updates mittels checkmk abgefragt werden soll, kann man im `local`-Verzeichnis des checkmk-Agents (normalerweise `/usr/lib/check_mk_agent/local/`) eine ausführbare Datei mit dem Namen `mailcow_update` und nachfolgendem Inhalt erstellen:
+
+````
+#!/bin/bash
+cd /opt/mailcow-dockerized/ && ./update.sh -c >/dev/null
+status=$?
+if [ $status -eq 3 ]; then
+  echo "0 \"mailcow_update\" mailcow_update=0;1;;0;1 No updates available."
+elif [ $status -eq 0 ]; then
+  echo "1 \"mailcow_update\" mailcow_update=1;1;;0;1 Updated code is available.\nThe changes can be found here: https://github.com/mailcow/mailcow-dockerized/commits/master"
+else
+  echo "3 \"mailcow_update\" - Unknown output from update script ..."
+fi
+exit
+````
+
+Sofern das Installationsverzeichnis nicht `/opt/` ist, ist das in der 2. Zeile anzupassen.
+
+Danach für euren mailcow-Host in checmk die Services neu inventarisieren und es sollte ein neuer Check mit Namen `mailcow_update` auswählbar sein.
+
+## Screenshots
+
+### Keine Updates verfügbar
+
+Sofern keine Updates vorhanden sind, wir `OK` ausgegeben.
+
+![No update available](../../assets/images/checkmk/no_updates_available.png)
+
+### Neue Updates verfügbar
+
+Sofern Updates vorhanden sind, wird `WARN` ausgegeben (sollte `CRIT` gewünscht sein ist in der 2. `echo`-Zeile die erste "1" durch eine "2" zu ersetzen).
+
+![Updates available](../../assets/images/checkmk/updates_available.png)
+
+### Detailierter Check-Output
+
+![Long check output](../../assets/images/checkmk/long_check_output.png)
+
+- Hier wird ein Link zu den GitHub Commits von mailcow ausgegeben, sofern Updates verfügbar sind.
+- Metriken werden ebenfalls ausgegeben (nicht nur bei vorhandenen Updates):
+  - 0 = Keine Updates verfügbar
+  - 1 = Neue Updates verfügbar