Introduction
Lorsque vous clonez un appareil qui a déjà l'agent Level installé, l'original et le clone partagent le même ID d'agent. Cela crée un conflit — les deux appareils concourent pour la même entrée dans Level, et l'un ou les deux affichent une connectivité erratique. Cet article montre comment faire tourner l'ID d'agent sur l'appareil cloné pour le résoudre.
ℹ️ REMARQUE : Cela n'affecte que les appareils clonés. Réinstaller l'agent sur un appareil existant ne change pas son ID — Level préserve l'ID original lors des réinstallations pour éviter les entrées en double.
Faire tourner l'ID d'agent automatiquement
Le correctif le plus rapide est l'option --new-agent-id drapeau. Il génère un nouveau UUID, met à jour la config, et redémarre l'agent en une seule étape.
Exécutez ceci sur l'appareil cloné :
🖥️ NOTE DE PLATEFORME :
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
Après le redémarrage de l'agent, l'appareil cloné s'enregistrera comme une nouvelle entrée dans Level. L'appareil original n'est pas affecté.
Faire tourner l'ID d'agent manuellement
Si vous ne pouvez pas exécuter le binaire de l'agent directement (par exemple, l'agent est arrêté ou le binaire est inaccessible), vous pouvez modifier l'ID dans la config directement.
⚠️ AVERTISSEMENT : Définissez la valeur à un UUID v4 valide (généré de manière aléatoire). Ne réutilisez pas un ID d'un autre appareil et ne laissez pas le champ vide. Après modification, redémarrez le service Level pour que la modification prenne effet.
🖥️ NOTE DE PLATEFORME :
Windows — Clé de registre :
Chemin :
HKEY_LOCAL_MACHINE\SOFTWARE\LevelNom de la clé :
AgentIDModifiez la valeur à un nouvel UUID.
macOS — Fichier config :
Chemin :
/Library/Application Support/Level/config.yamlNom de la clé :
agent-idRemplacez la valeur existante par un nouvel UUID.
Linux — Fichier config :
Chemin :
/etc/level/config.yamlNom de la clé :
agent-idRemplacez la valeur existante par un nouvel UUID.
Après modification, redémarrez le service Level :
🖥️ NOTE DE PLATEFORME :
Windows :
Restart-Service -Name LevelmacOS :
sudo launchctl kickstart -k system/LevelLinux :
systemctl restart Level
Prévenir cela à l'avenir
Deux options pour les flux de provisionnement basés sur le clonage :
Option 1 — Faire tourner l'UUID après le clonage (recommandé) : Gardez l'agent dans votre image maître et exécutez --new-agent-id dans le cadre de votre étape de provisionnement après clonage (via MDM, script de démarrage, ou RMM). Chaque appareil cloné reçoit un nouvel ID automatiquement au premier démarrage sans intervention manuelle.
Option 2 — Désinstaller avant l'imagerie : Supprimez l'agent Level avant de créer l'image maître, puis installez Level comme étape après clonage. Chaque appareil reçoit un nouvel ID d'agent depuis l'installation.
💡 CONSEIL : Les guides d'installation de Level pour Windows, macOS et Linux incluent des commandes d'installation silencieuse adaptées aux scripts de déploiement et aux flux MDM après clonage.
FAQ
Sur quel appareil dois-je exécuter --new-agent-id — l'original ou le clone ? Exécutez-le sur le clone. L'appareil original a l'ID « correct » qui est déjà enregistré dans Level. La rotation de l'ID du clone l'enregistre en tant que nouvel appareil sans déranger l'original.
Après rotation de l'ID, l'appareil cloné héritera-t-il des groupes, tags et champs personnalisés de l'original ? Non. L'appareil cloné s'enregistre en tant que tout nouvel appareil dans Level. Vous devrez le assigner aux groupes et tags appropriés. Les valeurs des champs personnalisés de l'original ne seront pas reportées.
Puis-je pousser --new-agent-id via Level si les deux appareils s'affichent de manière intermittente ? C'est peu fiable quand deux appareils concourent pour le même ID. L'accès local ou un autre outil distant est plus sûr. Une fois que vous avez fait tourner l'ID sur le clone, les deux appareils auront des connexions stables et séparées.
Comment générer un UUID valide à utiliser pour une rotation d'ID manuelle ? Sur Windows :
[guid]::NewGuid().ToString()dans PowerShell. Sur macOS/Linux :uuidgen. Chacun produit un UUID v4 valide.