Einführung
Wenn Sie ein Gerät klonen, auf dem der Level-Agent bereits installiert ist, teilen das Original und der Klon dieselbe Agent-ID. Dies verursacht einen Konflikt — die beiden Geräte konkurrieren um denselben Eintrag in Level, und eines oder beide zeigen eine erratische Konnektivität. Dieser Artikel zeigt, wie Sie die Agent-ID auf dem geklonten Gerät rotieren, um das Problem zu beheben.
ℹ️ HINWEIS: Dies wirkt sich nur auf geklonte Geräte aus. Das Neuinstallieren des Agenten auf einem vorhandenen Gerät ändert seine ID nicht — Level behält die ursprüngliche ID während Neuinstallationen bei, um doppelte Einträge zu verhindern.
Agent-ID automatisch rotieren
Die schnellste Lösung ist das --new-agent-id Flag. Es generiert eine neue UUID, aktualisiert die Konfiguration und startet den Agenten in einem Schritt neu.
Führen Sie dies auf dem geklonten Gerät aus:
🖥️ PLATTFORMHINWEIS:
Windows:
& 'C:\Program Files\Level\level.exe' --new-agent-idmacOS:
sudo /usr/local/bin/level --new-agent-idLinux:
sudo /usr/local/bin/level --new-agent-id
Nach dem Neustart des Agenten wird das geklonte Gerät als neuer Eintrag in Level registriert. Das ursprüngliche Gerät ist nicht betroffen.
Agent-ID manuell rotieren
Wenn Sie die Agent-Binärdatei nicht direkt ausführen können (z. B. wenn der Agent beendet ist oder die Binärdatei nicht zugänglich ist), können Sie die ID direkt in der Konfiguration bearbeiten.
⚠️ WARNUNG: Setzen Sie den Wert auf eine gültige UUID v4 (zufällig generiert). Verwenden Sie nicht die ID eines anderen Geräts und lassen Sie das Feld nicht leer. Nach dem Bearbeiten starten Sie den Level-Dienst neu, damit die Änderung wirksam wird.
🖥️ PLATTFORMHINWEIS:
Windows — Registrierungsschlüssel:
Pfad:
HKEY_LOCAL_MACHINE\SOFTWARE\LevelSchlüsselname:
AgentIDÄndern Sie den Wert auf eine neue UUID.
macOS — Konfigurationsdatei:
Pfad:
/Library/Application Support/Level/config.yamlSchlüsselname:
agent-idErsetzen Sie den vorhandenen Wert durch eine neue UUID.
Linux — Konfigurationsdatei:
Pfad:
/etc/level/config.yamlSchlüsselname:
agent-idErsetzen Sie den vorhandenen Wert durch eine neue UUID.
Nach dem Bearbeiten starten Sie den Level-Dienst neu:
🖥️ PLATTFORMHINWEIS:
Windows:
Restart-Service -Name LevelmacOS:
sudo launchctl kickstart -k system/LevelLinux:
systemctl restart Level
Dies in Zukunft verhindern
Zwei Optionen für auf Klonen basierte Bereitstellungsworkflows:
Option 1 — UUID nach dem Klonen rotieren (empfohlen): Behalten Sie den Agenten in Ihrem Master-Image und führen Sie --new-agent-id als Teil Ihres Post-Clone-Bereitstellungsschritts aus (über MDM, Startskript oder RMM). Jedes geklonte Gerät erhält automatisch beim ersten Start eine neue ID ohne manuelle Intervention.
Option 2 — Vor dem Imaging deinstallieren: Entfernen Sie den Level-Agent vor dem Erstellen des Master-Images, und installieren Sie dann Level als Post-Clone-Schritt. Jedes Gerät erhält eine neue Agent-ID aus der Installation.
💡 TIPP: Die Level-Installationsanleitungen für Windows, macOS und Linux enthalten Silent-Install-Befehle, die sich für Bereitstellungsskripte und Post-Clone-Workflows mit MDM eignen.
FAQ
Auf welchem Gerät sollte ich --new-agent-id ausführen — dem Original oder dem Klon? Führen Sie es auf dem Klon aus. Das ursprüngliche Gerät hat die "korrekte" ID, die bereits in Level registriert ist. Das Rotieren der Klon-ID registriert ihn als neues Gerät, ohne das Original zu beeinträchtigen.
Nach dem Rotieren der ID, wird das geklonte Gerät die Gruppen, Tags und benutzerdefinierten Felder des Originals erben? Nein. Das geklonte Gerät wird als völlig neues Gerät in Level registriert. Sie müssen es den entsprechenden Gruppen und Tags zuweisen. Alle benutzerdefinierten Feldwerte vom Original werden nicht übernommen.
Kann ich --new-agent-id über Level pushen, wenn beide Geräte intermittierend angezeigt werden? Das ist unzuverlässig, wenn zwei Geräte um dieselbe ID konkurrieren. Lokaler Zugriff oder ein anderes Remote-Tool ist sicherer. Sobald Sie die ID auf dem Klon rotiert haben, haben beide Geräte stabile, separate Verbindungen.
Wie generiere ich eine gültige UUID für eine manuelle ID-Rotation? Auf Windows:
[guid]::NewGuid().ToString()in PowerShell. Auf macOS/Linux:uuidgen. Beides erzeugt eine gültige UUID v4.