KB: Problemas de actualización de AES 8.x causados por la falta de dependencias de los entornos de ejecución de .NET 8 y .NET 10

Detalles de la solución

Síntomas tras actualizar a AES 8.x

Tras una actualización a AES v8.x, los usuarios notificaron los siguientes síntomas:

• Los proyectos y el acceso al servidor funcionaban correctamente desde Altium Designer 25.
• Los componentes seguían siendo accesibles a través de la interfaz web.
• La visualización de proyectos a través de la interfaz web de AES fallaba.
• Esperar y volver a intentarlo no resolvía el problema.

La interfaz web mostraba el siguiente mensaje al intentar visualizar proyectos:

Los usuarios también pueden encontrarse con "The service is unavailable. 500: the server isn't responding." al intentar acceder a la interfaz web de AES.

Cambios en las dependencias de los entornos de ejecución introducidos en AES 8.x

A partir de AES 8.x, el servidor de AES requiere que los entornos de ejecución de .NET 8 y .NET 10 estén instalados simultáneamente en el servidor.

A partir de AES v8.x:

• Solo una parte de los servicios de AES se ha migrado a .NET 10.
• La mayoría de los servicios de AES siguen dependiendo de .NET 8.
• Eliminar o no instalar .NET 8 o .NET 10 puede provocar fallos en el inicio de los servicios y problemas en la interfaz web.

Este modelo de dependencias es el comportamiento previsto a partir de AES v8.x y está previsto que cambie en futuras versiones de AES a medida que se migren más servicios.

Opciones de recuperación recomendadas

• Instale el entorno de ejecución de .NET 8 más reciente junto con .NET 10 y compruebe el funcionamiento del servidor.
• Si los problemas persisten, reinstale AES para restaurar automáticamente todas las dependencias de los entornos de ejecución necesarias.
• Cree una copia de seguridad completa de la instalación existente de AES antes de realizar una reinstalación.

Pasos para restaurar el funcionamiento de AES

1. Compruebe los entornos de ejecución de .NET instalados actualmente en el equipo del servidor de AES.
2. Confirme que tanto .NET 8 como .NET 10 estén instalados en paralelo.
3. Si falta .NET 8 o .NET 10, instale la versión compatible más reciente del entorno de ejecución de .NET correspondiente.
4. Reinicie los servicios de AES afectados si es necesario.
5. Pruebe el acceso a la interfaz web de AES.
6. Compruebe que los proyectos se puedan abrir y visualizar desde la interfaz web.
7. Si el problema persiste, cree una copia de seguridad de la instalación de AES.
8. Reinstale AES v8.1.3.17 siguiendo el procedimiento de instalación estándar.
9. Permita que el instalador instale todas las dependencias necesarias.
10. Restaure los datos desde la copia de seguridad si es necesario.
11. Compruebe que la interfaz web y las funciones de visualización de proyectos funcionen con normalidad.

Notas adicionales

• AES 8.x requiere que los entornos de ejecución de .NET 8 y .NET 10 permanezcan instalados en el servidor. Actualizar o eliminar entornos de ejecución sin comprobar los requisitos de AES puede provocar fallos en los servicios, problemas de acceso a los proyectos o la falta de disponibilidad de la interfaz web.
• Si no se puede acceder a AES después de actualizar Windows o .NET, consulte este artículo de la base de conocimientos para obtener orientación adicional sobre los problemas de acceso relacionados con los entornos de ejecución y las consideraciones de compatibilidad entre versiones. Este artículo se aplica principalmente a versiones de AES sin soporte afectadas por las actualizaciones de Windows y .NET. Sin embargo, puede resultar útil al investigar síntomas similares relacionados con cambios en los entornos de ejecución o con la disponibilidad de los servicios web.

Referencias

• Software adicional instalado o configurado durante la instalación de AES
• Instalación de Altium On-Prem Enterprise Server
• Copia de seguridad y restauración de la instalación