Deaktivieren, Löschen, Wiederherstellen¶
Agent und Collector folgen dem, was du in Vesana mit ihrem Host, Collector oder Tenant machst. Auf dem Gerät musst du dafür nichts tun, mit einer Ausnahme: nach einer Deinstallation muss die Software neu installiert werden, wenn du sie zurückhaben willst.
Auf einen Blick¶
| Du machst in Vesana … | Agent / Collector auf dem Gerät |
|---|---|
| Host oder Tenant deaktivieren | pausiert: keine Checks, keine Logs, keine Discovery |
| Host oder Tenant wieder aktivieren | arbeitet innerhalb von 20 Sekunden von selbst weiter |
| Löschen mit „Installiert lassen“ (Standard) | ruht und fragt nur noch alle 5 Minuten kurz nach |
| Wiederherstellen aus dem Papierkorb | arbeitet innerhalb von 5 Minuten von selbst weiter |
| Löschen mit „Deinstallieren“ | entfernt sich beim nächsten Kontakt vollständig vom Gerät |
| Papierkorb leeren (oder nach 30 Tagen automatisch) | hält endgültig an, die Dateien bleiben auf dem Gerät. War „Deinstallieren“ gewählt, entfernt er sich. |
| Agent entfernen (Host → Agent-Chip) | hält an, auf Wunsch deinstalliert er sich |
Deaktivieren = Pause¶
Ein deaktivierter Host (oder ein deaktivierter Tenant) wird nicht abgemeldet. Der Agent läuft weiter, bekommt aber keine Checks und keine Log-Quellen mehr. Er meldet sich nur noch kurz alle 20 Sekunden. Reaktivierst du den Host, holt er seine Checks beim nächsten Kontakt und misst sofort alles neu.
Ein Collector pausiert, wenn sein Tenant deaktiviert ist. Er prüft dann nichts und führt keine Discovery aus. Der Aktive Collector auf dem Vesana-Server pausiert nie, weil er alle Tenants bedient.
Löschen: „Installiert lassen“ oder „Deinstallieren“¶
Beim Löschen eines Hosts mit Agent, eines Collectors oder eines Tenants fragt der Dialog, was auf dem Gerät passieren soll.
Installiert lassen (Standard)¶
Der Agent ruht: keine Checks, keine Logs, keine Discovery. Er fragt alle 5 Minuten kurz bei Vesana nach, ob er wieder gebraucht wird. Stellst du den Host aus dem Papierkorb wieder her, arbeitet er innerhalb von 5 Minuten von selbst weiter.
Im Ruhezustand braucht der Agent (bzw. Collector) so gut wie nichts — er ist nur jederzeit bereit, wieder aufzuwachen.
Leerst du den Papierkorb, gibt es nichts mehr, wohin der Agent zurückkommen könnte. Er hält dann endgültig an und verbraucht nichts mehr. Programm und Dateien bleiben auf dem Gerät (siehe Deinstallation).
Deinstallieren¶
Beim nächsten Kontakt entfernt sich der Agent vollständig vom Gerät: Dienst, Programm, Konfiguration, Zustandsdaten und Logs. Ist das Gerät gerade aus, passiert das, sobald es wieder läuft. Der Agent entfernt dabei nur sich selbst. Welche Dateien das sind, steht fest im Agenten, der Vesana-Server schickt weder Pfade noch Befehle mit.
- Linux: über einen eigenen systemd-Lauf (
vesana-agent-uninstall-<pid>). Er stoppt den Dienst und entfernt/usr/local/bin/vesana-agent,/etc/vesana-agent,/var/lib/vesana-agent,/var/log/vesana-agentund die Unit-Datei. - Windows: über eine einmalige geplante Aufgabe (SYSTEM). Sie stoppt und
entfernt den Dienst, löscht den Programm-Ordner und
%ProgramData%\Vesana\Agentund entfernt den Eintrag unter „Installierte Apps“. Das Protokoll liegt unterC:\Windows\Temp\vesana-agent-uninstall.log. - Collector: Der Collector läuft bewusst ohne root-Rechte und kann sich
deshalb nicht selbst entfernen. Der Installer legt dafür einen kleinen
Root-Helfer an (
vesana-collector-uninstall.path). Der Collector legt nur eine Anforderungs-Datei an, der Helfer entfernt Dienst, Programm, Konfiguration und den Dienst-Benutzer. Collectors, die mit einem älteren Installer eingerichtet wurden, haben den Helfer nicht. Sie halten dann nur an, und der Lösch-Dialog sagt das vorher. Einmal den Installer erneut ausführen, dann klappt es.
Nach einem Wiederherstellen muss eine deinstallierte Software neu installiert werden. Der Wiederherstellen-Dialog sagt das je Gerät.
Agent Lock hat Vorrang¶
Ist auf dem Gerät Agent Lock aktiv, lehnt der Agent bzw. Collector die Deinstallation ab und ruht stattdessen. Was Vesana auslösen kann, darf ein kompromittiertes Vesana nicht gegen den Host verwenden. Der Lösch-Dialog sagt das vorher, und die Ablehnung wird an Vesana gemeldet. Entfernen geht dann nur am Gerät selbst.
Was der Wiederherstellen-Dialog sagt¶
| Meldung | Bedeutung |
|---|---|
| Kommt von selbst zurück | Der Agent ruht und arbeitet nach dem Wiederherstellen innerhalb von 5 Minuten weiter. |
| Deinstallation wird abgebrochen | „Deinstallieren“ war gewählt, der Agent hat es aber noch nicht abgeholt (Gerät aus). Nach dem Wiederherstellen arbeitet er einfach weiter. |
| Muss neu installiert werden | „Deinstallieren“ war gewählt und das Gerät hat es umgesetzt. Neu einrichten: Host öffnen → Agent einrichten bzw. Collector-Installer. |
| Seit dem Löschen nicht mehr gemeldet | Das Gerät ist aus. Sobald es wieder läuft, kommt der Agent von selbst zurück. |
Ältere Agents und Collectors¶
Vor dieser Version hat sich ein Agent oder Collector bei jedem Deaktivieren
oder Löschen für immer angehalten, weil er eine Tombstone-Datei .deregistered
angelegt hat. Wurde ein Host damals deaktiviert und jetzt reaktiviert, kommt der
Agent nicht von selbst zurück. So startest du ihn wieder:
Den Installations-Einzeiler erneut auszuführen, geht genauso: er räumt die Datei selbst weg. Ein Agent, der die neue Version hat (Auto-Update), legt diese Datei nur noch an, wenn er endgültig gehen soll.