Zum Inhalt

Befehle am Host — vesana-agent und vesana-collector

Agent und Collector bringen eigene Befehle mit, die man direkt auf dem überwachten Rechner ausführt. Diese Seite listet alle. Ein unbekannter Befehl gibt die Liste ebenfalls aus (vesana-agent hilfe o. ä.).

Agent unter Windows (PowerShell)

Eine PowerShell als Administrator öffnen. Das Programm liegt in C:\Program Files\Vesana Agent\, jeder Befehl hat die Form:

& "$env:ProgramFiles\Vesana Agent\vesana-agent.exe" <befehl>

Prüfen und einrichten:

  • version — installierte Agent-Version anzeigen.
  • test — alle vom Server konfigurierten Checks einmal ausführen, jedes Ergebnis live anzeigen und an den Server schicken. Erste Wahl nach der Installation oder wenn ein Check „wartet auf Daten". Details: Checks sofort testen.
  • reconfigure — Server-URL und/oder Token in der config.yaml neu eintragen (fragt beides ab, leer = unverändert). Danach den Dienst neu starten: Restart-Service VesanaAgent.
  • run — den Agent im Vordergrund laufen lassen; Fehler erscheinen direkt in der Konsole. Zum Beenden Strg+C.

Agent Lock (Host vor Vesana schützen, siehe Agent Lock):

  • lock — Agent Lock einschalten; übernimmt auf Nachfrage, was gerade läuft (--yes ohne Rückfrage, --no-takeover gibt nichts frei).
  • lock status — zeigen, was freigegeben ist und was wartet (--show zeigt die wartenden Inhalte).
  • lock approve — wartende Einträge ansehen und einzeln freigeben.
  • lock approve --all — alle wartenden Einträge auf einmal freigeben (mit --yes ohne Rückfrage).
  • lock approve --sha256 <fingerabdruck> — genau diesen Inhalt freigeben (für viele Server per GPO/Remoting).
  • lock prune — Freigaben entfernen, die nichts mehr verwendet.
  • lock reset --yes — kaputte Freigabe-Datei neu anlegen (Sperre bleibt an, Freigaben sind weg).
  • unlock — Agent Lock ausschalten (Freigaben bleiben gespeichert).

Dienst verwalten:

  • install — den Windows-Dienst VesanaAgent registrieren (legt bei Bedarf eine Vorlage der config.yaml an).
  • upgrade — Dienst stoppen, auf die aktuelle vesana-agent.exe umstellen und wieder starten (nach einem Binary-Tausch von Hand).
  • start / stop — den Dienst starten bzw. stoppen; der Befehl wartet, bis der Dienst wirklich läuft bzw. steht.
  • status — Zustand des Dienstes anzeigen.
  • uninstall — den Dienst stoppen und entfernen. Die vollständige Deinstallation steht unter Agent/Collector entfernen.

Die Windows-Bordmittel funktionieren genauso: Get-Service VesanaAgent*, Start-Service VesanaAgent, Stop-Service VesanaAgent, Restart-Service VesanaAgent. Das Log liegt in C:\ProgramData\Vesana\Agent\agent.log, z. B. Get-Content "$env:ProgramData\Vesana\Agent\agent.log" -Tail 50.

Agent unter Linux

Als root bzw. mit sudo:

sudo vesana-agent <befehl>
  • version, test, reconfigure, run — wie unter Windows. Nach reconfigure: sudo systemctl restart vesana-agent.
  • lock, lock status, lock approve [--all | --sha256 <fp>], lock prune, lock reset --yes, unlock — wie unter Windows.

Den Dienst steuert unter Linux systemd, nicht der Agent: sudo systemctl start|stop|restart|status vesana-agent, Log mit sudo journalctl -u vesana-agent -f. install, start, stop, status und uninstall gibt es nur unter Windows.

Optionen für alle Agent-Befehle

  • --config <pfad> — andere config.yaml verwenden (Standard: Windows C:\ProgramData\Vesana\Agent\config.yaml, Linux /etc/vesana-agent/config.yaml).
  • --state-dir <pfad> und --service-name <name> — nur für einen zweiten Agent auf demselben Rechner, z. B. --service-name VesanaAgent-Zweite status.

Collector (Linux)

Der Dienst läuft aus /opt/vesana-collector/vesana-collector. Diese Datei und ihr Ordner gehören root; das Dienstkonto, unter dem auch Scripts aus Vesana laufen, kann sie nicht ersetzen. Dieselbe Datei bedient die Befehle am Host (der Installer erneuert sie bei jedem Lauf; das Selbst-Update tauscht sie über einen Root-Helfer, siehe Collector):

  • version — Version dieser Kopie anzeigen.
  • reconfigure — Server-URL und/oder API-Key in /etc/vesana/collector.env neu eintragen, als Dienstkonto: sudo -u vesana-collector /opt/vesana-collector/vesana-collector reconfigure; danach sudo systemctl restart vesana-collector.
  • lock … / unlock — Agent Lock, dieselben Unterbefehle wie beim Agent: sudo /opt/vesana-collector/vesana-collector lock ….

Dienst und Log: sudo systemctl start|stop|restart|status vesana-collector, sudo journalctl -u vesana-collector -f. Der Aktive Collector auf dem Vesana-Server läuft (Dienst vesana-active-collector) wie seine Befehle am Host aus /opt/vesana-active-collector/vesana-active-collector.

Was es am Host nicht gibt

Hosts deaktivieren, Wartungsfenster, Checks anlegen oder Schwellwerte ändern geht nur in Vesana selbst. Umgekehrt lässt sich Agent Lock nur am Host ein- und ausschalten — Vesana zeigt den Stand nur an.