Initial commit: Zabbix Agent 7.4 deployment scripts

README.md

@@ -0,0 +1,105 @@
+# Zabbix Agent Deployment
+
+Bash-Skripte zur automatischen Installation und Aktualisierung des Zabbix Agent 2 (Version 7.4) auf Debian/Ubuntu-Systemen – lokal oder per SSH-Remote-Deployment.
+
+---
+
+## Voraussetzungen
+
+- Zielhost: Debian 11/12 oder Ubuntu 20.04 / 22.04 / 24.04
+- SSH Key-Authentifizierung eingerichtet (`~/.ssh/config`)
+- Zielhost muss als `root` erreichbar sein
+- `wget` auf dem Zielhost vorhanden
+
+---
+
+## Konfiguration
+
+In `install-zabbix-agent.sh` die Zabbix-Server-Adresse eintragen:
+
+```bash
+ZABBIX_SERVER="zabbix.example.com"   # Zeile 16
+```
+
+---
+
+## Skripte
+
+### `install-zabbix-agent.sh`
+Installiert Zabbix Agent 2 auf dem lokalen System.
+
+```bash
+sudo bash install-zabbix-agent.sh <zabbix-hostname>
+```
+
+Was es tut:
+- Erkennt automatisch Debian oder Ubuntu (inkl. Version)
+- Richtet das Zabbix 7.4 Repository ein
+- Installiert `zabbix-agent2`
+- Setzt `Hostname` und `ServerActive` in der Konfiguration
+- Aktiviert und startet den Dienst
+
+---
+
+### `deploy-zabbix-agent.sh`
+Installiert Zabbix Agent 2 auf einem entfernten Host per SSH.
+
+```bash
+bash deploy-zabbix-agent.sh <ssh-config-name> <zabbix-hostname>
+```
+
+Beispiel:
+```bash
+bash deploy-zabbix-agent.sh webserver webserver-prod-01
+```
+
+`<ssh-config-name>` ist der Host-Eintrag aus `~/.ssh/config`. User, Port und Key werden automatisch von dort übernommen.
+
+---
+
+### `update-zabbix-agent.sh`
+Aktualisiert einen vorhandenen Zabbix Agent 2 auf Version 7.4 auf dem lokalen System.
+
+```bash
+sudo bash update-zabbix-agent.sh
+```
+
+Was es tut:
+- Prüft ob `zabbix-agent2` installiert ist
+- Richtet das Zabbix 7.4 Repository ein
+- Führt das Upgrade durch – **bestehende Konfiguration bleibt erhalten**
+- Interaktive Rückfragen von `dpkg`/`apt` werden automatisch unterdrückt
+- Startet den Dienst neu
+
+---
+
+### `deploy-update-zabbix-agent.sh`
+Aktualisiert Zabbix Agent 2 auf einem entfernten Host per SSH.
+
+```bash
+bash deploy-update-zabbix-agent.sh <ssh-config-name>
+```
+
+Beispiel:
+```bash
+bash deploy-update-zabbix-agent.sh webserver
+```
+
+---
+
+## Ablauf nach der Installation
+
+Den Host im Zabbix-Frontend anlegen, falls noch nicht vorhanden:
+
+**Configuration → Hosts → Create host**
+
+- Host name: identisch mit dem beim Skriptaufruf angegebenen `<zabbix-hostname>`
+- Interface: Agent (aktiv) – keine IP-Adresse notwendig bei reinem Aktiv-Modus
+- Template: z.B. `Linux by Zabbix agent active`
+
+---
+
+## Hinweise
+
+- TrueNAS SCALE: Package-Management ist gesperrt, Agent-Installation nicht möglich. Überwachung via **SNMP** empfohlen (Services → SNMP im TrueNAS Web-Interface).
+- Der SSH Post-Quantum-Hinweis (`WARNING: connection is not using a post-quantum key exchange algorithm`) ist eine reine Warnung des OpenSSH-Clients und hat keinen Einfluss auf die Funktion.