Atualizando o 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!

Antes de atualizar o Zammad, recomendamos fortemente dar uma olhada nas nossas notas de lançamento. Você pode encontrar informações sobre recursos e correções, assim como observações técnicas e alterações que quebram compatibilidade.

Esteja ciente de que você não deve pular versões principais do Zammad ao atualizar. Isso significa que, por exemplo, seu caminho de atualização da versão 2.4 para 5.1 (assumindo que essa é a atual estável) seria: 2.4 → 3.0 → 4.0 → 5.0 → latest stable (5.1)

INFO

Esta página descreve apenas como atualizar o Zammad. Caso você também queira atualizar seu sistema operacional hospedeiro, dê uma olhada nas instruções de Atualização de host e migração de repositório.

Atualização via instalação por pacote

Verificar dependências

Antes de prosseguir, verifique novamente se o ambiente do seu sistema corresponde aos requisitos do Zammad (veja Pré-requisitos e Instalação via pacote).

Parar o Zammad

sudo systemctl stop zammad

Fazer backup do Zammad

Crie um backup. Você pode usar o script de backup que vem com o pacote do Zammad.

Atualizar o Zammad

INFO

Se você atualizar todo o seu sistema e houver atualizações tanto para o Zammad quanto para o seu servidor de banco de dados, isso pode levar a erros, porque seu banco de dados pode não estar de volta online quando o Zammad for atualizado.

Nesse caso, você pode querer excluir o Zammad da atualização temporariamente, como você pode ver nos comandos abaixo.

Atualizar listas de pacotes:

sudo apt update

Desativar atualizações para o Zammad:

sudo apt-mark hold zammad

Atualizar todos os pacotes exceto o Zammad:

sudo apt upgrade

Reativar atualizações para o Zammad:

sudo apt-mark unhold zammad

Atualizar o Zammad:

sudo apt upgrade

Etapas adicionais

Atualizar o Elasticsearch também pode ser relevante. Certifique-se de ter uma versão suportada do Elasticsearch instalada (veja instalação via pacote para versões suportadas).

Se você precisar atualizar o Elasticsearch, dê uma olhada na documentação deles e siga as instruções.

Reconstruir o índice do Elasticsearch optional

Necessário apenas se a nota de lançamento pedir para reconstruir o índice do Elasticsearch.

Sem especificar núcleos de CPU a usar:

zammad run rake zammad:searchindex:rebuild

Especificando núcleos de CPU a usar (exemplo 8):

zammad run rake zammad:searchindex:rebuild[8]

Iniciar o Zammad

sudo systemctl start zammad

Atualizando instalação via Docker

WARNING

Atualizações da stack do Docker Compose podem exigir etapas extras ou introduzir alterações que quebram compatibilidade. Sempre verifique primeiro as notas de lançamento do Docker Compose para instruções de atualização.

TIP

Se você quiser atualizar o Zammad para uma versão específica, use a variável de ambiente VERSION (exemplo com explicação adicional) e especifique o número da versão.

Atualizando instalações baseadas no Portainer

Na sua stack do Zammad, clique em Pull and redeploy, ative Re-pull image and redeploy e clique em Update.

Atualizando instalações baseadas em Docker Compose

cd zammad-docker-compose

git pull

docker compose pull

docker compose up -d

Reconstruir o índice do Elasticsearch optional

Necessário apenas se a nota de lançamento pedir para reconstruir o índice do 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]