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 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 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 d'origine à travers les réinstallations pour éviter les entrées en double.
Faire Tourner l'ID d'Agent Automatiquement
Le correctif le plus rapide est le drapeau --new-agent-id. Il génère un nouvel UUID, met à jour la config et redémarre l'agent en une seule étape.
Exécutez ceci sur l'appareil cloné :
🖥️ REMARQUE 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 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 éditer l'ID dans la config directement.
⚠️ AVERTISSEMENT : Définissez la valeur sur un UUID v4 valide (généré aléatoirement). Ne réutilisez pas un ID d'un autre appareil et ne laissez pas le champ vide. Après l'édition, redémarrez le service Level pour que la modification prenne effet.
🖥️ REMARQUE DE PLATEFORME :
Windows — Clé de registre :
Chemin :
HKEY_LOCAL_MACHINE\SOFTWARE\LevelNom de clé :
AgentIDChangez la valeur à un nouvel UUID.
macOS — Fichier de config :
Chemin :
/Library/Application Support/Level/config.yamlNom de clé :
agent-idRemplacez la valeur existante par un nouvel UUID.
Linux — Fichier de config :
Chemin :
/etc/level/config.yamlNom de clé :
agent-idRemplacez la valeur existante par un nouvel UUID.
Après l'édition, redémarrez le service Level :
🖥️ REMARQUE DE PLATEFORME :
Windows :
Restart-Service -Name LevelmacOS :
sudo launchctl kickstart -k system/LevelLinux :
systemctl restart Level
Prévenir Cela dans l'Avenir
Deux options pour les flux de provisionnement basés sur le clonage :
Option 1 — Faire tourner l'UUID post-clone (recommandé) : Gardez l'agent dans votre image maître et exécutez --new-agent-id dans le cadre de votre étape de provisionnement post-clone (via MDM, script de démarrage ou RMM). Chaque appareil cloné obtient un nouvel ID automatiquement au premier démarrage sans aucune intervention manuelle.
Option 2 — Désinstaller avant l'imagerie : Supprimez l'agent Level avant de créer l'image maître, puis installez Level dans le cadre d'une étape post-clone. Chaque appareil obtient un nouvel ID 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 post-clone MDM.
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 a l'ID « correct » qui est déjà enregistré dans Level. Faire tourner l'ID du clone l'enregistre comme un nouvel appareil sans déranger l'original.
Après avoir fait tourner l'ID, l'appareil cloné héritera-t-il des groupes, des balises et des champs personnalisés de l'original ? Non. L'appareil cloné s'enregistre en tant que nouvel appareil dans Level. Vous devrez l'assigner aux groupes et balises appropriés. Les valeurs de champs personnalisés de l'original ne seront pas reportées.
Puis-je pousser --new-agent-id à travers Level si les deux appareils s'affichent par intermittence ? C'est peu fiable lorsque deux appareils se disputent le même ID. L'accès local ou un autre outil de télécommande 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. L'un ou l'autre produit un UUID v4 valide.