База знаний: проблемы при обновлении AES 8.x из-за отсутствия необходимых сред выполнения .NET 8 и .NET 10

Подробное описание решения

Симптомы после обновления до AES 8.x

После обновления до AES v8.x пользователи сообщали о следующих симптомах:

• Доступ к проектам и серверу из Altium Designer 25 работал корректно.
• Компоненты оставались доступны через веб-интерфейс.
• Просмотр проектов через веб-интерфейс AES не работал.
• Повторные попытки после ожидания не устраняли проблему.

При попытке просмотра проектов в веб-интерфейсе отображалось следующее сообщение:

При попытке доступа к веб-интерфейсу AES пользователи также могут столкнуться с "The service is unavailable. 500: the server isn't responding.".

Изменения зависимостей от сред выполнения в AES 8.x

Начиная с AES 8.x, для работы сервера AES на нем должны быть одновременно установлены среды выполнения .NET 8 и .NET 10.

Начиная с AES v8.x:

• На .NET 10 переведена только часть служб AES.
• Большинство служб AES по-прежнему зависят от .NET 8.
• Удаление или отсутствие .NET 8 либо .NET 10 может привести к сбоям запуска служб и проблемам с веб-интерфейсом.

Такая модель зависимостей является штатной начиная с AES v8.x. Планируется изменить ее в будущих выпусках AES по мере перевода остальных служб.

Рекомендуемые варианты восстановления

• Установите последнюю версию среды выполнения .NET 8 параллельно с .NET 10 и проверьте работоспособность сервера.
• Если проблемы сохраняются, переустановите AES, чтобы автоматически восстановить все необходимые зависимости от сред выполнения.
• Перед переустановкой создайте полную резервную копию существующей установки AES.

Порядок восстановления работоспособности AES

1. Проверьте, какие среды выполнения .NET установлены на сервере AES.
2. Убедитесь, что .NET 8 и .NET 10 установлены параллельно.
3. Если .NET 8 или .NET 10 отсутствует, установите последнюю поддерживаемую версию соответствующей среды выполнения .NET.
4. При необходимости перезапустите затронутые службы AES.
5. Проверьте доступ к веб-интерфейсу AES.
6. Убедитесь, что проекты можно открывать и просматривать через веб-интерфейс.
7. Если проблема сохраняется, создайте резервную копию установки AES.
8. Переустановите AES v8.1.3.17, следуя стандартной процедуре установки.
9. Разрешите программе установки установить все необходимые зависимости.
10. При необходимости восстановите данные из резервной копии.
11. Убедитесь, что веб-интерфейс и функции просмотра проектов работают нормально.

Дополнительные примечания

• Для работы AES 8.x на сервере должны оставаться установленными обе среды выполнения: .NET 8 и .NET 10. Обновление или удаление сред выполнения без проверки требований AES может привести к сбоям служб, проблемам с доступом к проектам или недоступности веб-интерфейса.
• Если AES становится недоступен после обновлений Windows или .NET, ознакомьтесь с этой статьей базы знаний, в которой приведены дополнительные рекомендации по устранению проблем доступа, связанных со средами выполнения, и сведения о совместимости версий. Эта статья в первую очередь относится к неподдерживаемым версиям AES, на работу которых повлияли обновления Windows и .NET. Однако она также может быть полезна при исследовании похожих симптомов, связанных с изменениями сред выполнения или доступностью веб-служб.

Ссылки

• Дополнительное программное обеспечение, устанавливаемое или настраиваемое при установке AES
• Установка Altium On-Prem Enterprise Server
• Резервное копирование и восстановление установки