Einführung
Der Level-Agent ist ein schlanker Hintergrunddienst, der sich bei Ihrem Konto anmeldet und Fernüberwachung, Automatisierung und Verwaltung für ein Linux-Gerät ermöglicht. Die Installation erfolgt mit einem einzigen Befehl, der als Root oder mit sudo ausgeführt wird.
⚙️ VORAUSSETZUNGEN
Ein Level-Konto mit der Berechtigung, Geräte hinzuzufügen
Root-Zugriff oder sudo auf dem Zielgerät
Eine unterstützte Linux-Distribution, die systemd ausführt
Erforderliche Pakete:
curl,bash,ca-certificates,sudo,dbus(oder eine UUID in/etc/machine-id)
🎬 VIDEO
Linux-Installation
Klicken Sie auf Neues Gerät hinzufügen in der oberen rechten Ecke der Geräteliste Seite. Wählen Sie im Betriebssystem-Selektor Linux.
Eine Gerätegruppe auswählen (Optional)
Wählen Sie eine Gerätegruppe aus, bevor Sie den Installationsbefehl kopieren. Der Installationsschlüssel wird aktualisiert, um die Gruppen-ID einzuschließen, sodass das Gerät beim ersten Check-in in der richtigen Gruppe landet.
Wenn Sie diesen Schritt überspringen, landet das Gerät in Ohne Gruppe — Sie können es danach verschieben.
Der Installationsschlüssel
Jede Linux-Installationsmethode verwendet einen Installationsschlüssel — ein kurzes Token, das im Modal sichtbar ist und neue Geräte mit Ihrem Level-Konto verknüpft. Er ist eng begrenzt: Wenn er offengelegt wird, kann er nicht auf Ihr Konto, vorhandene Geräte oder die Level-API zugreifen. Das einzige Risiko besteht darin, dass jemand ihn verwenden könnte, um Geräte zu Ihrem Konto hinzuzufügen.
Wenn Sie glauben, dass Ihr Installationsschlüssel kompromittiert wurde, wenden Sie sich an den Level-Support, um ihn zu rotieren.
ℹ️ HINWEIS: Der Installationsschlüssel spiegelt Ihre Gruppenauswahl in Echtzeit wider. Ohne ausgewählte Gruppe enthält er nur Ihre Kontokennung. Wählen Sie eine Gruppe aus, wird die ID der Gruppe angehängt.
Installationsmethoden
Das Modal hat zwei Tabs für Linux.
Einzeiliger Befehl
Ein einzeiliger Bash-Befehl, der den Agent herunterlädt und installiert. Dies ist die Standardmethode für die meisten Linux-Installationen und erkennt die Architektur automatisch.
Wählen Sie im Modal den Einzeiliger Befehl Tab.
Optional eine Gerätegruppe auswählen.
Den generierten Befehl kopieren.
Öffnen Sie auf dem Zielgerät ein Terminal.
Führen Sie den Befehl aus. Wenn Sie noch kein Root sind, enthält der Befehl
sudo— Sie werden nach Ihrem Passwort gefragt.
Das Gerät erscheint in Ihrer Geräteliste innerhalb von 5–10 Sekunden nach Abschluss der Installation.
Installer
Lädt eine architekturspezifische Binärdatei herunter und installiert sie über die Befehlszeile. Verwenden Sie diese Methode, wenn Sie die Architektur explizit angeben müssen oder einen manuellen Installationsprozess bevorzugen.
Wählen Sie im Modal den Installer Tab.
Wählen Sie Ihre Architektur aus dem Dropdown-Menü: x64 oder ARM.
Optional eine Gerätegruppe auswählen.
Klicken Sie auf Installer herunterladen um die Binärdatei herunterzuladen.
Kopieren Sie den im Modal angezeigten Installationsbefehl.
Führen Sie auf dem Zielgerät den kopierten Befehl mit erhöhten Rechten aus.
Der Befehl macht die Binärdatei ausführbar und führt die Installation durch, wobei das Gerät mithilfe des eingebetteten Installationsschlüssels bei Ihrem Konto registriert wird.
Erzwungene Installation (Erweitert)
Wenn eine frühere Level-Installation veraltete Dateien hinterlassen hat, verwenden Sie den forceInstall URL-Parameter, um eine saubere Überschreibung zu erzwingen.
Navigieren Sie zu:
https://app.level.io/devices?forceInstall=true
Dies fügt LEVEL_FORCE_INSTALL=true zum generierten einzeiligen Befehl.
⚠️ WARNUNG: Die erzwungene Installation überschreibt jede vorhandene Level-Agent-Konfiguration auf dem Gerät. Verwenden Sie diese Option nur, wenn eine Standardinstallation fehlschlägt oder der Level-Support Sie dazu anweist.
Systemanforderungen
Unterstützte Distributionen
Distribution | Mindestversion |
AlmaLinux | Aktuell stabil |
Arch Linux | Aktuell stabil |
CentOS | 8 |
Debian | 10 |
Fedora | 36 |
Linux Mint | 20 |
Photon OS (VMware) | Aktuell stabil |
Raspbian (Raspberry Pi OS) | Aktuell stabil |
Red Hat Enterprise Linux (RHEL) | 8 |
Rocky Linux | 8 |
Sangoma Linux | Aktuell stabil |
Ubuntu | 20.04 LTS |
ℹ️ HINWEIS: Andere Distributionen funktionieren möglicherweise, werden jedoch nicht offiziell unterstützt. Wenn Sie auf einer nicht aufgeführten Distribution auf Probleme stoßen, wenden Sie sich an den Level-Support.
Erforderliche Abhängigkeiten
Die folgenden Pakete müssen auf dem Zielsystem vor der Installation vorhanden sein:
sudosystemd(für die Dienstverwaltung)dbusoder eine UUID in/etc/machine-idcurlca-certificatesbash
Die meisten unterstützten Distributionen enthalten diese standardmäßig. Bei minimalen Installationen sollten Sie dies vor der Ausführung des Level-Installationsbefehls überprüfen.
Speicherorte
Pfad | Zweck |
| Agent-Binärdatei |
| Agent-Daten |
Nach der Installation
Das Gerät erscheint in Ihrer Geräteliste innerhalb von 5–10 Sekunden und beginnt innerhalb weniger Minuten mit der Erfassung des Hardware-Inventars.
Wenn das Gerät nicht erscheint, lesen Sie Offline-Fehlerbehebung für die nächsten Schritte.
FAQ
Muss ich den Installationsbefehl als Root ausführen? Ja, der Agent benötigt erhöhte Rechte für die Installation. Der einzeilige Befehl enthält
sudoautomatisch. Führen Sie für den manuellen Installer den Befehl mitsudooder direkt als Root.Welche Architektur soll ich im Installer-Tab auswählen? Wählen Sie x64 für Standard-64-Bit-Intel/AMD-Systeme und ARM für ARM-basierte Geräte (einschließlich Raspberry Pi). Die einzeilige Befehlsmethode erkennt die Architektur automatisch.
Meine Linux-Distribution steht nicht auf der unterstützten Liste — wird Level trotzdem funktionieren? Möglicherweise. Level unterstützt die meisten modernen Distributionen, die systemd ausführen. Wenn Ihre Distribution die Abhängigkeitsanforderungen erfüllt, funktioniert es möglicherweise problemlos — wenden Sie sich an den Level-Support, wenn Sie auf Probleme stoßen.
Das Gerät wurde installiert, wird aber in Level nicht angezeigt — was stimmt nicht? Warten Sie 10–15 Sekunden und aktualisieren Sie die Seite. Wenn das Gerät immer noch nicht erscheint, überprüfen Sie, ob systemd ausgeführt wird und alle erforderlichen Abhängigkeiten (
curl,dbus, usw.) während der Installation vorhanden waren. Siehe Offline-Fehlerbehebung für weitere Schritte.Was ist zu tun, wenn mein Installationsschlüssel kompromittiert ist? Der Installationsschlüssel kann nicht auf Ihr Konto, vorhandene Geräte oder die Level-API zugreifen. Das einzige Risiko besteht darin, dass jemand Geräte zu Ihrem Konto hinzufügt. Wenden Sie sich bei Bedarf an den Level-Support, um den Schlüssel zu rotieren.
Kann ich den Agent auf viele Linux-Geräte gleichzeitig installieren? Ja — verwenden Sie den einzeiligen Befehl mit Ihren vorhandenen Tools (Ansible, Puppet, Chef, Bash über SSH usw.).
Wer kann Geräte zu Level hinzufügen? Jeder Techniker mit der Berechtigung, die Zielgerätegruppe zu verwalten, oder jeder Techniker, wenn er in „Ohne Gruppe" installiert wird. Überprüfen Sie Workspace → Permissions wenn Sie die Neues Gerät hinzufügen Schaltfläche.