Durante l'installazione dell'agente Atera su un dispositivo Windows, potresti incontrare i codici di errore 2203, 2502 o 2503. Questo articolo ti guida nei passaggi per risolvere questi errori di installazione.
Rigenera il programma di installazione MSI
Il pacchetto MSI potrebbe essere corrotto o non aggiornato.
Crea un nuovo programma di installazione MSI dal tuo account Atera.
Esegui il nuovo programma di installazione sul dispositivo interessato.
Nota: Usa sempre l’ultima versione generata dell’MSI per garantire la compatibilità con il tuo account Atera e le impostazioni del dispositivo.
Controlla i permessi della cartella
Questi errori si verificano spesso quando Windows non riesce ad accedere alla cartella C:\Windows\Temp.
Verifica i permessi come segue:
Fai clic con il tasto destro su C:\Windows\Temp → Proprietà → Sicurezza.
Verifica che SYSTEM e Administrators abbiano Controllo completo.
Modifica i permessi se necessario, poi riprova l’installazione.
Puoi anche correggere automaticamente i permessi eseguendo questo script PowerShell come Amministratore:
# Esegui questo script come Amministratore
$folder = "C:\Windows\Temp"
# Prendi la proprietà
takeown /f $folder /r /d Y
# Reimposta gli ACL
icacls $folder /reset /T
# Concedi a SYSTEM il controllo completo
icacls $folder /grant SYSTEM:(OI)(CI)F /T
# Concedi agli Administrators il controllo completo
icacls $folder /grant Administrators:(OI)(CI)F /T
# Concedi agli Users i diritti di modifica
icacls $folder /grant Users:(OI)(CI)M /T
# Conferma le modifiche
icacls $folder
Esegui l’installer Curl con i diritti di amministratore
Assicurati che il programma di installazione venga eseguito con privilegi elevati:
Apri il Prompt dei comandi come Amministratore.
Esegui il comando di installazione curl fornito da Atera.
Nota: L’esecuzione come amministratore garantisce che il programma di installazione possa scrivere file ed eseguire le azioni di sistema necessarie.
Verifica il .NET Framework
L’agente Atera richiede .NET Framework 4.5 o superiore.
Per controllare la versione installata:
Apri PowerShell.
Esegui un comando o uno script per confermare la versione del .NET Framework.
Se è inferiore alla 4.5, installa l’ultima versione supportata di .NET Framework e riprova l’installazione.
Esegui lo script di pulizia
Vecchie installazioni dell’agente o installazioni incomplete possono bloccare le nuove installazioni.
Segui i passaggi di pulizia da: Come rimuovere l’agente Atera dopo la scadenza della prova?
Riavvia il dispositivo dopo la pulizia.
Reinstalla l’agente.
Disattiva il Geo Proxy (se necessario)
Se il problema persiste, disattiva temporaneamente eventuali impostazioni di geo proxy o servizi VPN.
In alcune regioni, il routing tramite proxy può interferire con la comunicazione dell’installer e causare questi errori.
