Ir para o conteúdo principal

Guia: Como manter o plugin atualizado

Objetivo

Descobrir que existe versão nova do plugin e aplicá-la sem quebrar a coleta que está rodando.


Escopo e Público

  • Aplica-se a: servidores com o plugin já instalado, cPanel/WHM ou DirectAdmin.
  • Não cobre: a primeira instalação — para isso veja cPanel/WHM ou DirectAdmin.
  • Público-alvo: administrador com acesso root por SSH.

Como você fica sabendo

O plugin pergunta ao servidor de releases uma vez por dia se existe versão mais nova. Quando existe, uma faixa aparece no alto de todas as telas de administrador, com o número da versão e um link para as notas dela.

Se quiser perguntar na hora, use o botão Verificar atualizações no cabeçalho — ele está em qualquer aba.

📷 Espaço para imagem — faixa-atualizacao-disponivel.png
O que precisa aparecer: a faixa de atualização no alto da tela, com o número da versão e o link para as notas, e o botão Verificar atualizações no cabeçalho logo acima. É o que o leitor viu e o trouxe até este guia.
Onde capturar: Qualquer aba do plugin, num servidor com versão nova publicada.image.png

AFigura aba Diagnóstico1 tem- aFaixa linha Versão doatualização plugin, que diz qual está instalada e o que foi encontrado na última checagem — as quatro abas estão descritas em As telas do plugin.

A pergunta diária não envia nada sobre o seu servidor: nem a versão instalada, nem o hostname, nem contagem de mensagens.


Passos (sequência)

Passo 1 — Ler as notas antes
Passo 2 — Baixar a versão nova

Entre no painel do Sender25, abra Plugin no menu lateral do servidor e copie o comando pronto, já com a versão, o digest e um código de autorização de 15 minutos.

curl -fsS 'https://app.sender25.com/plugin/dl/plugin-panel-VERSAO.tar.gz?t=CODIGO' \
     -o /tmp/plugin-panel-VERSAO.tar.gz \
  && echo 'DIGEST  /tmp/plugin-panel-VERSAO.tar.gz' | sha256sum -c -

⚠ É -o minúsculo, com o nome do arquivo escrito. Com -O maiúsculo, versões de curl anteriores à 7.83 colocam o código de autorização dentro do nome do arquivo — o sha256sum seguinte não encontra nada e o código fica gravado em disco.

Passo 3 — Extrair em um diretório novo
mkdir -p /opt/plugin-panel-VERSAO
tar -xzf /tmp/plugin-panel-VERSAO.tar.gz -C /opt/plugin-panel-VERSAO

⚠ Diretório novo, não o da versão anterior. Extrair por cima deixa para trás os arquivos que a versão nova removeu — e o instalador copia tudo que encontra na origem, sobras inclusive. Um diretório por versão resolve isso sem você ter que apagar nada.

Passo 4 — Instalar sob a trava do coletor

⚠ Este é o passo em que atualizar difere de instalar. O coletor está rodando de minuto em minuto, e o instalador remove os arquivos da versão antiga antes de copiar os da nova. Um ciclo que caia nessa janela morre com erro, e o cron reporta rastreamento quebrado por causa de uma atualização que deu certo.

A trava evita isso: o instalador a toma, e o coletor pula os ciclos até ela ser liberada.

cPanel/WHM:

flock -w 420 /tmp/sender25-tracking-sync.lock \
  -c "/opt/plugin-panel-VERSAO/scripts/install.sh"

DirectAdmin:

flock -w 420 /tmp/sender25-tracking-directadmin-sync.lock \
  /opt/plugin-panel-VERSAO/scripts/install-directadmin.sh

Os nomes das travas são diferentes. Trocar um pelo outro parece funcionar e não protege nada.

O -w 420 espera até sete minutos pela trava. Se não conseguir, desiste sem instalar — que é o certo: trava presa por tanto tempo significa outro problema, e não é hora de trocar arquivos.

No cPanel, o cpsrvd é reiniciado ao final — interrupção breve do acesso web ao painel, sem efeito no fluxo de e-mail. No DirectAdmin, nenhum serviço é reiniciado.

Passo 5 — Conferir

Abra a tela. A faixa de atualização deve ter sumido — ela desaparece no instante em que a versão nova é instalada, sem esperar a próxima checagem diária.

Na aba Diagnóstico, a linha Versão do plugin deve mostrar o número novo e dizer que está em dia. Se quiser confirmar na hora, clique em Verificar atualizações.

📷 Espaço para imagem — diagnostico-versao-em-dia.png
O que precisa aparecer: a linha Versão do plugin na aba Diagnóstico, com o número novo e o texto "Em dia com a versão publicada." É a confirmação de que a atualização pegou.
Onde capturar: Plugin → Diagnóstico, logo após atualizar.


Problemas comuns

O código de autorização expirou

Ele vale 15 minutos e libera um arquivo só. Volte à página do plugin e gere outro — não é falta de permissão.

O sha256sum não encontrou o arquivo

Quase sempre é o -O maiúsculo. Procure em /tmp ou no diretório atual um arquivo cujo nome termine em ?t= seguido do código: é o download, com o nome errado. Renomeie-o e confira o digest, ou baixe de novo com -o.

A tela diz que a versão instalada é mais nova que a publicada

Acontece quando você instalou uma versão que ainda não foi publicada. Não é erro; a tela está avisando que não consegue confirmar a sua versão contra o que existe publicado.


Controle de Mudanças

Informações de controle de versão
  • Última revisão 02-09-2026
  • Próxima revisão 02-03-2027
  • Autor Sender25
  • Versão 1.0