Przeniesienie na nowy serwer

Licencja Qubix jest powiązana z odciskiem sprzętowym serwera, na którym została aktywowana (wyliczanym z identyfikatorów firmware'u płyty głównej). Uniemożliwia to działanie jednej licencji na kilku maszynach jednocześnie. Przy przenosinach na nowy serwer lub wymianie płyty głównej odcisk się zmienia, dlatego licencję trzeba powiązać ponownie, używając nowego kodu aktywacji z panelu klienta.

Proszę wydać nowy kod przed pierwszym uruchomieniem na nowym serwerze — wtedy instancja aktywuje się prawidłowo podczas startu, bez błędu pomiędzy.

notatka

Zwykłe ponowne wdrożenie (nowy obraz Docker, odtworzone kontenery) na tym samym serwerze nie zmienia odcisku i nie wymaga żadnego z tych kroków.

Jak to przebiega

Kroki

1. Na starym serwerze — zatrzymaj stos, aby baza danych była w spójnym stanie:
   Bash

   cd /opt/qubix && docker compose down

2. Wydaj nowy kod aktywacji. Proszę otworzyć panel my.qubix.pro → swoja licencja → Wydaj nowy kod. Stare powiązanie ze sprzętem zostaje zwolnione i wydawany jest nowy kod aktywacji — proszę go skopiować.
3. Skopiuj instancję na nowy serwer. Wszystko, co należy zachować, znajduje się w /opt/qubix:
   • /opt/qubix/data/clickhouse — Pana/Pani baza danych (wszystkie statystyki, kampanie, zdarzenia i ustawienia);
   • /opt/qubix/data/letsencrypt — Pana/Pani certyfikaty TLS;
   • /opt/qubix/data/qubix — lokalny stan backendu;
   • /opt/qubix/.env — Pana/Pani ustawienia i sekrety;
   • /opt/qubix/docker-compose.yml — definicja stosu.
   Bash

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

   Ponieważ w kroku 1 zatrzymano stos, baza danych została poprawnie wyłączona, a jej pliki są spójne — wystarczy zwykłe kopiowanie, osobny zrzut bazy nie jest potrzebny. Konfiguracja serwera WWW jest odtwarzana automatycznie przy pierwszym uruchomieniu, więc nie ma już nic więcej do skopiowania.
4. Zastąp kod aktywacji na nowym serwerze. Skopiowany /opt/qubix/.env wciąż zawiera stary, już użyty kod. Proszę zastąpić jego wartość tą, która została właśnie wydana (usunąć stary kod, wpisać nowy):
   Bash

   LICENSE_ACTIVATION_CODE=XXXX-YYYY-ZZZZ

5. Uruchom stos:
   Bash

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

   Przy pierwszym uruchomieniu Qubix aktywuje się nowym kodem i powiąże się z nowym serwerem. Gotowe.

Uruchomiono już i pojawił się błąd odcisku sprzętowego?

To ta sama sytuacja, a nie awaria. Proszę wykonać kroki 2 i 4, a następnie zrestartować backend:

Bash

cd /opt/qubix && docker compose restart qubixd

Trzymaj kopie zapasowe poza serwerem

Przed przenosinami proszę zawsze trzymać kopię zapasową /opt/qubix/data poza tym serwerem — to Pana/Pani analityczna baza danych.

Co dalej

Klucz licencyjny

Aktywacja licencji Qubix.

Wygaśnięcie subskrypcji

Co się dzieje, gdy licencja wygaśnie.