Auf einen neuen Server umziehen

Ihre Qubix-Lizenz ist an den Hardware-Fingerabdruck des Servers gebunden, auf dem sie aktiviert wurde (abgeleitet aus den Firmware-IDs des Mainboards). Das verhindert, dass eine Lizenz gleichzeitig auf mehreren Rechnern läuft. Wenn Sie auf einen neuen Server umziehen oder das Mainboard tauschen, ändert sich der Fingerabdruck, sodass Sie die Lizenz mit einem neuen Aktivierungscode aus Ihrem Kabinett erneut binden.

Stellen Sie den Code vor dem ersten Start auf dem neuen Server neu aus — dann aktiviert sich die Instanz beim Booten sauber, ohne Fehler dazwischen.

hinweis

Ein normaler Redeploy (neues Docker-Image, neu erstellte Container) auf demselben Server ändert den Fingerabdruck nicht und erfordert nichts davon.

Der Ablauf

Schritte

1. Auf dem alten Server — den Stack stoppen, damit die Datenbank in einem konsistenten Zustand ist:
   Bash

   cd /opt/qubix && docker compose down

2. Den Aktivierungscode neu ausstellen. Öffnen Sie das my.qubix.pro-Kabinett → Ihre Lizenz → Code neu ausstellen. Die alte Hardware-Bindung wird freigegeben und ein neuer Aktivierungscode wird ausgestellt — kopieren Sie ihn.
3. Die Instanz auf den neuen Server kopieren. Alles, was Sie behalten müssen, liegt unter /opt/qubix:
   • /opt/qubix/data/clickhouse — Ihre Datenbank (alle Statistiken, Kampagnen, Events und Einstellungen);
   • /opt/qubix/data/letsencrypt — Ihre TLS-Zertifikate;
   • /opt/qubix/data/qubix — der lokale Zustand des Backends;
   • /opt/qubix/.env — Ihre Einstellungen und Secrets;
   • /opt/qubix/docker-compose.yml — die Stack-Definition.
   Bash

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

   Da Sie den Stack in Schritt 1 gestoppt haben, wurde die Datenbank sauber heruntergefahren und ihre Dateien sind konsistent — ein einfaches Kopieren genügt, ein separater Datenbank-Dump ist nicht nötig. Die Webserver-Konfiguration wird beim ersten Start automatisch neu aufgebaut, sodass es nichts weiter zu kopieren gibt.
4. Den Aktivierungscode auf dem neuen Server ersetzen. Die kopierte /opt/qubix/.env trägt noch den alten, bereits verwendeten Code. Ersetzen Sie dessen Wert durch den, den Sie gerade neu ausgestellt haben (alten Code entfernen, neuen eintragen):
   Bash

   LICENSE_ACTIVATION_CODE=XXXX-YYYY-ZZZZ

5. Den Stack starten:
   Bash

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

   Beim ersten Start aktiviert sich Qubix mit dem neuen Code und bindet sich an den neuen Server. Fertig.

Bereits gestartet und einen Hardware-Fingerabdruck-Fehler gesehen?

Das ist dieselbe Situation, kein Fehlschlag. Führen Sie die Schritte 2 und 4 aus und starten Sie dann das Backend neu:

Bash

cd /opt/qubix && docker compose restart qubixd

Off-Host-Backups behalten

Behalten Sie vor einem Umzug immer ein Off-Host-Backup von /opt/qubix/data — es ist Ihre Analyse-Datenbank.

Wie geht es weiter

Lizenzschlüssel

Eine Qubix-Lizenz aktivieren.

Ablauf des Abonnements

Was passiert, wenn die Lizenz abläuft.