Atualizações do sistema

Licença e sincronização

A sincronização é a conversa periódica entre o seu servidor e a central da Ravi. É por ela que o sistema valida a licença, aplica o plano contratado, envia a telemetria de uso e fica sabendo quando existe uma versão nova para baixar.

Como e quando acontece

• A sincronização roda automaticamente a cada 10 minutos, sem nenhuma ação do operador.
• Toda a comunicação viaja em um canal cifrado de ponta a ponta, com identidade única por servidor, segredo rotativo e proteção contra repetição de mensagens. Nenhum intermediário consegue ler o conteúdo.
• A credencial de plano recebida em cada sincronização vale por 24 horas. Na prática, basta uma sincronização bem-sucedida por dia para o plano continuar ativo: quedas curtas de internet não afetam nada.

Os dados de monitoramento da sua rede permanecem no seu servidor: a sincronização cuida apenas de licenciamento, plano e distribuição de atualizações. Nenhum dado de tráfego dos seus assinantes é enviado à central.

Forçar uma sincronização imediata

Depois de contratar ou mudar de plano, você não precisa esperar o próximo ciclo automático:

1. Abra as Configurações do sistema.
2. Localize o card Registro RAVI. Ele exibe o token de identificação do servidor, usado no registro e no contato com o suporte.
3. Clique em Atualizar para disparar uma sincronização imediata com a central. O novo plano passa a valer na hora.
4. Se precisar informar o token em outro lugar (por exemplo, na contratação), use o botão Copiar.

O que acontece se a sincronização falhar

Como funciona Novo na 7.2

A atualização do Ravi Monitor é automática e assinada digitalmente. Não existe botão "atualizar sistema" no painel: quando a versão nova é liberada para o seu servidor, ele baixa, valida e aplica o pacote sozinho, normalmente de forma imperceptível para a operação.

O ciclo, do aviso à versão nova no rodapé

1. A Ravi publica uma versão nova na central.
2. Na sincronização de 10 minutos, o seu servidor recebe o aviso da versão junto com o manifesto do pacote: a impressão digital do arquivo, a assinatura digital e o endereço de download. O manifesto chega pelo canal cifrado, direto da central.
3. Em até 30 minutos, a rotina de atualização baixa o pacote por HTTPS, de forma autenticada.
4. O pacote só é aplicado se a impressão digital e a assinatura digital conferirem. Um pacote alterado ou forjado é recusado automaticamente e o sistema permanece na versão atual.
5. Se qualquer verificação falhar, a atualização é abortada sem tocar em nada, e o motivo fica registrado em log.

O que acontece durante a aplicação

Com o pacote validado, o servidor executa a sequência abaixo, sem intervenção:

1. Extrai os arquivos da versão nova por cima da instalação atual (extração aditiva: sobrescreve e adiciona arquivos do sistema).
2. Roda o provisionamento do sistema operacional: instala pacotes que passaram a ser necessários, cria e atualiza serviços, repara o ambiente de IA se estiver corrompido e reaplica permissões. O passo é idempotente: rodar de novo não causa efeito colateral.
3. Aplica as migrações de banco de dados (criação e ajuste de tabelas e colunas, também idempotentes).
4. Reinicia o serviço PHP para limpar caches internos.
5. Atualiza o número da versão e sincroniza novamente com a central.

A versão instalada aparece no rodapé de todas as telas, no formato Versão seguida do número e da data. As novidades de cada versão ficam na página Novidades, acessível pelo menu do avatar (canto superior direito). Veja Página de novidades.

Onde ver o que aconteceu

Cada ciclo de atualização grava um log completo em /tmp/logupdate.log no servidor. É o primeiro lugar para olhar (ou enviar ao suporte) quando a impressão é de que "a atualização não veio": o log mostra se houve download, se as verificações passaram e onde o processo parou.

Boas práticas

• Não edite arquivos em /var/www/html. A atualização extrai o pacote por cima e sobrescreve qualquer customização feita direto nos arquivos. As personalizações suportadas são as feitas pela interface.
• Não gerencie o firewall por fora do painel. O provisionamento zera regras manuais de iptables a cada atualização; o firewall do produto é o gerenciado pela interface. Regras criadas por fora serão perdidas.
• Mantenha a saída HTTPS liberada para a internet e para os repositórios Debian. Sem isso não há licença nem atualização.
• Em VM, tire um snapshot antes de um salto grande de versão. As migrações são idempotentes e a extração é aditiva, mas o snapshot é a sua rede de segurança de custo zero.
• Espaço em disco: o download do pacote usa disco (não RAM). Se uma atualização falhar por espaço, verifique o espaço livre nas partições / e /opt.

Liberação gradual

A distribuição de versões novas é gradual, no modelo conhecido como canário: antes de liberar para toda a base, a central pode restringir a versão a um conjunto de servidores escolhidos e acompanhar o comportamento em produção. Só depois a versão é aberta para o restante da frota.

Na prática, isso significa que:

• É normal um servidor receber a versão dias depois de outro, inclusive dentro da mesma empresa. Não é defeito nem esquecimento.
• Enquanto a versão não é liberada para o seu servidor, a sincronização segue normal e nada muda na operação.
• Quando a liberação chega, o ciclo automático descrito em Como funciona cuida de tudo, sem ação do operador.