メインコンテンツまでスキップ
バージョン: Latest-3.4

Downgrade StarRocks

このトピックでは、StarRocks クラスターをダウングレードする方法について説明します。

StarRocks クラスターをアップグレードした後に例外が発生した場合、クラスターを以前のバージョンにダウングレードして迅速に復旧することができます。

概要​

ダウングレードする前にこのセクションの情報を確認してください。推奨されるアクションを実行してください。

ダウングレードパス​

  • パッチバージョンのダウングレードの場合

    StarRocks クラスターをパッチバージョン間でダウングレードできます。例えば、v2.2.11 から直接 v2.2.6 にダウングレードできます。

  • マイナーバージョンのダウングレードの場合

    互換性と安全性の理由から、StarRocks クラスターをマイナーバージョンごとに順次ダウングレードすることを強くお勧めします。例えば、StarRocks v2.5 クラスターを v2.2 にダウングレードするには、次の順序でダウングレードする必要があります: v2.5.x --> v2.4.x --> v2.3.x --> v2.2.x。

    警告

    StarRocks を v3.3 にアップグレードした後、直接 v3.2.0、v3.2.1、または v3.2.2 にダウングレードしないでください。そうしないとメタデータが失われます。問題を防ぐために、クラスターを v3.2.3 以降にダウングレードする必要があります。

  • メジャーバージョンのダウングレードの場合

    StarRocks v3.0 クラスターを v2.5.3 以降のバージョンにのみダウングレードできます。

    • StarRocks は v3.0 で BDB ライブラリをアップグレードします。ただし、BDBJE はロールバックできません。ダウングレード後は v3.0 の BDB ライブラリを使用する必要があります。
    • v3.0 にアップグレードした後、新しい RBAC 権限システムがデフォルトで使用されます。ダウングレード後も RBAC 権限システムのみを使用できます。

ダウングレード手順​

StarRocks のダウングレード手順は、アップグレード手順の逆順です。したがって、最初に FEs をダウングレードし、その後 BEs と CNs をダウングレードする必要があります。順序を誤ると、FEs と BEs/CNs 間の互換性が失われ、サービスがクラッシュする可能性があります。FE ノードの場合、Leader FE ノードをダウングレードする前に、すべての Follower FE ノードを最初にダウングレードする必要があります。

始める前に​

準備中に、マイナーまたはメジャーバージョンのダウングレードを行う場合は、互換性の設定を行う必要があります。また、クラスター内のすべてのノードをダウングレードする前に、FEs または BEs のいずれかでダウングレードの可用性テストを実行する必要があります。

互換性設定の実行​

StarRocks クラスターを以前のマイナーまたはメジャーバージョンにダウングレードしたい場合は、互換性設定を行う必要があります。一般的な互換性設定に加えて、詳細な設定はダウングレード元の StarRocks クラスターのバージョンに応じて異なります。

  • 一般的な互換性設定

StarRocks クラスターをダウングレードする前に、tablet クローンを無効にする必要があります。バランサーを無効にしている場合は、この手順をスキップできます。

ADMIN SET FRONTEND CONFIG ("tablet_sched_max_scheduling_tablets" = "0");
ADMIN SET FRONTEND CONFIG ("tablet_sched_max_balancing_tablets" = "0");
ADMIN SET FRONTEND CONFIG ("disable_balance"="true");
ADMIN SET FRONTEND CONFIG ("disable_colocate_balance"="true");

ダウングレード後、すべての BE ノードのステータスが Alive になった場合、tablet クローンを再度有効にできます。

ADMIN SET FRONTEND CONFIG ("tablet_sched_max_scheduling_tablets" = "10000");
ADMIN SET FRONTEND CONFIG ("tablet_sched_max_balancing_tablets" = "500");
ADMIN SET FRONTEND CONFIG ("disable_balance"="false");
ADMIN SET FRONTEND CONFIG ("disable_colocate_balance"="false");
  • v2.2 以降のバージョンからダウングレードする場合

FE 設定項目 ignore_unknown_log_id を true に設定します。これは静的パラメータであるため、FE 設定ファイル fe.conf で変更し、ノードを再起動して変更を有効にする必要があります。ダウングレードと最初のチェックポイントが完了した後、false にリセットしてノードを再起動できます。

  • FQDN アクセスを有効にしている場合

FQDN アクセスを有効にしている場合（v2.4 以降でサポート）で、v2.4 より前のバージョンにダウングレードする必要がある場合は、ダウングレード前に IP アドレスアクセスに切り替える必要があります。詳細な手順については、Rollback FQDN を参照してください。

FE のダウングレード​

注記

