KB: Sự cố nâng cấp AES 8.x do thiếu các thành phần phụ thuộc của môi trường chạy .NET 8 và .NET 10

Chi tiết giải pháp

Các triệu chứng sau khi nâng cấp lên AES 8.x

Sau khi nâng cấp lên AES v8.x, người dùng đã báo cáo các triệu chứng sau:

• Các dự án và việc truy cập máy chủ vẫn hoạt động bình thường từ Altium Designer 25.
• Vẫn có thể truy cập các linh kiện qua giao diện web.
• Không thể xem dự án qua giao diện web của AES.
• Chờ rồi thử lại vẫn không khắc phục được sự cố.

Giao diện web hiển thị thông báo sau khi người dùng cố gắng xem dự án:

Người dùng cũng có thể gặp "The service is unavailable. 500: the server isn't responding." khi cố gắng truy cập giao diện web của AES.

Những thay đổi về thành phần phụ thuộc thời gian chạy trong AES 8.x

Kể từ AES 8.x, máy chủ AES yêu cầu cài đặt đồng thời cả môi trường thời gian chạy .NET 8 và .NET 10 trên máy chủ.

Kể từ AES v8.x:

• Chỉ một phần các dịch vụ AES đã được chuyển sang .NET 10.
• Phần lớn các dịch vụ AES vẫn phụ thuộc vào .NET 8.
• Việc gỡ bỏ hoặc không cài đặt .NET 8 hay .NET 10 có thể khiến các dịch vụ không khởi động được và gây ra sự cố với giao diện web.

Mô hình phụ thuộc này là hoạt động theo thiết kế kể từ AES v8.x và dự kiến sẽ thay đổi trong các bản phát hành AES tương lai khi có thêm dịch vụ được chuyển đổi.

Các phương án khôi phục được khuyến nghị

• Cài đặt môi trường thời gian chạy .NET 8 mới nhất song song với .NET 10 và kiểm tra hoạt động của máy chủ.
• Nếu sự cố vẫn tiếp diễn, hãy cài đặt lại AES để tự động khôi phục tất cả các thành phần phụ thuộc thời gian chạy cần thiết.
• Tạo bản sao lưu đầy đủ của bản cài đặt AES hiện có trước khi cài đặt lại.

Các bước khôi phục hoạt động của AES

1. Kiểm tra các môi trường thời gian chạy .NET hiện được cài đặt trên máy chủ AES.
2. Xác nhận rằng cả .NET 8 và .NET 10 đều được cài đặt song song.
3. Nếu thiếu .NET 8 hoặc .NET 10, hãy cài đặt môi trường thời gian chạy .NET tương ứng mới nhất được hỗ trợ.
4. Khởi động lại các dịch vụ AES bị ảnh hưởng nếu cần.
5. Kiểm tra khả năng truy cập giao diện web của AES.
6. Xác minh rằng có thể mở và xem các dự án từ giao diện web.
7. Nếu sự cố vẫn tiếp diễn, hãy tạo bản sao lưu của bản cài đặt AES.
8. Cài đặt lại AES v8.1.3.17 theo quy trình cài đặt tiêu chuẩn.
9. Cho phép trình cài đặt cài đặt tất cả các thành phần phụ thuộc cần thiết.
10. Khôi phục dữ liệu từ bản sao lưu nếu cần.
11. Xác nhận rằng giao diện web và chức năng xem dự án hoạt động bình thường.

Lưu ý bổ sung

• AES 8.x yêu cầu duy trì cài đặt cả môi trường thời gian chạy .NET 8 và .NET 10 trên máy chủ. Việc cập nhật hoặc gỡ bỏ các môi trường thời gian chạy mà không kiểm tra yêu cầu của AES có thể khiến dịch vụ gặp lỗi, gây sự cố khi truy cập dự án hoặc khiến giao diện web không khả dụng.
• Nếu không thể truy cập AES sau khi cập nhật Windows hoặc .NET, hãy tham khảo bài viết này trong Cơ sở kiến thức để được hướng dẫn thêm về các sự cố truy cập liên quan đến môi trường thời gian chạy và những lưu ý về khả năng tương thích phiên bản. Bài viết này chủ yếu áp dụng cho các phiên bản AES không còn được hỗ trợ bị ảnh hưởng bởi các bản cập nhật Windows và .NET. Tuy nhiên, bài viết cũng có thể hữu ích khi tìm hiểu các triệu chứng tương tự liên quan đến thay đổi môi trường thời gian chạy hoặc tình trạng khả dụng của dịch vụ web.

Tài liệu tham khảo

• Phần mềm bổ sung được cài đặt hoặc cấu hình trong quá trình cài đặt AES
• Cài đặt Altium On-Prem Enterprise Server
• Sao lưu & khôi phục bản cài đặt