メインコンテンツまでスキップ

新しいサーバーへの移行

お使いの Qubix ライセンスは、アクティベートされたサーバーのハードウェアフィンガープリント （マザーボードのファームウェア ID から導出されます）に紐づいています。これにより、1 つの ライセンスが複数のマシンで同時に動作することを防ぎます。新しいサーバーへ移行したり、 マザーボードを交換したりすると、フィンガープリントが変わるため、キャビネットから取得する 新しいアクティベーションコードでライセンスを再紐付けします。

新しいサーバーで初めて起動する前にコードを再発行してください。そうすれば、インスタンスは 起動時にクリーンにアクティベートされ、その間にエラーが発生することはありません。

注記

同じサーバー上での通常の再デプロイ（新しい Docker イメージ、コンテナの再作成）では、 フィンガープリントは変わらないため、ここで説明する作業は一切必要ありません。

流れ​

手順​

  1. 旧サーバーでスタックを停止して、データベースを整合性のある状態にします:
    Bash
    cd /opt/qubix && docker compose down
  2. アクティベーションコードを再発行します。 my.qubix.pro キャビネット → お使いの ライセンス → Reissue code を開きます。古いハードウェアの紐付けが解除され、新しい アクティベーションコードが発行されます。これをコピーしてください。
  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 でスタックを停止しているため、データベースはクリーンにシャットダウンされ、その ファイルは整合性が取れています。単純なコピーで十分で、別途データベースのダンプは必要 ありません。Web サーバーの構成は初回起動時に自動的に再構築されるため、他にコピーする ものはありません。
  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 ライセンスをアクティベートする。

サブスクリプションの有効期限

ライセンスが期限切れになったときに何が起こるか。

On this page