Introducción
Cuando clona un dispositivo que ya tiene instalado el agente Level, tanto el original como el clon comparten el mismo ID de agente. Esto causa un conflicto: los dos dispositivos compiten por la misma entrada en Level, y uno o ambos mostrarán conectividad errática. Este artículo muestra cómo rotar el ID de agente en el dispositivo clonado para resolverlo.
ℹ️ NOTA: Esto solo afecta a dispositivos clonados. Reinstalar el agente en un dispositivo existente no cambia su ID: Level preserva el ID original durante las reinstalaciones para evitar entradas duplicadas.
Rotar el ID de agente automáticamente
La solución más rápida es la bandera --new-agent-id. Genera un nuevo UUID, actualiza la configuración e reinicia el agente en un solo paso.
Ejecute esto en el dispositivo clonado :
🖥️ NOTA DE PLATAFORMA:
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
Después de reiniciar el agente, el dispositivo clonado se registrará como una nueva entrada en Level. El dispositivo original no se ve afectado.
Rotar el ID de agente manualmente
Si no puede ejecutar el binario del agente directamente (por ejemplo, el agente está detenido o el binario es inaccesible), puede editar el ID directamente en la configuración.
⚠️ ADVERTENCIA: Establezca el valor en un UUID v4 válido (generado aleatoriamente). No reutilice un ID de otro dispositivo y no deje el campo en blanco. Después de editar, reinicie el servicio Level para que el cambio surta efecto.
🖥️ NOTA DE PLATAFORMA:
Windows — Clave de registro:
Ruta:
HKEY_LOCAL_MACHINE\SOFTWARE\LevelNombre de la clave:
AgentIDCambie el valor a un nuevo UUID.
macOS — Archivo de configuración:
Ruta:
/Library/Application Support/Level/config.yamlNombre de la clave:
agent-idReemplace el valor existente con un nuevo UUID.
Linux — Archivo de configuración:
Ruta:
/etc/level/config.yamlNombre de la clave:
agent-idReemplace el valor existente con un nuevo UUID.
Después de editar, reinicie el servicio Level:
🖥️ NOTA DE PLATAFORMA:
Windows:
Restart-Service -Name LevelmacOS:
sudo launchctl kickstart -k system/LevelLinux:
systemctl restart Level
Prevenir esto en el futuro
Dos opciones para flujos de aprovisionamiento basados en clonación:
Opción 1: Rotar el UUID después del clonado (recomendado): Mantenga el agente en su imagen maestra y ejecute --new-agent-id como parte de su paso de aprovisionamiento posterior al clonado (a través de MDM, script de inicio o RMM). Cada dispositivo clonado obtiene un nuevo ID automáticamente al primer arranque sin intervención manual.
Opción 2: Desinstalar antes de la obtención de imágenes: Elimine el agente Level antes de crear la imagen maestra, luego instale Level como paso posterior al clonado. Cada dispositivo obtiene un nuevo ID de agente de la instalación.
💡 CONSEJO: Las guías de instalación de Level para Windows, macOS y Linux incluyen comandos de instalación silenciosa adecuados para scripts de implementación y flujos MDM posteriores al clonado.
FAQ
¿En qué dispositivo debo ejecutar --new-agent-id — el original o el clon? Ejecútelo en el clon. El dispositivo original tiene el ID "correcto" que ya está registrado en Level. Rotar el ID del clon lo registra como un nuevo dispositivo sin perturbar el original.
Después de rotar el ID, ¿el dispositivo clonado heredará los grupos, etiquetas y campos personalizados del original? No. El dispositivo clonado se registra como un dispositivo completamente nuevo en Level. Deberá asignarlo a los grupos y etiquetas apropiados. Los valores de campo personalizado del original no se trasladarán.
¿Puedo insertar --new-agent-id a través de Level si ambos dispositivos se muestran intermitentemente? Es poco confiable cuando dos dispositivos compiten por el mismo ID. El acceso local u otra herramienta remota es más seguro. Una vez que haya rotado el ID en el clon, ambos dispositivos tendrán conexiones estables y separadas.
¿Cómo genero un UUID válido para usar en una rotación de ID manual? En Windows:
[guid]::NewGuid().ToString()en PowerShell. En macOS/Linux:uuidgen. Ambos producen un UUID v4 válido.