Trasladarse a un nuevo servidor

Su licencia de Qubix está vinculada a la huella de hardware del servidor en el que se activó (derivada de los identificadores de firmware de la placa base). Esto impide que una misma licencia se ejecute en varias máquinas a la vez. Cuando se traslada a un nuevo servidor o reemplaza la placa base, la huella cambia, por lo que debe volver a vincular la licencia con un nuevo código de activación obtenido desde su gabinete.

Vuelva a emitir el código antes del primer arranque en el nuevo servidor: así la instancia se activa de forma limpia al iniciar, sin ningún error de por medio.

nota

Un redespliegue normal (nueva imagen de Docker, contenedores recreados) en el mismo servidor no cambia la huella y no requiere nada de esto.

El flujo

Pasos

1. En el servidor antiguo — detenga el stack para que la base de datos quede en un estado consistente:
   Bash

   cd /opt/qubix && docker compose down

2. Vuelva a emitir el código de activación. Abra el gabinete my.qubix.pro → su licencia → Reemitir código. La antigua vinculación de hardware se libera y se emite un nuevo código de activación — cópielo.
3. Copie la instancia al nuevo servidor. Todo lo que necesita conservar se encuentra bajo /opt/qubix:
   • /opt/qubix/data/clickhouse — su base de datos (todas las estadísticas, campañas, eventos y ajustes);
   • /opt/qubix/data/letsencrypt — sus certificados TLS;
   • /opt/qubix/data/qubix — el estado local del backend;
   • /opt/qubix/.env — sus ajustes y secretos;
   • /opt/qubix/docker-compose.yml — la definición del stack.
   Bash

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

   Como detuvo el stack en el paso 1, la base de datos se apagó de forma limpia y sus archivos son consistentes — basta con una copia simple, no hace falta un volcado de base de datos por separado. La configuración del servidor web se reconstruye automáticamente en el primer arranque, así que no hay nada más que copiar.
4. Reemplace el código de activación en el nuevo servidor. El /opt/qubix/.env copiado todavía lleva el código antiguo, ya usado. Reemplace su valor por el que acaba de reemitir (elimine el código antiguo, escriba el nuevo):
   Bash

   LICENSE_ACTIVATION_CODE=XXXX-YYYY-ZZZZ

5. Inicie el stack:
   Bash

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

   En el primer arranque, Qubix se activa con el nuevo código y se vincula al nuevo servidor. Listo.

¿Ya lo inició y vio un error de huella de hardware?

Es la misma situación, no un fallo. Realice los pasos 2 y 4, y luego reinicie el backend:

Bash

cd /opt/qubix && docker compose restart qubixd

Mantenga copias de seguridad fuera del host

Mantenga siempre una copia de seguridad fuera del host de /opt/qubix/data antes de un traslado — es su base de datos de analítica.

Qué sigue

Clave de licencia

Activar una licencia de Qubix.

Vencimiento de la suscripción

Qué ocurre cuando la licencia caduca.