Configurer OpenSearch sur Managed Flex Server

OpenSearch peut être exploité comme un service propre sur nos Managed Flex Servers. Les instructions suivantes vous montrent comment configurer OpenSearch et le gérer via le Custom Service Control (CSC).

Introduction

OpenSearch est un moteur de recherche open source et une plateforme d’analyse sous licence Apache. Il est issu en 2021 d’un dérivé d’Elasticsearch et est un projet de la Linux Foundation.

Hostpoint met OpenSearch à votre disposition en tant que service auto-géré. Cela signifie que vous devez installer et gérer vous-même l’application sur votre serveur, mais nous vous y aidons avec ce manuel.

Demander l’installation

Pour pouvoir utiliser OpenSearch sur votre serveur Managed Flex, vous devez d’abord nous demander de procéder à l'installation.

Pour ce faire, créez un code de support dans le Control Panel Hostpoint, comme décrit dans ces instructions.

Envoyez ensuite le code de support à notre assistance technique (support@hostpoint.ch) et demandez-nous de configurer OpenSearch sur votre serveur.

Notre assistance technique se chargera alors de configurer pour vous:

• L’installation d’OpenSearch sur votre serveur
• La structure de répertoires sous ~/app/opensearch/ avec les sous-dossiers config, data, logs et tmp
• Les fichiers de configuration jvm.options, log4j2.properties et opensearch.yml dans le dossier ~/app/opensearch/config/
• Les fichiers de configuration sont préconfigurés avec les chemins d’accès corrects pour votre serveur.

Configurer OpenSearch

Créer un service CSC

Créez maintenant un nouveau Custom Service pour OpenSearch avec la commande suivante:

hpservices supervisord add opensearch

Si l’opération s’est déroulée correctement, vous devriez recevoir la réponse suivante:

successfully created dir for opensearch: /home/username/.services/supervisord/opensearch
successfully created dir for opensearch: /home/username/.services/supervisord/opensearch/log
supervisord service config file written: /home/username/.services/supervisord/opensearch/service.conf

Personnaliser service.conf

Un cadre de configuration pour le nouveau service est alors créé dans le fichier ~/.services/supervisord/railstest/service.conf. Pour OpenSearch, quelques légères modifications sont nécessaires.

Ouvrez le fichier avec vim ou un autre éditeur et copiez-collez le contenu suivant tel quel:

[program:opensearch]
command=/usr/local/lib/opensearch/bin/opensearch
autostart=true
stopwaitsecs=10
stdout_logfile=%(ENV_HOME)s/.services/supervisord/opensearch/log/default.log
stdout_logfile_maxbytes=1MB
stdout_logfile_backups=10
stderr_logfile=%(ENV_HOME)s/.services/supervisord/opensearch/log/default.err
stderr_logfile_maxbytes=10MB
stderr_logfile_backups=10
environment=OPENSEARCH_JAVA_HOME="/usr/local",OPENSEARCH_PATH_CONF="%(ENV_HOME)s/app/opensearch/config",JAVA_VERSION=25,OPENSEARCH_TMPDIR="%(ENV_HOME)s/app/opensearch/tmp"

La ligne «environment» contient plusieurs variables d'environnement importantes:

• OPENSEARCH_JAVA_HOME définit le chemin d’accès à l’installation Java.
• OPENSEARCH_PATH_CONF pointe vers votre répertoire de configuration contenant les trois fichiers de configuration.
• JAVA_VERSION indique la version de Java à utiliser.
• OPENSEARCH_TMPDIR définit un répertoire fixe pour les fichiers temporaires. Sans ce paramètre, OpenSearch créerait à chaque redémarrage un nouveau répertoire aléatoire sous /tmp, ce qui entraînerait la création de nombreux répertoires orphelins.

Intégration

supervisorctl update vous permet d’activer la nouvelle configuration pour OpenSearch:

supervisorctl update
opensearch: added process group

Vérifiez ensuite le statut du service à l’aide de la commande suivante:

supervisorctl status opensearch

Pour de plus amples détails sur l’utilisation et les possibilités qui vous sont offertes par le CSC, consultez le manuel du Custom Service Control.

Tester

Testez votre nouvelle instance OpenSearch avec la commande suivante:

curl http://127.0.0.1:9200/

Si tout a été correctement configuré, vous devriez obtenir une réponse JSON avec le nom et la version d’OpenSearch.

Si ce n’est pas le cas, nous vous recommandons de relire les instructions. Si cela ne fonctionne toujours pas, n’hésitez pas à nous contacter.

Veuillez noter les points suivants:

1. Nous ne surveillons pas votre instance OpenSearch et nous ne pouvons donc pas réagir en cas d’incidents ou de plantage.
2. Lors de mises à jour importantes d’OpenSearch, il peut arriver que le service ne redémarre pas automatiquement. Dans ce cas, vous devez redémarrer le service avec la commande supervisorctl restart opensearch.
3. L’instance OpenSearch que vous avez créée ne s’affiche pas dans l’aperçu des serveurs du Control Panel Hostpoint.