---
url: https://next.zammad.org/it/tutorials/connect-config-elasticsearch.md
---

# 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](https://zammad.com/en/pricing){target=\_blank}. 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.

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

### Set the Elasticsearch user and password

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

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

```sh
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.

```sh
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

```sh
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:

```sh
zammad run rake zammad:searchindex:rebuild
```

Specificando i core CPU da usare (esempio 8):

```sh
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](https://www.elastic.co/guide/en/elasticsearch/reference/current/index.html){target=\_blank}.

### Index namespacing

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

```sh
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:

```sh
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:

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

### Asciifold

Per impostazione predefinita, la [funzionalità Asciifold di
Elasticsearch](https://www.elastic.co/docs/reference/text-analysis/analysis-asciifolding-tokenfilter){target=\_blank}
è abilitata. Questo può essere utile se lavori con testo che include
diacritici e/o umlaut.

In case you need a more exact search, you can turn it off:

```sh
zammad run rails r "Setting.set('es_asciifolding', false)"
```

### SSL verification

You can disable SSL verification, which is not recommended. Default is
`true`.

```sh
zammad run rails r "Setting.set('es_ssl_verify', false)"
```

If you want to use custom certificates, you can find information about how to use
them in Zammad's admin settings
(*Settings > Security > SSL Certificates*).

## 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](https://community.zammad.org){target=\_blank} 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](/en/reference/es-indexed-attributes) e può essere causato
da indici mancanti o incompleti.

Se stai riscontrando questo problema e hai installato Elasticsearch seguendo
la nostra [guida di installazione](/en/tutorials/install-elasticsearch),
segui questi passaggi per assicurarti che Elasticsearch funzioni
correttamente.

#### Step 1: Verify Elasticsearch is running

```sh
sudo systemctl status elasticsearch
```

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

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

Altrimenti, prova a riavviarlo e controlla di nuovo:

```sh
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](/en/tutorials/install-elasticsearch).
:::

#### 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.

```sh
zammad run rake zammad:searchindex:rebuild[8]
```

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

```sh
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](/en/tutorials/install-elasticsearch).

::: 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.