Files
rust-discovery/deploy/linux/README.md
T
2026-11-18 17:21:12 +01:00

3.1 KiB

Linux-Agent betreiben

Der Linux-Client für x86_64-unknown-linux-gnu meldet sich ausgehend per mTLS am Gerätegateway. Als Systembenutzer rmm-discovery liefert er Heartbeats und Inventar, holt genehmigte Shell-Skripte ab und meldet Ausgabe und Exitcode zurück. Der optionale Root-Helper gehört zur gleichen signierten Releaseversion wie der Agent.

Installation

  1. In der WebUI den Zielkunden wählen, Gerät aufnehmen öffnen und einen Einmalcode erzeugen.
  2. Auf dem x86-64-Linux-Gerät mit systemd und Python 3 den dort angezeigten Linux-Befehl ausführen. Er lädt /install/linux.sh über HTTPS und ruft es mit sudo sh und dem Bootstrap-Ursprung des Servers auf. Den Einmalcode am verdeckten Prompt eingeben.
  3. Für Root-Skripte die Administratoroption der WebUI wählen. Sie ergänzt --enable-admin-scripts. Auf einem bereits eingeschriebenen Gerät lässt sich der Installer mit demselben Ursprung und dieser Option erneut ausführen. Die Geräteidentität bleibt erhalten.
  4. Im Gerätedetail Hostname, Kunde, Agentversion und letzten authentisierten Kontakt kontrollieren. Für einen Root-Auftrag braucht das Gerät den gemeldeten Root-Kontext und eine passende zentrale Geräteregel. Ein MCP-Token benötigt zusätzlich die passenden Rechte für diesen Kunden. MCP-Zugang

Selbstupdate und Diagnose

rmm-discovery-update.timer ruft den Releasebestand nach dem Booten und anschließend alle fünf Minuten mit einer zufälligen Verzögerung von bis zu 20 Sekunden ab. Vor dem Wechsel prüft der Updater das signierte Paket und die Auftragsjournale. Eine neue Generation wird durch den frischen Kontakt des Agenten bestätigt. Scheitert die Aktivierung, wählt der Updater den Vorgänger. Ein über den Installer aktivierter Helper wechselt zusammen mit dem Agenten. Installer und Aktualisierungslogik

Am Gerät prüfen Befehl oder Pfad
Agent und letzter Update-Lauf systemctl status rmm-discovery-agent.service rmm-discovery-update.timer und journalctl -u rmm-discovery-update.service -n 50
Installierter Root-Helper systemctl status rmm-discovery-managed-script-helper.service
Aktive Generation readlink -f /opt/rust-discovery-client/current
Zustand und Identität /var/lib/rmm-discovery gehört dem Dienstkonto. Bei einem Binärwechsel bleiben Gerätedaten, Schlüssel und Journal erhalten.
Tatsächlicher Neustart cat /proc/sys/kernel/random/boot_id vor und nach dem Neustart vergleichen. Anschließend denselben Agenten am Gateway und das Ergebnis eines nachfolgenden Skripts prüfen.

Die Bibliotheksrevision „Linux neu starten“ kündigt den Neustart mit einer Minute Vorlauf an. Eine Datei unter /tmp kann beim Booten gemäß lokaler Systemkonfiguration verschwinden. Für die Beurteilung eines Auftrags zählt die Ausgabe seines konkreten Versuchs. Native MCP-Abnahme

Für einen neuen Release oder eine direkte Entwicklungsbereitstellung den gemeinsamen Entwicklungsweg verwenden.