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 provoque 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 pivoter l'identifiant d'agent sur l'appareil cloné pour résoudre ce problème.
ℹ️ REMARQUE : Cela ne concerne que les appareils clonés. La réinstallation de l'agent sur un appareil existant ne modifie pas son identifiant — Level préserve l'identifiant d'origine lors des réinstallations pour éviter les entrées en double.
Faire pivoter l'identifiant d'agent automatiquement
La solution la plus rapide est le --new-agent-id indicateur. Il génère un nouvel 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é s'enregistrera comme une nouvelle entrée dans Level. L'appareil d'origine n'est pas affecté.
Faire pivoter l'identifiant 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'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 la modification prenne effet.
🖥️ NOTE DE PLATEFORME :
Windows — Clé de registre :
Chemin :
HKEY_LOCAL_MACHINE\SOFTWARE\LevelNom de la clé :
AgentIDRemplacez la valeur par un nouvel UUID.
macOS — Fichier de configuration :
Chemin :
/Library/Application Support/Level/config.yamlNom de la clé :
agent-idRemplacez la valeur existante par un nouvel UUID.
Linux — Fichier de configuration :
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 ce problème à l'avenir
Deux options pour les flux de travail de provisionnement basés sur le clonage :
Option 1 — Faire pivoter l'UUID après le clonage (recommandé) : Conservez l'agent dans votre image maître et exécutez --new-agent-id dans le cadre de 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 : Supprimez 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 à partir de 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 de travail MDM post-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 d'origine possède l'identifiant «correct» déjà enregistré dans Level. Faire pivoter l'identifiant du clone l'enregistre comme un nouvel appareil sans perturber l'original.
Après avoir fait pivoter l'identifiant, l'appareil cloné héritera-t-il des groupes, des étiquettes et des champs personnalisés de l'original ? Non. L'appareil cloné s'enregistre comme un tout nouvel appareil dans Level. Vous devrez l'affecter aux groupes et aux étiquettes appropriés. Les valeurs de champs personnalisés de l'original ne seront pas transférées.
Puis-je envoyer --new-agent-id via Level si les deux appareils apparaissent par intermittence ? 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 pivoté, les deux appareils disposeront de connexions stables et distinctes.
Comment générer un UUID valide à utiliser 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.