KB: Problemy z aktualizacją AES 8.x spowodowane brakiem wymaganych środowisk uruchomieniowych .NET 8 i .NET 10

Szczegóły rozwiązania

Objawy po aktualizacji do AES 8.x

Po aktualizacji do AES v8.x użytkownicy zgłaszali następujące objawy:

• Dostęp do projektów i serwera z poziomu Altium Designer 25 działał prawidłowo.
• Komponenty pozostawały dostępne przez interfejs internetowy.
• Wyświetlanie projektów w interfejsie internetowym AES nie działało.
• Ponowienie próby po odczekaniu nie rozwiązywało problemu.

Podczas próby wyświetlenia projektów w interfejsie internetowym pojawiał się następujący komunikat:

Użytkownicy mogą również napotkać "The service is unavailable. 500: the server isn't responding." podczas próby uzyskania dostępu do interfejsu internetowego AES.

Zmiany zależności od środowisk uruchomieniowych wprowadzone w AES 8.x

Począwszy od AES 8.x, serwer AES wymaga jednoczesnej instalacji na serwerze środowisk uruchomieniowych .NET 8 i .NET 10.

Od wersji AES v8.x:

• Tylko część usług AES została zmigrowana do .NET 10.
• Większość usług AES nadal zależy od .NET 8.
• Usunięcie lub niezainstalowanie któregokolwiek ze środowisk — .NET 8 lub .NET 10 — może powodować błędy uruchamiania usług i problemy z interfejsem internetowym.

Ten model zależności jest zamierzony od wersji AES v8.x. Jego zmiana jest planowana w przyszłych wydaniach AES wraz z migracją kolejnych usług.

Zalecane sposoby przywrócenia działania

• Zainstaluj najnowsze środowisko uruchomieniowe .NET 8 obok .NET 10 i sprawdź działanie serwera.
• Jeśli problemy nadal występują, zainstaluj ponownie AES, aby automatycznie przywrócić wszystkie wymagane zależności środowisk uruchomieniowych.
• Przed ponowną instalacją utwórz pełną kopię zapasową istniejącej instalacji AES.

Kroki przywracania działania AES

1. Sprawdź, jakie środowiska uruchomieniowe .NET są obecnie zainstalowane na komputerze serwera AES.
2. Potwierdź, że środowiska .NET 8 i .NET 10 są zainstalowane równolegle.
3. Jeśli brakuje środowiska .NET 8 lub .NET 10, zainstaluj najnowszą obsługiwaną wersję brakującego środowiska uruchomieniowego .NET.
4. W razie potrzeby uruchom ponownie usługi AES, których dotyczy problem.
5. Przetestuj dostęp do interfejsu internetowego AES.
6. Sprawdź, czy można otwierać i wyświetlać projekty w interfejsie internetowym.
7. Jeśli problem nadal występuje, utwórz kopię zapasową instalacji AES.
8. Zainstaluj ponownie AES v8.1.3.17, korzystając ze standardowej procedury instalacji.
9. Zezwól instalatorowi na zainstalowanie wszystkich wymaganych zależności.
10. W razie potrzeby przywróć dane z kopii zapasowej.
11. Sprawdź, czy interfejs internetowy i funkcje wyświetlania projektów działają prawidłowo.

Dodatkowe uwagi

• AES 8.x wymaga, aby oba środowiska uruchomieniowe — .NET 8 i .NET 10 — pozostawały zainstalowane na serwerze. Aktualizowanie lub usuwanie środowisk uruchomieniowych bez sprawdzenia wymagań AES może spowodować awarie usług, problemy z dostępem do projektów lub niedostępność interfejsu internetowego.
• Jeśli AES stanie się niedostępny po aktualizacjach systemu Windows lub .NET, zapoznaj się z tym artykułem bazy wiedzy, aby uzyskać dodatkowe wskazówki dotyczące problemów z dostępem związanych ze środowiskami uruchomieniowymi oraz zgodności wersji. Artykuł ten dotyczy przede wszystkim nieobsługiwanych wersji AES, na które wpływają aktualizacje systemu Windows i .NET. Może jednak być pomocny podczas badania podobnych objawów związanych ze zmianami środowisk uruchomieniowych lub dostępnością usług internetowych.

Materiały referencyjne

• Dodatkowe oprogramowanie instalowane lub konfigurowane podczas instalacji AES
• Instalacja Altium On-Prem Enterprise Server
• Tworzenie kopii zapasowej i przywracanie instalacji