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.
A aba Diagnóstico tem a linha Versão do 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
O link da faixa leva às notas daquela versão. Leia — é para isso que elas existem, e é onde aparece qualquer mudança que exija atenção sua.
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