KB : Altium Enterprise Server ne démarre pas lorsqu’Elasticsearch ne parvient pas à s’initialiser
Détails de la solution
Un échec du démarrage d’Elasticsearch empêche l’accès au serveur
Lorsque vous tentez de démarrer le service Elasticsearch depuis la console Windows Services, l’erreur suivante peut s’afficher :
Windows could not start the Elasticsearch service.
Si Elasticsearch ne parvient pas à s’initialiser, Altium On-Prem Enterprise Server ne peut pas terminer son démarrage et les fonctionnalités de recherche sont indisponibles.
L’absence du dossier temporaire peut entraîner un échec du démarrage
L’erreur de démarrage du service n’indique pas de cause précise. Les causes possibles comprennent un espace disque insuffisant, des problèmes d’index de recherche, des problèmes d’autorisations ou un répertoire temporaire inaccessible.
Dans les anciennes versions d’AES, des cas traités par le support ont montré que le dossier temporaire d’Elasticsearch avait disparu à la suite d’un nettoyage, d’une opération de maintenance ou d’un processus de sauvegarde tiers. Le service ne pouvait donc pas s’initialiser correctement au démarrage.
Le répertoire temporaire dépend du compte utilisé pour exécuter le service. Voici un exemple courant :
C:\Users\username\AppData\Local\Temp
Vérifier l’environnement avant d’apporter des modifications
- Consultez les journaux Elasticsearch situés à l’emplacement suivant :
C:\ProgramData\Altium\Altium365Data\logs\ElasticSearch - Identifiez le compte configuré pour exécuter le service Elasticsearch.
- Vérifiez le répertoire temporaire effectivement utilisé par ce compte.
- Vérifiez si un dossier Elasticsearch existe dans le répertoire temporaire.
- Assurez-vous que le compte de service dispose des droits d’accès appropriés au dossier.
- Vérifiez que l’espace disque disponible est suffisant.
- Vérifiez dans le moniteur d’état d’Enterprise Server si des avertissements concernent Elasticsearch ou l’index de recherche.
- Si les journaux indiquent que le dossier temporaire est absent ou inaccessible, recréez-le et redémarrez le service.
- Si vous utilisez une ancienne version d’AES, envisagez une mise à niveau vers une version récente prise en charge.
Procédure pour recréer le dossier temporaire et redémarrer le service
- Ouvrez la console Windows Services et identifiez le compte configuré pour exécuter le service Elasticsearch.
- Accédez au répertoire temporaire associé à ce compte. Par exemple :
C:\Users\username\AppData\Local\Temp - Vérifiez si un dossier nommé Elasticsearch existe.
- Si le dossier n’existe pas, créez un dossier vide nommé Elasticsearch. Il n’est pas nécessaire de restaurer ni de copier des fichiers dans ce dossier.
- Vérifiez que le compte de service Elasticsearch dispose des autorisations suffisantes pour accéder au dossier recréé.
- Dans la console Windows Services, recherchez le service Elasticsearch.
- Sélectionnez Restart. Si le service est arrêté, sélectionnez Start.
- Assurez-vous que l’état du service passe à Running.
- Si le service ne démarre pas, consultez les journaux Elasticsearch à l’emplacement suivant :
C:\ProgramData\Altium\Altium365Data\logs\ElasticSearch
et vérifiez que la structure du répertoire temporaire et ses autorisations sont intactes. - Démarrez AES.
- Vérifiez les points suivants :
- L’état du service Elasticsearch est Running.
- AES démarre correctement.
- Les fonctionnalités de recherche et d’indexation fonctionnent normalement.
Références
- Documentation technique d’Altium On-Prem Enterprise Server
- Sauvegarde et restauration de votre installation