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.

Aggiorna installazione tramite pacchetto

Controlla le dipendenze

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

Passaggi aggiuntivi

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.

Ricostruisci l'indice Elasticsearch opzionale

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

Aggiorna installazione Docker

WARNING

Gli aggiornamenti dello stack Docker Compose potrebbero richiedere passaggi aggiuntivi o introdurre modifiche incompatibili. Verifica sempre prima le note di rilascio di Docker Compose per le istruzioni di aggiornamento.

TIP

Se desideri aggiornare Zammad a una versione specifica, utilizza la variabile d'ambiente VERSION (esempio con ulteriori spiegazioni) e specifica il numero di versione.

Aggiornare installazioni basate su Portainer

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

Aggiornare installazioni basate su Docker Compose

cd zammad-docker-compose

git pull

docker compose pull

docker compose up -d

Ricostruisci l'indice Elasticsearch opzionale

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

Senza specificare i core della CPU:

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

Con la specifica dei core della CPU da utilizzare (esempio 8):

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