v3.3.0 以降から v3.2 にクラスターをダウングレードするには、ダウングレード前に次の手順を実行してください。

  1. v3.3 クラスターで開始されたすべての ALTER TABLE SCHEMA CHANGE トランザクションが完了またはキャンセルされていることを確認してください。

  2. 次のコマンドを実行して、すべてのトランザクション履歴をクリアします。

    ADMIN SET FRONTEND CONFIG ("history_job_keep_max_second" = "0");

  3. 次のコマンドを実行して、残っている履歴レコードがないことを確認します。

    SHOW PROC '/jobs/<db>/schema_change';

互換性設定と可用性テストの後、FE ノードをダウングレードできます。最初に Follower FE ノードをダウングレードし、その後 Leader FE ノードをダウングレードする必要があります。

  1. メタデータスナップショットを作成します。

    a. ALTER SYSTEM CREATE IMAGE を実行してメタデータスナップショットを作成します。

    b. Leader FE のログファイル fe.log を確認して、イメージファイルが同期されたかどうかを確認できます。"push image.* from subdir [] to other nodes. totally xx nodes, push successful xx nodes" のようなログ記録があれば、イメージファイルが正常に同期されたことを示しています。

    CAUTION

    ALTER SYSTEM CREATE IMAGE ステートメントは v2.5.3 以降でサポートされています。以前のバージョンでは、Leader FE を再起動してメタデータスナップショットを作成する必要があります。

  2. FE ノードの作業ディレクトリに移動し、ノードを停止します。

    # <fe_dir> を FE ノードのデプロイメントディレクトリに置き換えてください。
    cd <fe_dir>/fe
    ./bin/stop_fe.sh

  3. bin、lib、および spark-dpp の下の元のデプロイメントファイルを以前のバージョンのものに置き換えます。

    mv lib lib.bak 
    mv bin bin.bak
    mv spark-dpp spark-dpp.bak
    cp -r /tmp/StarRocks-x.x.x/fe/lib  .   
    cp -r /tmp/StarRocks-x.x.x/fe/bin  .
    cp -r /tmp/StarRocks-x.x.x/fe/spark-dpp  .

    CAUTION

    StarRocks v3.0 を v2.5 にダウングレードする場合、デプロイメントファイルを置き換えた後に次の手順を実行する必要があります:

    1. v3.0 デプロイメントのファイル fe/lib/starrocks-bdb-je-18.3.13.jar を v2.5 デプロイメントのディレクトリ fe/lib にコピーします。
    2. ファイル fe/lib/je-7.*.jar を削除します。

  4. FE ノードを起動します。

    sh bin/start_fe.sh --daemon

  5. FE ノードが正常に起動したかどうかを確認します。

    ps aux | grep StarRocksFE

  6. 上記のステップ 2 からステップ 5 を繰り返して、他の Follower FE ノードをダウングレードし、最後に Leader FE ノードをダウングレードします。

    CAUTION

    失敗したアップグレード後にクラスターをダウングレードし、再度クラスターをアップグレードしたい場合、例えば、2.5->3.0->2.5->3.0 のように、Follower FEs のメタデータアップグレードの失敗を防ぐために、ステップ 1 を繰り返して新しいスナップショットをトリガーしてください。

BE のダウングレード​

FE ノードをダウングレードした後、クラスター内の BE ノードをダウングレードできます。

  1. BE ノードの作業ディレクトリに移動し、ノードを停止します。

    # <be_dir> を BE ノードのデプロイメントディレクトリに置き換えてください。
    cd <be_dir>/be
    ./bin/stop_be.sh

  2. bin および lib の下の元のデプロイメントファイルを以前のバージョンのものに置き換えます。

    mv lib lib.bak 
    mv bin bin.bak
    cp -r /tmp/StarRocks-x.x.x/be/lib  .
    cp -r /tmp/StarRocks-x.x.x/be/bin  .

  3. BE ノードを起動します。

    sh bin/start_be.sh --daemon

  4. BE ノードが正常に起動したかどうかを確認します。

    ps aux | grep starrocks_be

  5. 上記の手順を繰り返して、他の BE ノードをダウングレードします。

CN のダウングレード​

  1. CN ノードの作業ディレクトリに移動し、ノードを優雅に停止します。

    # <cn_dir> を CN ノードのデプロイメントディレクトリに置き換えてください。
    cd <cn_dir>/be
    ./bin/stop_cn.sh --graceful

  2. bin および lib の下の元のデプロイメントファイルを以前のバージョンのものに置き換えます。

    mv lib lib.bak 
    mv bin bin.bak
    cp -r /tmp/StarRocks-x.x.x/be/lib  .
    cp -r /tmp/StarRocks-x.x.x/be/bin  .

  3. CN ノードを起動します。

    sh bin/start_cn.sh --daemon

  4. CN ノードが正常に起動したかどうかを確認します。

    ps aux | grep  starrocks_be

  5. 上記の手順を繰り返して、他の CN ノードをダウングレードします。