Mudar para um novo servidor

Sua licença Qubix está vinculada à impressão digital de hardware do servidor em que foi ativada (derivada dos IDs de firmware da placa-mãe). Isso impede que uma única licença seja executada em várias máquinas ao mesmo tempo. Quando você muda para um novo servidor ou substitui a placa-mãe, a impressão digital muda, então você revincula a licença com um novo código de ativação a partir do seu gabinete.

Reemita o código antes do primeiro início no novo servidor — assim a instância ativa sem problemas na inicialização, sem nenhum erro no meio do caminho.

observação

Um redeploy normal (nova imagem Docker, contêineres recriados) no mesmo servidor não altera a impressão digital e não exige nada disso.

O fluxo

Passos

1. No servidor antigo — pare a stack para que o banco de dados fique em um estado consistente:
   Bash

   cd /opt/qubix && docker compose down

2. Reemita o código de ativação. Abra o gabinete my.qubix.pro → sua licença → Reemitir código. O vínculo de hardware antigo é liberado e um novo código de ativação é emitido — copie-o.
3. Copie a instância para o novo servidor. Tudo o que você precisa manter fica em /opt/qubix:
   • /opt/qubix/data/clickhouse — seu banco de dados (todas as estatísticas, campanhas, eventos e configurações);
   • /opt/qubix/data/letsencrypt — seus certificados TLS;
   • /opt/qubix/data/qubix — o estado local do backend;
   • /opt/qubix/.env — suas configurações e segredos;
   • /opt/qubix/docker-compose.yml — a definição da stack.
   Bash

   ssh newserver 'mkdir -p /opt/qubix'
   rsync -a /opt/qubix/ newserver:/opt/qubix/

   Como você parou a stack no passo 1, o banco de dados é desligado de forma limpa e seus arquivos ficam consistentes — uma cópia simples é suficiente, não é necessário um dump separado do banco de dados. A configuração do servidor web é reconstruída automaticamente no primeiro início, então não há mais nada a copiar.
4. Substitua o código de ativação no novo servidor. O /opt/qubix/.env copiado ainda contém o código antigo, já utilizado. Substitua o valor pelo que você acabou de reemitir (remova o código antigo, escreva o novo):
   Bash

   LICENSE_ACTIVATION_CODE=XXXX-YYYY-ZZZZ

5. Inicie a stack:
   Bash

   cd /opt/qubix && docker compose pull && docker compose up -d

   No primeiro início, o Qubix ativa com o novo código e se vincula ao novo servidor. Pronto.

Já iniciou e viu um erro de impressão digital de hardware?

Essa é a mesma situação, não uma falha. Execute os passos 2 e 4 e, em seguida, reinicie o backend:

Bash

cd /opt/qubix && docker compose restart qubixd

Mantenha backups fora do host

Sempre mantenha um backup fora do host de /opt/qubix/data antes de uma mudança — é o seu banco de dados de analytics.

O que vem a seguir

Chave de licença

Ativando uma licença Qubix.

Expiração da assinatura

O que acontece quando a licença expira.