Migrer vers un nouveau serveur

Votre licence Qubix est liée à l'empreinte matérielle du serveur sur lequel elle a été activée (dérivée des identifiants firmware de la carte mère). Cela empêche une même licence de fonctionner sur plusieurs machines à la fois. Lorsque vous changez de serveur ou remplacez la carte mère, l'empreinte change ; vous reliez donc à nouveau la licence à l'aide d'un nouveau code d'activation issu de votre espace.

Réémettez le code avant le premier démarrage sur le nouveau serveur — l'instance s'active alors proprement au démarrage, sans erreur entre-temps.

remarque

Un redéploiement classique (nouvelle image Docker, conteneurs recréés) sur le même serveur ne change pas l'empreinte et ne nécessite rien de tout cela.

Le déroulement

Étapes

1. Sur l'ancien serveur — arrêtez la pile pour que la base de données soit dans un état cohérent :
   Bash

   cd /opt/qubix && docker compose down

2. Réémettez le code d'activation. Ouvrez l'espace my.qubix.pro → votre licence → Réémettre le code. L'ancien lien matériel est libéré et un nouveau code d'activation est émis — copiez-le.
3. Copiez l'instance vers le nouveau serveur. Tout ce que vous devez conserver se trouve sous /opt/qubix :
   • /opt/qubix/data/clickhouse — votre base de données (toutes les statistiques, campagnes, événements et paramètres) ;
   • /opt/qubix/data/letsencrypt — vos certificats TLS ;
   • /opt/qubix/data/qubix — l'état local du backend ;
   • /opt/qubix/.env — vos paramètres et secrets ;
   • /opt/qubix/docker-compose.yml — la définition de la pile.
   Bash

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

   Comme vous avez arrêté la pile à l'étape 1, la base de données est éteinte proprement et ses fichiers sont cohérents — une simple copie suffit, aucun export de base de données distinct n'est nécessaire. La configuration du serveur web est reconstruite automatiquement au premier démarrage, il n'y a donc rien d'autre à copier.
4. Remplacez le code d'activation sur le nouveau serveur. Le /opt/qubix/.env copié contient encore l'ancien code, déjà utilisé. Remplacez sa valeur par celui que vous venez de réémettre (supprimez l'ancien code, inscrivez le nouveau) :
   Bash

   LICENSE_ACTIVATION_CODE=XXXX-YYYY-ZZZZ

5. Démarrez la pile :
   Bash

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

   Au premier démarrage, Qubix s'active avec le nouveau code et se lie au nouveau serveur. Terminé.

Déjà démarré et vous avez vu une erreur d'empreinte matérielle ?

C'est la même situation, pas un échec. Effectuez les étapes 2 et 4, puis redémarrez le backend :

Bash

cd /opt/qubix && docker compose restart qubixd

Conservez des sauvegardes hors hôte

Conservez toujours une sauvegarde hors hôte de /opt/qubix/data avant une migration — c'est votre base de données analytiques.

Et ensuite

Clé de licence

Activer une licence Qubix.

Expiration de l'abonnement

Ce qui se passe à l'expiration de la licence.