KB: Probleme beim Upgrade auf AES 8.x aufgrund fehlender Laufzeitabhängigkeiten von .NET 8 und .NET 10

Details zur Lösung

Symptome nach dem Upgrade auf AES 8.x

Nach einem Upgrade auf AES v8.x meldeten Benutzer die folgenden Symptome:

• Projekte und Serverzugriff funktionierten in Altium Designer 25 ordnungsgemäß.
• Bauteile waren weiterhin über die Weboberfläche zugänglich.
• Die Anzeige von Projekten über die AES-Weboberfläche schlug fehl.
• Auch ein erneuter Versuch nach einer Wartezeit behob das Problem nicht.

Beim Versuch, Projekte anzuzeigen, gab die Weboberfläche die folgende Meldung aus:

Beim Versuch, auf das AES-Webfrontend zuzugreifen, kann bei Benutzern auch "The service is unavailable. 500: the server isn't responding." auftreten.

Änderungen an den Laufzeitabhängigkeiten ab AES 8.x

Ab AES 8.x müssen auf dem AES-Server sowohl die .NET 8- als auch die .NET 10-Laufzeitumgebung gleichzeitig installiert sein.

Ab AES v8.x gilt:

• Nur ein Teil der AES-Dienste wurde auf .NET 10 migriert.
• Die meisten AES-Dienste sind weiterhin von .NET 8 abhängig.
• Wenn entweder .NET 8 oder .NET 10 entfernt oder nicht installiert wird, kann dies zu Fehlern beim Starten von Diensten und zu Problemen mit dem Webfrontend führen.

Dieses Abhängigkeitsmodell ist ab AES v8.x vorgesehen und soll sich in zukünftigen AES-Versionen ändern, wenn weitere Dienste migriert werden.

Empfohlene Wiederherstellungsoptionen

• Installieren Sie die neueste .NET 8-Laufzeitumgebung zusätzlich zu .NET 10 und überprüfen Sie die Funktionsfähigkeit des Servers.
• Wenn die Probleme weiterhin bestehen, installieren Sie AES neu, um alle erforderlichen Laufzeitabhängigkeiten automatisch wiederherzustellen.
• Erstellen Sie vor einer Neuinstallation eine vollständige Sicherung der bestehenden AES-Installation.

Schritte zur Wiederherstellung der AES-Funktionalität

1. Überprüfen Sie, welche .NET-Laufzeitumgebungen derzeit auf dem AES-Server installiert sind.
2. Stellen Sie sicher, dass sowohl .NET 8 als auch .NET 10 parallel installiert sind.
3. Falls entweder .NET 8 oder .NET 10 fehlt, installieren Sie die jeweils neueste unterstützte Version der fehlenden .NET-Laufzeitumgebung.
4. Starten Sie bei Bedarf die betroffenen AES-Dienste neu.
5. Testen Sie den Zugriff auf das AES-Webfrontend.
6. Überprüfen Sie, ob Projekte über die Weboberfläche geöffnet und angezeigt werden können.
7. Wenn das Problem weiterhin besteht, erstellen Sie eine Sicherung der AES-Installation.
8. Installieren Sie AES v8.1.3.17 gemäß dem standardmäßigen Installationsverfahren neu.
9. Lassen Sie das Installationsprogramm alle erforderlichen Abhängigkeiten installieren.
10. Stellen Sie bei Bedarf die Daten aus der Sicherung wieder her.
11. Überprüfen Sie, ob das Webfrontend und die Projektanzeige ordnungsgemäß funktionieren.

Zusätzliche Hinweise

• Für AES 8.x müssen sowohl die .NET 8- als auch die .NET 10-Laufzeitumgebung auf dem Server installiert bleiben. Das Aktualisieren oder Entfernen von Laufzeitumgebungen ohne vorherige Prüfung der AES-Anforderungen kann zu Dienstausfällen, Problemen beim Projektzugriff oder zur Nichtverfügbarkeit des Webfrontends führen.
• Wenn AES nach Windows- oder .NET-Updates nicht mehr zugänglich ist, finden Sie in diesem Knowledge-Base-Artikel weitere Hinweise zu laufzeitbedingten Zugriffsproblemen und zur Versionskompatibilität. Dieser Artikel gilt in erster Linie für nicht unterstützte AES-Versionen, die von Windows- und .NET-Updates betroffen sind. Er kann jedoch auch bei der Untersuchung ähnlicher Symptome im Zusammenhang mit Änderungen an Laufzeitumgebungen oder der Verfügbarkeit von Webdiensten hilfreich sein.

Referenzen

• Zusätzliche Software, die während der AES-Installation installiert oder konfiguriert wird
• Installation von Altium On-Prem Enterprise Server
• Sichern & Wiederherstellen der Installation