KB: problemi di aggiornamento di AES 8.x causati dalla mancanza delle dipendenze runtime .NET 8 e .NET 10

Dettagli della soluzione

Sintomi dopo l'aggiornamento ad AES 8.x

Dopo l'aggiornamento ad AES v8.x, gli utenti hanno segnalato i seguenti sintomi:

• I progetti e l'accesso al server funzionavano correttamente da Altium Designer 25.
• I componenti rimanevano accessibili tramite l'interfaccia web.
• La visualizzazione dei progetti tramite l'interfaccia web di AES non funzionava.
• Attendere e riprovare non risolveva il problema.

L'interfaccia web mostrava il seguente messaggio quando si tentava di visualizzare i progetti:

Gli utenti potrebbero inoltre riscontrare "The service is unavailable. 500: the server isn't responding." quando tentano di accedere al frontend web di AES.

Modifiche alle dipendenze dai runtime introdotte in AES 8.x

A partire da AES 8.x, il server AES richiede che i runtime .NET 8 e .NET 10 siano entrambi installati contemporaneamente sul server.

A partire da AES v8.x:

• Solo una parte dei servizi AES è stata migrata a .NET 10.
• La maggior parte dei servizi AES continua a dipendere da .NET 8.
• La rimozione o la mancata installazione di uno dei due runtime, .NET 8 o .NET 10, può causare errori di avvio dei servizi e problemi al frontend web.

Questo modello di dipendenze è previsto a partire da AES v8.x e sarà modificato nelle versioni future di AES, man mano che verranno migrati altri servizi.

Opzioni di ripristino consigliate

• Installare il runtime .NET 8 più recente insieme a .NET 10 e verificare il funzionamento del server.
• Se i problemi persistono, reinstallare AES per ripristinare automaticamente tutte le dipendenze dai runtime necessarie.
• Creare un backup completo dell'installazione AES esistente prima di procedere alla reinstallazione.

Passaggi per ripristinare il funzionamento di AES

1. Verificare i runtime .NET attualmente installati sul computer che ospita il server AES.
2. Accertarsi che .NET 8 e .NET 10 siano entrambi installati e coesistano sul server.
3. Se manca .NET 8 o .NET 10, installare la versione più recente supportata del runtime .NET mancante.
4. Riavviare i servizi AES interessati, se necessario.
5. Verificare l'accesso al frontend web di AES.
6. Verificare che sia possibile aprire e visualizzare i progetti dall'interfaccia web.
7. Se il problema persiste, creare un backup dell'installazione AES.
8. Reinstallare AES v8.1.3.17 utilizzando la procedura di installazione standard.
9. Consentire al programma di installazione di installare tutte le dipendenze necessarie.
10. Ripristinare i dati dal backup, se necessario.
11. Verificare che il frontend web e le funzioni di visualizzazione dei progetti funzionino normalmente.

Note aggiuntive

• AES 8.x richiede che entrambi i runtime .NET 8 e .NET 10 rimangano installati sul server. L'aggiornamento o la rimozione dei runtime senza verificare i requisiti di AES può causare malfunzionamenti dei servizi, problemi di accesso ai progetti o l'indisponibilità del frontend web.
• Se AES diventa inaccessibile dopo gli aggiornamenti di Windows o .NET, consultare questo articolo della Knowledge Base per ulteriori indicazioni sui problemi di accesso legati ai runtime e sulle considerazioni relative alla compatibilità delle versioni. Questo articolo si applica principalmente alle versioni di AES non supportate interessate dagli aggiornamenti di Windows e .NET. Tuttavia, può essere utile per analizzare sintomi simili legati a modifiche dei runtime o alla disponibilità dei servizi web.

Riferimenti

• Software aggiuntivo installato o configurato durante l'installazione di AES
• Installazione di Altium On-Prem Enterprise Server
• Backup e ripristino dell'installazione