Zum Inhalt

Deinstallation

Diese Seite beschreibt, wie du Vesana restlos und sauber entfernst — vom einzelnen Agenten bis zur kompletten Server-Instanz. Wähle den Abschnitt, der zu dir passt; die Schritte sind unabhängig voneinander.

Einzelne Agents oder Collectors: am einfachsten aus Vesana heraus

Löschst du einen Host, Collector oder Tenant in Vesana und wählst im Dialog „Deinstallieren“, entfernt sich die Software beim nächsten Kontakt selbst vom Gerät. Eine Handarbeit wie unten ist dann nicht nötig. Ausnahmen: Auf Geräten mit aktivem Agent Lock lehnt sie das ab und ruht stattdessen, und ältere Versionen halten nur an. Details: Deaktivieren, Löschen, Wiederherstellen. Entfernst du die komplette Instanz, gilt diese Seite.

Vesana-Server-Instanz entfernen

Die Instanz läuft als Docker-Compose-Stack unter /opt/vesana (Standard). Ein Befehl stoppt alle Container und entfernt Volumes (Datenbank, Redis, Uploads …), Images und verwaiste Container:

cd /opt/vesana
docker compose -f docker-compose.prod.yml down -v --rmi all --remove-orphans

-v löscht ALLE Daten unwiderruflich

Das Flag -v entfernt die Volumes — die komplette Monitoring-Datenbank, alle Verläufe, Konfigurationen und Backups im Volume sind danach weg. Willst du vorher sichern, lade dir zuerst über Admin → System → Backup & DR ein Voll-Backup herunter (siehe Backup & Disaster-Recovery). Ohne -v bleiben die Volumes erhalten.

Danach den Einrichtungs-Timer des Active-Checkers, das Installationsverzeichnis und das Installer-Protokoll löschen:

systemctl disable --now vesana-ac-autoinstall.timer 2>/dev/null
rm -f /etc/systemd/system/vesana-ac-autoinstall.timer \
      /etc/systemd/system/vesana-ac-autoinstall.service
systemctl daemon-reload

rm -rf /opt/vesana
rm -f /var/log/vesana-install.log

Prüfen, ob wirklich nichts übrig ist:

docker ps -a | grep -i vesana        # sollte leer sein
docker volume ls | grep -i vesana    # sollte leer sein
docker images | grep -i vesana       # sollte leer sein

Active-Checker auf dem Server

Der Active-Checker (Aktiver Collector) läuft als systemd-Dienst direkt auf dem Server-Host, nicht im Container — der Installer richtet ihn automatisch ein. Entferne ihn zusätzlich wie im Abschnitt Aktiven Collector entfernen beschrieben.

Weitere mögliche Spuren

  • System-nginx (Bare-Metal-Setups): Hast du einen eigenen nginx als Reverse-Proxy vor Vesana gesetzt, entferne die Vesana-Site aus /etc/nginx/sites-enabled/ und lade nginx neu (nginx -s reload).
  • Let’s-Encrypt-Zertifikat: Optional certbot delete --cert-name <deine-domain>.
  • Cron/Timer: Cronjobs legt Vesana nicht an. Der einzige systemd-Timer des Servers (vesana-ac-autoinstall.timer) ist mit den Schritten oben entfernt.

Agent entfernen

Der Agent läuft als systemd-Dienst vesana-agent. Deinstallation:

# Dienst stoppen und dauerhaft deaktivieren
sudo systemctl disable --now vesana-agent

# Unit-Datei, Binary, Konfiguration, Logs und Zustand entfernen
sudo rm -f  /etc/systemd/system/vesana-agent.service
sudo rm -f  /usr/local/bin/vesana-agent
sudo rm -rf /etc/vesana-agent
sudo rm -rf /var/log/vesana-agent
sudo rm -rf /var/lib/vesana-agent

# systemd neu einlesen
sudo systemctl daemon-reload
sudo systemctl reset-failed vesana-agent 2>/dev/null || true

Prüfen: systemctl status vesana-agent sollte „Unit vesana-agent.service could not be found" melden.

Ein zweiter Agent heißt vesana-agent-<name> — dieselben Schritte mit dem Suffix an Dienst, Binary und Verzeichnissen.

