Aggiornare Zammad

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!

Prima di aggiornare Zammad, consigliamo vivamente di consultare le nostre note di rilascio. Troverete informazioni su nuove funzionalità e correzioni, nonché osservazioni tecniche e modifiche incompatibili con le versioni precedenti.

Tieni presente che non dovresti saltare le versioni principali di Zammad durante l'aggiornamento. Ciò significa, ad esempio, che il tuo percorso di aggiornamento dalla versione 2.4 alla 5.1 (supponendo che questa sia la versione stabile attuale) sarebbe: 2.4 → 3.0 → 4.0 → 5.0 → ultima versione stabile (5.1)

INFO

Questa pagina descrive come aggiornare solo Zammad. Se desideri aggiornare anche il sistema operativo host, consulta le istruzioni per Aggiornamento host e migrazione repository.

Update package installation

Check dependencies

Prima di procedere, verifica che il tuo ambiente di sistema corrisponda ai requisiti di Zammad (vedi Prerequisiti e Installazione del pacchetto).

Ferma Zammad

sudo systemctl stop zammad

Backup di Zammad

Crea un backup. Puoi usare lo script di backup incluso.

Aggiorna Zammad

INFO

Se aggiorni l'intero sistema e sono disponibili aggiornamenti sia per Zammad ** e** per il tuo server di database, potrebbero verificarsi degli errori perché il database potrebbe non essere nuovamente online dopo l'aggiornamento di Zammad.

In tal caso, potresti voler escludere temporaneamente Zammad dagli aggiornamenti, come puoi vedere nei comandi seguenti.

Aggiorna gli elenchi dei pacchetti:

sudo apt update

Disabilita gli aggiornamenti per Zammad:

sudo apt-mark hold zammad

Aggiorna tutti i pacchetti tranne Zammad:

sudo apt upgrade

Riattiva gli aggiornamenti per Zammad:

sudo apt-mark unhold zammad

Aggiorna Zammad:

sudo apt upgrade

Additional steps

Potrebbe essere rilevante anche l'aggiornamento di Elasticsearch. Assicurati di avere installata una versione supportata di Elasticsearch (vedi installazione del pacchetto per le versioni supportate).

Se devi aggiornare Elasticsearch, consulta la loro documentazione e segui le istruzioni.

Rebuild Elasticsearch index optional

Necessario solo se le note di rilascio ti dicono di ricostruire l'indice Elasticsearch.

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]

Avvia Zammad

sudo systemctl start zammad

Update Docker installation

WARNING

Docker Compose stack updates may require extra steps or introduce breaking changes. Always check the Docker Compose release notes for update instructions first.

TIP

If you want to update Zammad to a specific version, use the VERSION environment variable (example with further explanation) and specify the version number.

Updating Portainer based installations

Nel tuo stack Zammad, fai clic su Pull and redeploy, attiva Re-pull image and redeploy.

Updating Docker Compose based installations

cd zammad-docker-compose

git pull

docker compose pull

docker compose up -d

Rebuild Elasticsearch index optional

Necessario solo se le note di rilascio ti dicono di ricostruire l'indice Elasticsearch.

Without specifying CPU cores:

docker compose run --rm zammad-railsserver bundle exec rake zammad:searchindex:rebuild

With specifying CPU cores to use (example 8):

docker compose run --rm zammad-railsserver bundle exec rake zammad:searchindex:rebuild[8]