Collega e configura 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')"

Imposta l'utente e la password di Elasticsearch

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>')"

Aggiungi certificato a Zammad

Aggiungilo tramite console Rails

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.

Costruisci/Ricostruisci l'indice di ricerca

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]

Impostazioni opzionali

We collected some useful settings you may want to apply. For further information please have a look at Elastic's documentation.

Namespacing dell'indice

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')"

Regole di indicizzazione allegati file

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

By default, the Asciifold feature of Elasticsearch is enabled. This can be useful if you deal with text which includes diacritics and/or umlauts.

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

Risoluzione problemi

TIP

Troubleshooting unsuccessful or issue not described?

If you can't solve your issue using the provided troubleshooting steps or can't find your particular issue described here, feel free to ask the community for technical assistance.

Dati mancanti dall'interfaccia web / Dati di ricerca mancanti o incompleti

A commonly reported issue is data missing from the Web-UI. This could be tickets, articles, users or anything else indexed by Elasticsearch and can be caused by missing or incomplete indexes.

If you are experiencing this issue and installed Elasticsearch according to our installation guide, please follow these steps to make sure Elasticsearch is working correctly.

Passo 1: Verifica che Elasticsearch sia in esecuzione

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

If this fails, your Elasticsearch installation is probably broken. Try completely purging and reinstalling Elasticsearch according to our installation guide.

Passo 2: Verifica che Zammad possa accedere a Elasticsearch e ricostruisci gli indici

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.

If this fails or throws an error, there might be something else wrong with your installation. Make sure you followed the complete Elasticsearch set up and integration procedure according to our installation guide.

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.