rpwolff/zabbix-agent-deployment
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
master
zabbix-agent-deployment/README.md

3.9 KiB
Raw Permalink Blame History

Zabbix Agent Deployment

Skripte zur automatischen Installation und Aktualisierung des Zabbix Agent 2 (Version 7.4) auf Linux- und Windows-Systemen – lokal oder per SSH-Remote-Deployment.

Voraussetzungen

Linux:

  • Zielhost: Debian 11/12/13 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

Windows:

  • Windows 10/11 oder Windows Server 2016+
  • PowerShell 5.1 oder neuer
  • Ausführung als Administrator erforderlich

Konfiguration

Linux – in install-zabbix-agent.sh und update-zabbix-agent.sh:

ZABBIX_SERVER="zabbix.example.com"   # Zeile 16

Windows – in install-update-zabbix-agent.ps1:

$ZabbixServer  = "zabbix.example.com"   # Zabbix-Server-Adresse
$ZabbixVersion = "7.4.2"               # Bei neuen Releases anpassen
$ProxyList = @(                         # Proxy-Liste manuell pflegen
    "http://proxy01.example.com:3128"
    "http://proxy02.example.com:3128"
)

Skripte

install-zabbix-agent.sh

Installiert Zabbix Agent 2 auf dem lokalen System.

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 deploy-zabbix-agent.sh <ssh-config-name> <zabbix-hostname>

Beispiel:

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.

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 deploy-update-zabbix-agent.sh <ssh-config-name>

Beispiel:

bash deploy-update-zabbix-agent.sh webserver

install-update-zabbix-agent.ps1

Installiert oder aktualisiert Zabbix Agent 2 auf Windows – erkennt automatisch ob bereits eine Version vorhanden ist.

PowerShell -ExecutionPolicy Bypass -File install-update-zabbix-agent.ps1

Was es tut:

  • Erkennt automatisch: Neuinstallation oder Update
  • Interaktive Eingabe des Zabbix-Hostnamens (Standard: Computername)
  • Interaktive Proxy-Auswahl aus gepflegter Liste oder direkte Verbindung
  • Lädt die MSI von cdn.zabbix.com herunter
  • Installiert/aktualisiert still (/qn) ohne Benutzerinteraktion beim MSI
  • Setzt SERVER, SERVERACTIVE und HOSTNAME direkt beim MSI-Aufruf
  • Startet den Dienst automatisch

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 bzw. Windows 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.