KB : Problèmes de mise à niveau d’AES 8.x dus à l’absence des dépendances d’exécution .NET 8 et .NET 10

Détails de la solution

Symptômes après la mise à niveau vers AES 8.x

Après une mise à niveau vers AES v8.x, les utilisateurs ont signalé les symptômes suivants :

• Les projets et l’accès au serveur fonctionnaient correctement depuis Altium Designer 25.
• Les composants restaient accessibles via l’interface web.
• La consultation des projets via l’interface web d’AES échouait.
• Une nouvelle tentative après un délai d’attente ne résolvait pas le problème.

L’interface web affichait le message suivant lors des tentatives de consultation des projets :

Les utilisateurs peuvent également rencontrer "The service is unavailable. 500: the server isn't responding." lorsqu’ils tentent d’accéder à l’interface web d’AES.

Modifications des dépendances aux environnements d’exécution introduites dans AES 8.x

À partir d’AES 8.x, les environnements d’exécution .NET 8 et .NET 10 doivent tous deux être installés simultanément sur le serveur AES.

À partir d’AES v8.x :

• Seule une partie des services AES a été migrée vers .NET 10.
• La majorité des services AES continue de dépendre de .NET 8.
• La suppression ou l’absence d’installation de l’un des deux environnements d’exécution, .NET 8 ou .NET 10, peut entraîner des échecs de démarrage des services et des problèmes d’interface web.

Ce modèle de dépendances correspond au fonctionnement prévu à partir d’AES v8.x et devrait évoluer dans les prochaines versions d’AES à mesure que d’autres services seront migrés.

Options de rétablissement recommandées

• Installez la dernière version de l’environnement d’exécution .NET 8 aux côtés de .NET 10 et vérifiez le bon fonctionnement du serveur.
• Si les problèmes persistent, réinstallez AES pour restaurer automatiquement toutes les dépendances requises aux environnements d’exécution.
• Créez une sauvegarde complète de l’installation AES existante avant de procéder à une réinstallation.

Étapes pour rétablir le fonctionnement d’AES

1. Vérifiez les environnements d’exécution .NET actuellement installés sur la machine hébergeant le serveur AES.
2. Confirmez que .NET 8 et .NET 10 sont tous deux installés côte à côte.
3. Si .NET 8 ou .NET 10 est manquant, installez la dernière version prise en charge de l’environnement d’exécution .NET correspondant.
4. Redémarrez les services AES concernés si nécessaire.
5. Testez l’accès à l’interface web d’AES.
6. Vérifiez que les projets peuvent être ouverts et consultés depuis l’interface web.
7. Si le problème persiste, créez une sauvegarde de l’installation AES.
8. Réinstallez AES v8.1.3.17 en suivant la procédure d’installation standard.
9. Laissez le programme d’installation installer toutes les dépendances requises.
10. Restaurez les données à partir de la sauvegarde si nécessaire.
11. Vérifiez que l’interface web et les fonctions de consultation des projets fonctionnent normalement.

Remarques complémentaires

• AES 8.x exige que les environnements d’exécution .NET 8 et .NET 10 restent tous deux installés sur le serveur. La mise à jour ou la suppression d’environnements d’exécution sans vérification préalable des exigences d’AES peut entraîner des défaillances des services, des problèmes d’accès aux projets ou une indisponibilité de l’interface web.
• Si AES devient inaccessible après des mises à jour de Windows ou de .NET, consultez cet article de la base de connaissances pour obtenir des conseils supplémentaires sur les problèmes d’accès liés aux environnements d’exécution et les points à prendre en compte concernant la compatibilité des versions. Cet article s’applique principalement aux versions d’AES non prises en charge affectées par les mises à jour de Windows et de .NET. Il peut toutefois être utile pour analyser des symptômes similaires liés à des modifications des environnements d’exécution ou à la disponibilité des services web.

Références

• Logiciels supplémentaires installés ou configurés lors de l’installation d’AES
• Installation d’Altium On-Prem Enterprise Server
• Sauvegarde et restauration de l’installation