A aba Atualização instala novas versões do miniCP e permite voltar para uma versão anterior, sem usar o terminal. Acesse em Configuracoes → Atualizacao.
O que a tela mostra
| Item | Significado |
|---|---|
| Versao em uso | Versão do painel rodando agora |
| Mais recente | Última versão publicada pela equipe miniDC. Aparece o selo nova quando é mais nova que a em uso |
| Versao para instalar | Lista de versões que você pode instalar neste servidor |
| Changelog | O que muda entre a versão em uso e a escolhida |
A verificação roda sozinha ao abrir a aba. Para consultar de novo, clique em Verificar agora.
Quais versões aparecem na lista
- A mais recente publicada.
- A em uso.
- As versões guardadas neste servidor: as que já foram baixadas e as que estavam em uso antes de cada atualização.
O servidor guarda até 8 pacotes de versões. Uma versão que não está guardada aparece desabilitada: não é possível baixar versões antigas que nunca passaram por este servidor.
Atualizar para a versão mais recente
- Abra Configuracoes → Atualizacao.
- Confira a mensagem Atualizacao disponivel.
- Em Versao para instalar, deixe selecionada a mais recente (já vem selecionada quando há atualização).
- Leia o bloco O que muda. Cada versão nova aparece com o selo novo.
- Clique em Atualizar para vX.Y.Z e confirme.
- Acompanhe o Progresso. Ao final, aparece Painel reiniciando... e a página recarrega sozinha.
O que acontece durante a atualização
- O pacote da versão escolhida é baixado (ou lido do servidor, se já estiver guardado).
- A versão em uso é guardada, para permitir voltar a ela depois.
- O pacote é extraído e o código é verificado. Se tiver erro, nada é aplicado.
- Os arquivos novos são aplicados por cima dos atuais.
- O painel reinicia em cerca de 3 segundos.
São preservados: os dados e configurações do painel, arquivos .env, chaves e certificados.
Atenção: o painel fica fora do ar por alguns segundos durante o reinício. Os sites continuam no ar: a atualização mexe só no painel, não no Apache, NGINX ou PHP.
Migração dos logs das contas (versão 2.66.0)
Ao subir para a 2.66.0 ou posterior, o painel faz, uma única vez por servidor, a migração dos logs das contas: move os logs existentes de /home/<usuario>/logs para /var/log/minicp/users/<usuario>/, cria os atalhos em ~/logs, regrava vhosts, pools PHP-FPM, serviços e o logrotate e recarrega o servidor web. A migração fica registrada na Auditoria com a ação user_logs_v2. Os clientes continuam lendo os logs pelo mesmo caminho de antes.
Voltar para uma versão anterior
- Em Versao para instalar, escolha uma versão mais antiga, marcada como guardada.
- O título do changelog muda para Sera desfeito ao voltar para vX.Y.Z e lista, com o selo sera desfeita, tudo o que deixa de existir.
- O botão muda para Voltar para vX.Y.Z (em amarelo). Clique e confirme.
Atenção: ao voltar, os recursos adicionados nas versões posteriores somem. Dados salvos por versões mais novas podem ser ignorados pela versão antiga.
Se escolher a própria versão em uso, o botão vira Reinstalar vX.Y.Z. Use para restaurar arquivos do painel alterados por engano.
Changelog
O changelog é exibido conforme a versão escolhida:
| Escolha | O que aparece |
|---|---|
| Versão mais nova | O que muda da versão em uso até a escolhida |
| Versão mais antiga | O que será desfeito |
| Versão em uso | As notas só dessa versão |
| mostrar todas as versoes marcado | O changelog completo |
Cada entrada traz o número da versão, o tipo (major, minor ou patch), a data, o título e as notas. A versão em uso tem o selo em uso.
Dica: versões anteriores à 2.51.0 não trazem changelog no pacote.
Erros comuns
| Mensagem | O que fazer |
|---|---|
| Nao foi possivel verificar | O servidor não conseguiu consultar as atualizações. Confira o acesso à internet e se o IP do servidor está liberado com a equipe miniDC. |
| HTTP 403 ou 401 ao baixar o pacote | O IP do servidor não está autorizado. Fale com a equipe miniDC. |
| Versão não guardada | O servidor só baixa a versão mais recente. Versões antigas só podem ser instaladas se já estiverem guardadas. |
| Pacote com erro, não aplicado | O pacote não passou na verificação. Nada foi alterado. Tente de novo mais tarde ou fale com a equipe miniDC. |
Atualização manual
Se o painel não abrir, a equipe miniDC pode fornecer o pacote para aplicar no terminal. Depois de qualquer troca manual de arquivos, reinicie o serviço do painel:
systemctl restart mageweb
Dica: ative Configuracoes → Alertas para receber aviso quando houver atualização disponível.