KB: O Altium Enterprise Server não inicia quando o Elasticsearch não consegue inicializar

Detalhes da solução

Falha na inicialização do Elasticsearch impede o acesso ao servidor

Ao tentar iniciar o serviço Elasticsearch pelo console Windows Services, o seguinte erro pode ser exibido:

Windows could not start the Elasticsearch service.

Quando o Elasticsearch não consegue inicializar, o Altium On-Prem Enterprise Server não consegue concluir a inicialização, e as funcionalidades relacionadas à pesquisa ficam indisponíveis.

A ausência da pasta temporária pode causar falha na inicialização

O erro de inicialização do serviço não indica uma causa raiz específica. As possíveis causas incluem pouco espaço em disco, problemas no índice de pesquisa, problemas de permissão ou um diretório temporário inacessível.

Em versões mais antigas do AES, casos de suporte mostraram que a pasta temporária do Elasticsearch estava ausente após uma limpeza, uma atividade de manutenção ou um processo de backup de terceiros. Como resultado, o serviço não conseguia inicializar corretamente.

O diretório temporário depende da conta usada para executar o serviço. Um exemplo comum é:

C:\Users\username\AppData\Local\Temp

Verifique o ambiente antes de fazer alterações

• Analise os logs do Elasticsearch localizados em:
  C:\ProgramData\Altium\Altium365Data\logs\ElasticSearch
• Identifique a conta configurada para executar o serviço Elasticsearch.
• Verifique o diretório temporário efetivamente usado por essa conta.
• Verifique se existe uma pasta Elasticsearch no diretório temporário.
• Confirme se a conta do serviço tem o acesso adequado à pasta.
• Verifique se há espaço suficiente em disco.
• Verifique se há avisos relacionados ao Elasticsearch ou ao índice de pesquisa no Monitor de Integridade do Enterprise Server.
• Se os logs indicarem que a pasta temporária está ausente ou inacessível, recrie a pasta e reinicie o serviço.
• Considere atualizar para uma versão atual e compatível do AES se estiver usando uma versão mais antiga.

Etapas para recriar a pasta temporária e reiniciar o serviço

1. Abra o console Windows Services e identifique a conta configurada para executar o serviço Elasticsearch.
2. Acesse o diretório temporário associado a essa conta. Por exemplo:
   C:\Users\username\AppData\Local\Temp
3. Verifique se existe uma pasta chamada Elasticsearch.
4. Se a pasta não existir, crie uma nova pasta vazia chamada Elasticsearch. Não é necessário restaurar nem copiar arquivos para a pasta.
5. Verifique se a conta do serviço Elasticsearch tem permissões suficientes para acessar a pasta recriada.
6. No console Windows Services, localize o serviço Elasticsearch.
7. Selecione Restart. Se o serviço estiver parado, selecione Start.
8. Confirme se o status do serviço muda para Running.
9. Se o serviço não iniciar, analise os logs do Elasticsearch em:
   C:\ProgramData\Altium\Altium365Data\logs\ElasticSearch
   e verifique se a estrutura e as permissões do diretório temporário estão intactas.
10. Inicie o AES.
11. Verifique o seguinte:
    • O status do serviço Elasticsearch é Running.
    • O AES inicia corretamente.
    • As funcionalidades de pesquisa e indexação operam normalmente.

Referências

• Documentação técnica do Altium On-Prem Enterprise Server
• Backup e restauração da sua instalação

Artigos relacionados

• KB: Resolver problemas causados após a atualização do servidor local e a migração de dados
• KB: Resolver o erro de índice de pesquisa incompleto do Enterprise Server causado por pouco espaço em disco