KB: .NET 8 및 .NET 10 런타임 종속성 누락으로 인한 AES 8.x 업그레이드 문제

해결 방법 상세 정보

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부터 적용되는 사항은 다음과 같습니다.

• 일부 AES 서비스만 .NET 10으로 마이그레이션되었습니다.
• 대부분의 AES 서비스는 여전히 .NET 8에 의존합니다.
• .NET 8 또는 .NET 10 중 하나라도 제거하거나 설치하지 않으면 서비스 시작 실패 및 웹 프런트엔드 문제가 발생할 수 있습니다.

이러한 종속성 모델은 AES v8.x부터 적용되는 정상적인 동작이며, 향후 AES 릴리스에서 추가 서비스가 마이그레이션됨에 따라 변경될 예정입니다.

권장 복구 방법

• .NET 10과 함께 최신 .NET 8 런타임을 설치하고 서버가 정상적으로 작동하는지 확인합니다.
• 문제가 지속되면 AES를 다시 설치하여 필요한 모든 런타임 종속성을 자동으로 복원합니다.
• 다시 설치하기 전에 기존 AES 설치 환경의 전체 백업을 생성합니다.

AES 기능 복원 절차

1. AES 서버 컴퓨터에 현재 설치된 .NET 런타임을 확인합니다.
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 요구 사항을 확인하지 않고 런타임을 업데이트하거나 제거하면 서비스 오류, 프로젝트 액세스 문제 또는 웹 프런트엔드 사용 불가 문제가 발생할 수 있습니다.
• Windows 또는 .NET 업데이트 후 AES에 액세스할 수 없게 되면 이 기술 자료 문서에서 런타임 관련 액세스 문제 및 버전 호환성 고려 사항에 대한 추가 지침을 확인하세요. 이 문서는 주로 Windows 및 .NET 업데이트의 영향을 받는, 지원이 종료된 AES 버전에 적용됩니다. 하지만 런타임 변경이나 웹 서비스 가용성과 관련된 유사한 증상을 조사할 때도 도움이 될 수 있습니다.

참고 자료

• AES 설치 중 설치되거나 구성되는 추가 소프트웨어
• Altium On-Prem Enterprise Server 설치
• 설치 환경 백업 및 복원