Chuyển sang máy chủ mới

Giấy phép Qubix của bạn được ràng buộc với dấu vân tay phần cứng của máy chủ nơi nó được kích hoạt (bắt nguồn từ các ID firmware của bo mạch chủ). Điều này ngăn một giấy phép chạy trên nhiều máy cùng một lúc. Khi bạn chuyển sang máy chủ mới hoặc thay bo mạch chủ, dấu vân tay thay đổi, vì vậy bạn ràng buộc lại giấy phép bằng một mã kích hoạt mới lấy từ tài khoản của mình.

Hãy cấp lại mã trước lần khởi động đầu tiên trên máy chủ mới — khi đó phiên bản sẽ kích hoạt sạch sẽ ngay khi khởi động, không có lỗi nào ở giữa.

ghi chú

Một lần triển khai lại bình thường (image Docker mới, tạo lại các container) trên cùng một máy chủ không làm thay đổi dấu vân tay và không cần bất kỳ thao tác nào ở đây.

Quy trình

Các bước

1. Trên máy chủ cũ — dừng stack để cơ sở dữ liệu ở trạng thái nhất quán:
   Bash

   cd /opt/qubix && docker compose down

2. Cấp lại mã kích hoạt. Mở tài khoản my.qubix.pro → giấy phép của bạn → Reissue code. Ràng buộc phần cứng cũ được giải phóng và một mã kích hoạt mới được cấp — hãy sao chép nó.
3. Sao chép phiên bản sang máy chủ mới. Mọi thứ bạn cần giữ lại đều nằm dưới /opt/qubix:
   • /opt/qubix/data/clickhouse — cơ sở dữ liệu của bạn (toàn bộ thống kê, chiến dịch, sự kiện và cài đặt);
   • /opt/qubix/data/letsencrypt — chứng chỉ TLS của bạn;
   • /opt/qubix/data/qubix — trạng thái cục bộ của backend;
   • /opt/qubix/.env — cài đặt và thông tin bí mật của bạn;
   • /opt/qubix/docker-compose.yml — định nghĩa của stack.
   Bash

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

   Vì bạn đã dừng stack ở bước 1, cơ sở dữ liệu được tắt sạch sẽ và các tệp của nó nhất quán — chỉ cần sao chép thông thường là đủ, không cần dump cơ sở dữ liệu riêng. Cấu hình máy chủ web được dựng lại tự động ở lần khởi động đầu tiên, nên không có gì khác cần sao chép.
4. Thay mã kích hoạt trên máy chủ mới. Tệp /opt/qubix/.env vừa sao chép vẫn mang mã cũ đã được sử dụng. Hãy thay giá trị của nó bằng mã bạn vừa cấp lại (xóa mã cũ, ghi mã mới vào):
   Bash

   LICENSE_ACTIVATION_CODE=XXXX-YYYY-ZZZZ

5. Khởi động stack:
   Bash

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

   Ở lần khởi động đầu tiên, Qubix kích hoạt với mã mới và ràng buộc với máy chủ mới. Xong.

Đã khởi động và thấy lỗi dấu vân tay phần cứng?

Đó là cùng một tình huống, không phải lỗi hỏng. Hãy làm bước 2 và 4, rồi khởi động lại backend:

Bash

cd /opt/qubix && docker compose restart qubixd

Giữ bản sao lưu ngoài máy chủ

Luôn giữ một bản sao lưu của /opt/qubix/data ở ngoài máy chủ trước khi di chuyển — đó là cơ sở dữ liệu phân tích của bạn.

Tiếp theo là gì

Khóa giấy phép

Kích hoạt một giấy phép Qubix.

Hết hạn đăng ký

Điều gì xảy ra khi giấy phép hết hạn.