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 mit systemd
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.
Gerätegruppe auswählen (optional)
Wählen Sie eine Gerätegruppe aus, bevor Sie den Installationsbefehl kopieren. Der Installationsschlüssel wird aktualisiert und enthält die Gruppen-ID, damit das Gerät beim ersten Einbuchen 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 Dialogfeld sichtbar ist und neue Geräte mit Ihrem Level-Konto verknüpft. Der Gültigkeitsbereich ist eng gefasst: Wenn er offengelegt wird, kann damit weder auf Ihr Konto noch auf vorhandene Geräte oder die Level-API zugegriffen werden. Das einzige Risiko besteht darin, dass jemand ihn verwenden könnte, um Geräte zu Ihrem Konto hinzuzufügen.
Wenn Sie vermuten, dass Ihr Installationsschlüssel kompromittiert wurde, wenden Sie sich an den Level-Support, um ihn zu erneuern.
ℹ️ HINWEIS: Der Installationsschlüssel spiegelt Ihre Gruppenauswahl in Echtzeit wider. Ohne ausgewählte Gruppe enthält er nur Ihre Kontokennung. Wenn Sie eine Gruppe auswählen, wird die Gruppen-ID angehängt.
Installationsmethoden
Das Dialogfeld enthält zwei Registerkarten für Linux.
Einzeiliger Befehl
Ein einzeiliger Bash-Befehl, der den Agenten herunterlädt und installiert. Dies ist die Standardmethode für die meisten Linux-Deployments und erkennt die Architektur automatisch.
Wählen Sie im Dialogfeld die Einzeiliger Befehl Registerkarte.
Wählen Sie optional eine Gerätegruppe aus.
Kopieren Sie den generierten Befehl.
Öffnen Sie auf dem Zielgerät ein Terminal.
Führen Sie den Befehl aus. Wenn Sie nicht bereits 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.
Installationsprogramm
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 Dialogfeld die Installationsprogramm Registerkarte.
Wählen Sie Ihre Architektur aus dem Dropdown-Menü: x64 oder ARM.
Wählen Sie optional eine Gerätegruppe aus.
Klicken Sie auf Installationsprogramm herunterladen um die Binärdatei herunterzuladen.
Kopieren Sie den im Dialogfeld angezeigten Installationsbefehl.
Führen Sie auf dem Zielgerät den kopierten Befehl mit erhöhten Berechtigungen 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
Dadurch wird 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 aber nicht offiziell unterstützt. Wenn Sie bei 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 dem Ausführen 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 angezeigt wird, lesen Sie Offline-Fehlerbehebung für weitere Schritte.
Häufig gestellte Fragen
Muss ich den Installationsbefehl als root ausführen? Ja, der Agent benötigt erhöhte Berechtigungen für die Installation. Der einzeilige Befehl enthält
sudoautomatisch. Für das manuelle Installationsprogramm führen Sie den Befehl mitsudooder direkt als root.Welche Architektur sollte ich auf der Registerkarte „Installationsprogramm" 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 Methode mit dem einzeiligen Befehl erkennt die Architektur automatisch.
Meine Linux-Distribution steht nicht auf der Unterstützungsliste — funktioniert Level trotzdem? Möglicherweise. Level unterstützt die meisten modernen Distributionen, die systemd verwenden. Wenn Ihre Distribution die Abhängigkeitsanforderungen erfüllt, funktioniert sie möglicherweise einwandfrei — wenden Sie sich bei Problemen an den Level-Support.
Das Gerät wurde installiert, erscheint aber nicht in Level — was ist falsch? Warten Sie 10–15 Sekunden und aktualisieren Sie die Seite. Wenn es immer noch nicht angezeigt wird, ü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 wurde? 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 erneuern.
Kann ich den Agenten auf viele Linux-Geräte gleichzeitig deployen? 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 Geräte ohne Gruppe deployt werden. Überprüfen Sie Arbeitsbereich → Berechtigungen falls Sie die Neues Gerät hinzufügen Schaltfläche.