Configurare OpenSearch su Managed Flex Server

Sui nostri Managed Flex Server è possibile gestire OpenSearch come servizio separato. Le seguenti istruzioni spiegano come impostare OpenSearch e gestirlo tramite il Custom Service Control (CSC).

Introduzione

OpenSearch è un motore di ricerca open source e piattaforma di analisi sotto licenza Apache. Nato nel 2021 da un derivato di Elasticsearch, è un progetto della Linux Foundation.

Hostpoint mette a Sua disposizione OpenSearch come cosiddetto Self-Managed-Service: ciò significa che dovrà installare e gestire l’applicazione autonomamente sul Suo server, ma Le forniamo supporto attraverso questa guida.

Richiedere l’installazione

Per poter utilizzare OpenSearch sul Suo Managed Flex Server, deve prima richiederne l’installazione presso di noi.

A tal fine è sufficiente creare un codice di assistenza nel Pannello di controllo Hostpoint, come descritto in queste istruzioni.

Dopodiché, inviare il codice di assistenza al nostro supporto tecnico (support@hostpoint.ch) e ci chieda di configurare OpenSearch sul Suo server.

Il nostro supporto tecnico provvederà quindi a configurare per Lei quanto segue:

• L’installazione di OpenSearch sul Suo server
• La struttura delle directory in ~/app/opensearch/ con le sottodirectory config, data, logs e tmp
• I file di configurazione jvm.options, log4j2.properties e opensearch.yml nella cartella ~/app/opensearch/config/
• I file di configurazione sono preconfigurati con i percorsi corretti per il Suo server.

Configurare OpenSearch

Creare il CSC Service

Crei un nuovo Custom Service per OpenSearch con il seguente comando:

hpservices supervisord add opensearch

Se l’operazione va a buon fine dovrebbe ricevere la seguente risposta:

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

Modificare service.conf

Nel file ~/.services/supervisord/opensearch/service.conf viene creato uno schema di configurazione per il nuovo servizio. Per OpenSearch è necessario apportare alcune lievi modifiche.

Apra il file con vim o un altro editor e copi il seguente contenuto parola per parola:

[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 riga environment contiene diverse variabili d'ambiente importanti:

• OPENSEARCH_JAVA_HOME specifica il percorso dell’installazione Java.
• OPENSEARCH_PATH_CONF indica la directory di configurazione contenente i tre file di configurazione.
• JAVA_VERSION specifica la versione di Java da utilizzare.
• OPENSEARCH_TMPDIR definisce una directory fissa per i file temporanei. Senza questa impostazione, OpenSearch creerebbe una nuova directory casuale in /tmp ad ogni riavvio, il che porterebbe alla creazione di numerose directory orfane.

Integrazione

Con supervisorctl update può attivare una nuova configurazione per OpenSearch:

supervisorctl update
opensearch: added process group

Controlli quindi lo stato del servizio con il seguente comando:

supervisorctl status opensearch

Per informazioni più dettagliate sull’uso e sulle possibilità a Sua disposizione con il CSC può fare riferimento alla guida al Custom Service Control.

Prova

Provi la nuova istanza OpenSearch con il seguente comando:

curl http://127.0.0.1:9200/

Se tutto è stato configurato correttamente, dovrebbe ottenere una risposta JSON con il nome e la versione OpenSearch.

In caso contrario, Le consigliamo di rileggere le istruzioni. Se il problema persiste, non esiti a contattarci.

La invitiamo a tenere presente quanto segue:

1. Noi non monitoriamo la Sua istanza OpenSearch, pertanto purtroppo non possiamo reagire in caso di errori o crash.
2. In caso di grandi aggiornamenti di OpenSearch, potrebbe accadere che il servizio non si riavvii automaticamente. In questo caso è necessario riavviare il servizio usando il comando supervisorctl restart opensearch.
3. L’istanza OpenSearch da Lei creata autonomamente non viene visualizzata nel Pannello di controllo di Hostpoint nella panoramica del server.