106 lines
2.7 KiB
Markdown
106 lines
2.7 KiB
Markdown
# 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.
|