Connect and configure Elasticsearch

TIP

Are you tired of complex setup, configuration, backup and update tasks? Let us handle this stuff for you! 🚀

The easiest and often most cost-effective way to operate Zammad is our cloud service. Give it a try with a free trial instance!

Questa guida ti mostra come collegare Zammad con Elasticsearch.

Collega Elasticsearch con Zammad

Imposta l'URL di Elasticsearch

Imposta l'indirizzo del server Elasticsearch; adattalo al tuo scenario.

zammad run rails r "Setting.set('es_url', 'https://localhost:9200')"

Set the Elasticsearch user and password

zammad run rails r "Setting.set('es_user', 'elastic')"

Sostituisci <password> con quella ottenuta durante l'installazione di Elasticsearch. Nel caso.

zammad run rails r "Setting.set('es_password', '<password>')"

Add certificate to Zammad

Add it via rails console

Nel caso tu stia installando un nuovo Zammad e non abbia seguito la procedura guidata.

sudo cat /etc/elasticsearch/certs/http_ca.crt | zammad run rails r "SSLCertificate.create!

Aggiungilo tramite interfaccia

Nel caso tu abbia già un Zammad in esecuzione e configurato, puoi aggiungere il certificato in Z

sudo cat /etc/elasticsearch/certs/http_ca.crt

Per aggiungerlo in Zammad, carica il file del certificato o incolla il contenuto nella finestra di dialogo.

Build/rebuild the searchindex

Senza specificare i core CPU da usare:

zammad run rake zammad:searchindex:rebuild

Specificando i core CPU da usare (esempio 8):

zammad run rake zammad:searchindex:rebuild[8]

Optional settings

Abbiamo raccolto alcune impostazioni utili che potresti voler applicare. Per ulteriori informazioni, consulta la documentazione di Elastic.

Index namespacing

Utile quando si collegano più servizi o istanze Zammad a un singolo server Elasticsearch.

zammad run rails r "Setting.set('es_index', Socket.gethostname.downcase + '_zammad')"

File-attachment indexing rules

Zammad supporta la ricerca negli allegati file, il che significa che Elasticsearch deve indicizzarli.

I file con queste estensioni non verranno indicizzati:

zammad run rails r "Setting.set('es_attachment_ignore',\
[ '.png', '.jpg', '.jpeg', '.mpeg

I file più grandi di questa dimensione (in MB) non verranno indicizzati:

zammad run rails r "Setting.set('es_attachment_max_size_in_mb', 50)"

Asciifold

Per impostazione predefinita, la funzionalità Asciifold di Elasticsearch è abilitata. Questo può essere utile se lavori con testo che include diacritici e/o umlaut.

Nel caso tu abbia bisogno di una ricerca più precisa, puoi disattivarla tramite console Rails.

Risoluzione problemi

TIP

Risoluzione dei problemi non riuscita o problema non descritto?

Se non riesci a risolvere il tuo problema utilizzando i passaggi di troubleshooting forniti o non trovi il tuo problema specifico descritto qui, sentiti libero di chiedere alla community assistenza tecnica.

Data missing from the web-UI / search data missing or incomplete

Un problema comunemente segnalato è la mancanza di dati nella Web-UI. Questo può riguardare ticket, articoli, utenti o qualsiasi altra cosa indicizzata da Elasticsearch e può essere causato da indici mancanti o incompleti.

Se stai riscontrando questo problema e hai installato Elasticsearch seguendo la nostra guida di installazione, segui questi passaggi per assicurarti che Elasticsearch funzioni correttamente.

Step 1: Verify Elasticsearch is running

sudo systemctl status elasticsearch

Questo dovrebbe produrre qualcosa come quanto segue, assicurati che dica `Active: active (runnin

● elasticsearch.service - Elasticsearch
   Loaded: loaded (/lib/systemd/system/elasticsear

Altrimenti, prova a riavviarlo e controlla di nuovo:

sudo systemctl restart elasticsearch

WARNING

Se questo fallisce, è probabile che la tua installazione di Elasticsearch sia danneggiata. Prova a eliminare completamente e reinstallare Elasticsearch seguendo la nostra guida di installazione.

Step 2: Verify Zammad can access Elasticsearch and rebuild the indexes

Forza Zammad a eliminare e ricostruire gli indici Elasticsearch, opzionalmente con un numero specificato.

zammad run rake zammad:searchindex:rebuild[8]

Questo dovrebbe iniziare a ricostruire gli indici e visualizzare il suo progresso:

Dropping indexes... done.
Deleting pipeline... done.
Creating indexes... done.
Creating pi

A seconda delle prestazioni del sistema e della quantità di dati, questo può richiedere del tempo per completarsi.

Se questo fallisce o genera un errore, potrebbe esserci qualcos’altro che non va nella tua installazione. Assicurati di aver seguito l’intera procedura di configurazione e integrazione di Elasticsearch secondo la nostra guida di installazione.

TIP

In molte situazioni in cui non hai successo con i passaggi sopra, potresti voler controllare i log di Elasticsearch.

Dopo aver completato questi passaggi, dovresti aver verificato che la tua installazione Elasticsearch sia.