Переезд на новый сервер

Лицензия Qubix привязана к аппаратному отпечатку сервера, на котором она была активирована (он вычисляется из идентификаторов прошивки материнской платы). Это не даёт одной лицензии работать сразу на нескольких машинах. При переезде на новый сервер или замене материнской платы отпечаток меняется, поэтому лицензию нужно перепривязать новым кодом активации из личного кабинета.

Перевыпустите код до первого запуска на новом сервере — тогда инстанс активируется штатно при загрузке, без промежуточной ошибки.

примечание

Обычный передеплой (новый Docker-образ, пересозданные контейнеры) на том же сервере отпечаток не меняет и ничего из этого не требует.

Как это происходит

Шаги

1. На старом сервере — остановите стек, чтобы база данных осталась в согласованном состоянии:
   Bash

   cd /opt/qubix && docker compose down

2. Перевыпустите код активации. Откройте кабинет my.qubix.pro → ваша лицензия → Перевыпустить код. Старая привязка к железу снимается, выдаётся новый код активации — скопируйте его.
3. Скопируйте инстанс на новый сервер. Всё, что нужно сохранить, лежит в /opt/qubix:
   • /opt/qubix/data/clickhouse — ваша база данных (вся статистика, кампании, события и настройки);
   • /opt/qubix/data/letsencrypt — ваши TLS-сертификаты;
   • /opt/qubix/data/qubix — локальное состояние бэкенда;
   • /opt/qubix/.env — ваши настройки и секреты;
   • /opt/qubix/docker-compose.yml — описание стека.
   Bash

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

   Поскольку на шаге 1 вы остановили стек, база данных была корректно выключена и её файлы согласованы — достаточно простого копирования, отдельный дамп базы не нужен. Конфигурация веб-сервера пересобирается автоматически при первом запуске, поэтому больше копировать нечего.
4. Замените код активации на новом сервере. В скопированном /opt/qubix/.env всё ещё прописан старый, уже использованный код. Замените его значение на только что перевыпущенное (удалите старый код, впишите новый):
   Bash

   LICENSE_ACTIVATION_CODE=XXXX-YYYY-ZZZZ

5. Запустите стек:
   Bash

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

   При первом запуске Qubix активируется новым кодом и привязывается к новому серверу. Готово.

Уже запустили и увидели ошибку аппаратного отпечатка?

Это та же ситуация, а не сбой. Выполните шаги 2 и 4, затем перезапустите бэкенд:

Bash

cd /opt/qubix && docker compose restart qubixd

Держите резервные копии вне сервера

Перед переездом всегда держите резервную копию /opt/qubix/data вне этого сервера — это ваша аналитическая база данных.

Что дальше

Лицензионный ключ

Активация лицензии Qubix.

Истечение подписки

Что происходит при истечении лицензии.