Al instalar el agente de Atera en un dispositivo Windows, es posible que encuentres los códigos de error 2203, 2502, o 2503. Este artículo te guía paso a paso para resolver estos errores de instalación.
Vuelve a generar el instalador MSI
El paquete MSI podría estar dañado o desactualizado.
Crea un nuevo instalador MSI desde tu cuenta de Atera.
Ejecuta el nuevo instalador en el dispositivo afectado.
Nota: Utiliza siempre el MSI más reciente para asegurar la compatibilidad con tu cuenta de Atera y la configuración del dispositivo.
Verifica los permisos de la carpeta
Estos errores suelen ocurrir cuando Windows no puede acceder a la carpeta C:\Windows\Temp.
Verifica los permisos de la siguiente manera:
Haz clic derecho en C:\Windows\Temp → Propiedades → Seguridad.
Confirma que SYSTEM y Administradores tengan Control total.
Ajusta los permisos si es necesario y vuelve a intentar la instalación.
También puedes corregir los permisos automáticamente ejecutando este script de PowerShell como Administrador:
# Ejecuta este script como Administrador
$folder = "C:\Windows\Temp"
# Tomar posesión
takeown /f $folder /r /d Y
# Restablecer ACLs
icacls $folder /reset /T
# Otorgar control total a SYSTEM
icacls $folder /grant SYSTEM:(OI)(CI)F /T
# Otorgar control total a Administradores
icacls $folder /grant Administrators:(OI)(CI)F /T
# Otorgar derechos de modificación a Usuarios
icacls $folder /grant Users:(OI)(CI)M /T
# Confirmar cambios
icacls $folder
Ejecuta el instalador Curl con permisos de administrador
Asegúrate de ejecutar el instalador con privilegios elevados:
Abre la Consola de comandos como Administrador.
Ejecuta el comando de instalación curl proporcionado por Atera.
Nota: Ejecutar con derechos de administrador garantiza que el instalador pueda escribir archivos y realizar las acciones necesarias en el sistema.
Verifica el .NET Framework
El Agente de Atera requiere .NET Framework 4.5 o superior.
Para comprobar la versión instalada:
Abre PowerShell.
Ejecuta un comando o script para confirmar la versión de .NET Framework.
Si es inferior a 4.5, instala la última versión compatible de .NET Framework y vuelve a intentar la instalación.
Ejecuta el script de limpieza
Instalaciones antiguas o incompletas del agente pueden bloquear nuevas instalaciones.
Sigue los pasos de limpieza de: ¿Cómo elimino el Agente de Atera después de que mi prueba haya expirado?
Reinicia el dispositivo después de la limpieza.
Vuelve a instalar el agente.
Desactiva el proxy geográfico (si es necesario)
Si el problema persiste, desactiva temporalmente cualquier configuración de proxy geográfico o servicios VPN.
En algunas regiones, el uso de proxy puede interferir con la comunicación del instalador y causar estos errores.