Der Agent läuft als Windows-Dienst VesanaAgent und ist als reguläres Programm registriert.

Empfohlen (grafisch): Einstellungen → Apps → Installierte Apps → „Vesana Agent" → Deinstallieren. Der mitgelieferte Uninstaller stoppt den Dienst, entfernt das Programm und den Registry-Eintrag.

Alternativ (PowerShell als Administrator):

# Uninstaller des NSIS-Setups aufrufen (Standard-Installationspfad)
& "$env:ProgramFiles\Vesana Agent\uninstall.exe" /S

# Falls der Dienst wider Erwarten bleibt, hart entfernen:
Stop-Service VesanaAgent -ErrorAction SilentlyContinue
sc.exe delete VesanaAgent

Konfiguration ebenfalls entfernen (optional):

Remove-Item -Recurse -Force "$env:ProgramData\Vesana\Agent" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:APPDATA\Vesana\Agent"     -ErrorAction SilentlyContinue

Collector entfernen

Der Collector läuft als systemd-Dienst vesana-collector.

# Dienst (und den Deinstallations-Helfer) stoppen und deaktivieren
sudo systemctl disable --now vesana-collector vesana-collector-uninstall.path vesana-collector-update.path 2>/dev/null

# Unit-Dateien, Programm, Konfiguration, Zustand und Plugins entfernen
sudo rm -f  /etc/systemd/system/vesana-collector.service \
            /etc/systemd/system/vesana-collector-uninstall.path \
            /etc/systemd/system/vesana-collector-uninstall.service \
            /etc/systemd/system/vesana-collector-update.path \
            /etc/systemd/system/vesana-collector-update.service \
            /usr/local/sbin/vesana-collector-uninstall \
            /usr/local/bin/vesana-collector
sudo rm -rf /var/lib/vesana-collector /etc/vesana /etc/vesana-lock/collector /opt/vesana-collector
# Nur ohne Aktiven Collector auf derselben Maschine:
sudo rm -rf /var/lib/vesana-active-collector
sudo userdel vesana-collector 2>/dev/null || true

sudo systemctl daemon-reload
sudo systemctl reset-failed vesana-collector 2>/dev/null || true

Genau diese Schritte führt auch der Deinstallations-Helfer aus, wenn du den Collector in Vesana mit „Deinstallieren“ löschst.

Aktiven Collector entfernen

Der Aktive Collector (Active-Checker) läuft als eigener systemd-Dienst vesana-active-collector unter dem System-Benutzer vesana-ac. Weitere Instanzen auf derselben Maschine heißen vesana-active-collector-<name> — dieselben Schritte mit dem Suffix an Dienst und Verzeichnissen.

# Dienst stoppen und deaktivieren
sudo systemctl disable --now vesana-active-collector vesana-active-collector-update.path

# Unit-Datei, Binary, Konfiguration und Zustand entfernen
sudo rm -f  /etc/systemd/system/vesana-active-collector.service \
            /etc/systemd/system/vesana-active-collector-update.path \
            /etc/systemd/system/vesana-active-collector-update.service
sudo rm -f  /usr/local/bin/vesana-active-collector
sudo rm -rf /etc/vesana-active-collector
sudo rm -rf /var/lib/vesana-active-collector
sudo rm -rf /opt/vesana-active-collector
sudo rm -rf /etc/vesana-lock/active-collector
# Nur ohne regulären Collector auf derselben Maschine:
sudo rm -rf /var/lib/vesana-collector

sudo systemctl daemon-reload
sudo systemctl reset-failed vesana-active-collector 2>/dev/null || true

# System-Benutzer entfernen (optional)
sudo userdel vesana-ac 2>/dev/null || true

Danach

  • Geräte in Vesana aufräumen: Falls du Agenten/Collectoren entfernt hast, ohne sie vorher in der Oberfläche zu löschen, erscheinen sie eine Weile als „offline" bzw. „No Data". Lösche die betreffenden Hosts/Collectoren in der Vesana-Oberfläche.
  • Lizenz: Es gibt keinen Aktivierungsserver, der abgemeldet werden müsste — mit dem Entfernen der Instanz ist alles erledigt.