KB: Problemas na atualização do AES 8.x causados pela ausência de dependências dos runtimes .NET 8 e .NET 10

Detalhes da solução

Sintomas após a atualização para o AES 8.x

Após uma atualização para o AES v8.x, os usuários relataram os seguintes sintomas:

• Os projetos e o acesso ao servidor funcionavam corretamente no Altium Designer 25.
• Os componentes continuavam acessíveis pela interface web.
• A visualização de projetos pela interface web do AES falhava.
• Aguardar e tentar novamente não resolveu o problema.

A interface web exibia a seguinte mensagem ao tentar visualizar projetos:

Os usuários também podem se deparar com "The service is unavailable. 500: the server isn't responding." ao tentar acessar o frontend web do AES.

Alterações nas dependências de runtime introduzidas no AES 8.x

A partir do AES 8.x, o servidor AES exige que os runtimes do .NET 8 e do .NET 10 estejam instalados simultaneamente no servidor.

A partir do AES v8.x:

• Apenas parte dos serviços do AES foi migrada para o .NET 10.
• A maioria dos serviços do AES continua dependendo do .NET 8.
• Remover ou não instalar o .NET 8 ou o .NET 10 pode causar falhas na inicialização dos serviços e problemas no frontend web.

Esse modelo de dependências é o comportamento esperado a partir do AES v8.x e está previsto para mudar em versões futuras do AES, à medida que outros serviços forem migrados.

Opções de recuperação recomendadas

• Instale o runtime mais recente do .NET 8 junto com o .NET 10 e verifique o funcionamento do servidor.
• Se os problemas persistirem, reinstale o AES para restaurar automaticamente todas as dependências de runtime necessárias.
• Crie um backup completo da instalação existente do AES antes de realizar uma reinstalação.

Etapas para restaurar o funcionamento do AES

1. Verifique os runtimes do .NET atualmente instalados na máquina do servidor AES.
2. Confirme se o .NET 8 e o .NET 10 estão instalados lado a lado.
3. Se o .NET 8 ou o .NET 10 estiver ausente, instale o runtime mais recente compatível da respectiva versão do .NET.
4. Reinicie os serviços afetados do AES, se necessário.
5. Teste o acesso ao frontend web do AES.
6. Verifique se os projetos podem ser abertos e visualizados pela interface web.
7. Se o problema persistir, crie um backup da instalação do AES.
8. Reinstale o AES v8.1.3.17 usando o procedimento de instalação padrão.
9. Permita que o instalador instale todas as dependências necessárias.
10. Restaure os dados do backup, se necessário.
11. Confirme se o frontend web e as funções de visualização de projetos operam normalmente.

Observações adicionais

• O AES 8.x exige que os runtimes do .NET 8 e do .NET 10 permaneçam instalados no servidor. Atualizar ou remover runtimes sem verificar os requisitos do AES pode resultar em falhas nos serviços, problemas de acesso aos projetos ou indisponibilidade do frontend web.
• Se o AES ficar inacessível após atualizações do Windows ou do .NET, consulte este artigo da Base de Conhecimento para obter orientações adicionais sobre problemas de acesso relacionados aos runtimes e considerações sobre compatibilidade de versões. Esse artigo se aplica principalmente a versões do AES sem suporte afetadas por atualizações do Windows e do .NET. No entanto, ele pode ser útil ao investigar sintomas semelhantes relacionados a alterações nos runtimes ou à disponibilidade dos serviços web.

Referências

• Software adicional instalado ou configurado durante a instalação do AES
• Instalação do Altium On-Prem Enterprise Server
• Backup e restauração da instalação