Introduction
Lorsque vous clonez un appareil sur lequel l'agent Level est déjà installé, l'original et le clone partagent le même identifiant d'agent. Cela entraîne un conflit — les deux appareils se disputent la même entrée dans Level, et l'un ou les deux afficheront une connectivité erratique. Cet article explique comment faire tourner l'identifiant de l'agent sur l'appareil cloné pour résoudre ce problème.
ℹ️ REMARQUE : Cela n'affecte que les appareils clonés. La réinstallation de l'agent sur un appareil existant ne change pas son identifiant — Level conserve l'identifiant d'origine lors des réinstallations afin d'éviter les entrées en double.
Faire tourner l'identifiant de l'agent automatiquement
La solution la plus rapide est le --new-agent-id flag. Il génère un nouveau UUID, met à jour la configuration et redémarre l'agent en une seule étape.
Exécutez ceci sur l'appareil cloné appareil :
🖥️ 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é sera enregistré comme une nouvelle entrée dans Level. L'appareil d'origine n'est pas affecté.
Faire tourner l'identifiant de l'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'identifiant directement dans la configuration.
⚠️ AVERTISSEMENT : Définissez la valeur sur un UUID v4 valide (généré aléatoirement). Ne réutilisez pas un identifiant d'un autre appareil et ne laissez pas le champ vide. Après modification, redémarrez le service Level pour que le changement prenne effet.
🖥️ NOTE DE PLATEFORME :
Windows — Clé de registre :
Chemin :
HKEY_LOCAL_MACHINE\SOFTWARE\LevelNom de la clé :
AgentIDChangez la valeur pour un nouveau UUID.
macOS — Fichier de configuration :
Chemin :
/Library/Application Support/Level/config.yamlNom de la clé :
agent-idRemplacez la valeur existante par un nouveau UUID.
Linux — Fichier de configuration :
Chemin :
/etc/level/config.yamlNom de la clé :
agent-idRemplacez la valeur existante par un nouveau 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 ce problème à l'avenir
Deux options pour les workflows de provisionnement basés sur le clonage :
Option 1 — Faire tourner l'UUID après le clonage (recommandé) : Conservez l'agent dans votre image maître et exécutez --new-agent-id dans votre étape de provisionnement post-clonage (via MDM, script de démarrage ou RMM). Chaque appareil cloné obtient automatiquement un nouvel identifiant au premier démarrage, sans aucune intervention manuelle.
Option 2 — Désinstaller avant la création de l'image : Retirez l'agent Level avant de créer l'image maître, puis installez Level lors de l'étape post-clonage. Chaque appareil obtient un nouvel identifiant d'agent dès 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 workflows MDM post-clonage.
FAQ
Sur quel appareil dois-je exécuter --new-agent-id — l'original ou le clone ? Exécutez-la sur le clone. L'appareil d'origine possède l'identifiant «correct» déjà enregistré dans Level. Faire tourner l'identifiant du clone l'enregistre comme un nouvel appareil sans perturber l'original.
Après avoir fait tourner l'identifiant, l'appareil cloné héritera-t-il des groupes, tags et champs personnalisés de l'original ? Non. L'appareil cloné est enregistré comme un tout nouvel appareil dans Level. Vous devrez l'affecter aux groupes et aux tags appropriés. Les valeurs de champs personnalisés de l'original ne seront pas transférées.
Puis-je pousser --new-agent-id via Level si les deux appareils s'affichent de façon intermittente ? C'est peu fiable lorsque deux appareils se disputent le même identifiant. L'accès local ou un autre outil distant est plus sûr. Une fois l'identifiant du clone modifié, les deux appareils disposeront de connexions stables et distinctes.
Comment générer un UUID valide pour une rotation manuelle d'identifiant ? Sur Windows :
[guid]::NewGuid().ToString()dans PowerShell. Sur macOS/Linux :uuidgen. L'un ou l'autre produit un UUID v4 valide.