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

アップグレード

概要​

このガイドでは、ストレージ-コンピュート分離アーキテクチャ（Cloud Modeとも呼ばれる）を使用してDorisをアップグレードするための手順を段階的に説明します。アップグレードは、クラスタアップグレードにおいて本セクションの推奨手順に従って実行する必要があります。Dorisクラスタのアップグレードはローリングアップグレード方式を使用して実行でき、アップグレード時にすべてのクラスタノードをシャットダウンする必要がないため、アプリケーションへの影響を大幅に最小限に抑えることができます。

Dorisバージョンの説明​

Dorisはドットで区切られた3つの数字のバージョン形式を使用しており、以下のSQLを使用して確認できます:

MySQL [(none)]> select @@version_comment;
+--------------------------------------------------------+
| @@version_comment                                      |
+--------------------------------------------------------+
| Doris version doris-3.0.3-rc03-43f06a5e26 (Cloud Mode) |
+--------------------------------------------------------+

3.0.3の1番目の数字はメジャーバージョン番号、2番目の数字はマイナーバージョン番号、3番目の数字はパッチバージョン番号を表します。場合によっては、バージョン番号が2.0.2.1のような4桁形式になることがあります。この場合、最後の数字は緊急バグ修正バージョンを示し、通常はこのパッチバージョンに重大なバグがあることを意味します。

Dorisはバージョン3.0.0からクラウドモードでの展開をサポートしています。このモードで展開された場合、バージョン番号にCloud Modeサフィックスが付きます。統合されたストレージとコンピュート（Local）モードで起動された場合、そのようなサフィックスは付きません。

Dorisをクラウドモードでいったんデプロイするとローカルモードへ切り替えることはサポートされていません。同様に、ローカルモードのDorisもクラウドモードへの切り替えはサポートされていません。

原則として、Dorisは低いバージョンから高いバージョンへのアップグレードとパッチバージョン間でのダウングレードをサポートしています。マイナーバージョンやメジャーバージョン間でのダウングレードは許可されていません。

アップグレード手順​

アップグレードの注意事項​

  1. Dorisがクラウドモードで起動されていることを確認してください。Dorisの現在のデプロイモードが不明な場合は、前のセクションの説明を参照してください。 ローカルモードのDorisの場合は、アップグレード手順についてCluster Upgradeを参照してください。
  2. Dorisのデータインポートタスクに再試行メカニズムがあることを確認してください。これにより、アップグレード過程でのノード再起動によるタスク失敗を回避できます。
  3. アップグレード前に、すべてのDorisコンポーネント（MetaService、Recycler、Frontend、Backend）のステータスを確認し、正常に動作していて例外ログがないことを確認することをお勧めします。これによりアップグレード過程への影響を回避できます。

アップグレードプロセスの概要​

  1. メタデータのバックアップ
  2. MetaServiceのアップグレード
  3. Recyclerのアップグレード（存在する場合）
  4. BEのアップグレード
  5. FEのアップグレード
    1. 最初にObserver FEをアップグレード
    2. 次に他の非Master FEをアップグレード
    3. 最後にMaster FEをアップグレード

アップグレードの事前作業​

  1. Master FEのメタデータディレクトリをバックアップします。通常、メタデータディレクトリはFEホームディレクトリ下のdoris-metaディレクトリです。このディレクトリが空の場合、メタデータを保存する別のディレクトリを設定していることを意味します。FE設定ファイル（conf/fe.conf）でmeta_dirを検索できます。
  2. Doris公式ウェブサイトからパッケージをダウンロードします。パッケージがDorisによって提供されたものと一致することを確認するため、SHA-512ハッシュの検証を推奨します。

アップグレードプロセス​

1. MetaServiceのアップグレード​

次の環境変数を想定します：

  • ${MS_HOME}: MetaServiceの作業ディレクトリ。
  • ${MS_PACKAGE_DIR}: 新しいMetaServiceパッケージを含むディレクトリ。

各MetaServiceインスタンスをアップグレードするために次の手順に従ってください。

1.1. 現在のMetaServiceを停止します：

cd ${MS_HOME}
sh bin/stop.sh

1.2. 既存のMetaServiceバイナリをバックアップする:

mv ${MS_HOME}/bin bin_backup_$(date +%Y%m%d_%H%M%S)
mv ${MS_HOME}/lib lib_backup_$(date +%Y%m%d_%H%M%S)

1.3. 新しいパッケージをデプロイする：

cp ${MS_PACKAGE_DIR}/bin ${MS_HOME}/bin
cp ${MS_PACKAGE_DIR}/lib ${MS_HOME}/lib

1.4. 新しいMetaServiceを開始します：

sh ${MS_HOME}/bin/start.sh --daemon

1.5. 新しいMetaServiceのステータスを確認する：

新しいMetaServiceが実行中であり、${MS_HOME}/log/doris_cloud.outに新しいバージョン番号が存在することを確認してください。

2. Recyclerのアップグレード（存在する場合）​

注意

Recyclerコンポーネントを個別にデプロイしていない場合は、この手順をスキップできます。

以下の環境変数を想定しています：

  • ${RECYCLER_HOME}：Recyclerの作業ディレクトリ
  • ${MS_PACKAGE_DIR}：新しいMetaServiceパッケージを含むディレクトリ、MetaServiceとRecyclerは同じパッケージを使用します。

以下の手順に従って各Recyclerインスタンスをアップグレードしてください。

2.1. 現在のRecyclerを停止する：

cd ${RECYCLER_HOME}
sh bin/stop.sh

2.2. 既存のRecyclerバイナリファイルをバックアップする：

mv ${RECYCLER_HOME}/bin bin_backup_$(date +%Y%m%d_%H%M%S)
mv ${RECYCLER_HOME}/lib lib_backup_$(date +%Y%m%d_%H%M%S)

2.3. 新しいpackageをデプロイする：

cp ${RECYCLER_PACKAGE_DIR}/bin ${RECYCLER_HOME}/bin
cp ${RECYCLER_PACKAGE_DIR}/lib ${RECYCLER_HOME}/lib

2.4. 新しいRecyclerを開始する:

sh ${RECYCLER_HOME}/bin/start.sh --recycler --daemon

2.5. 新しいRecyclerのステータスを確認する：

新しいMetaServiceが動作していること、および${RECYCLER_HOME}/log/doris_cloud.outに新しいバージョン番号が存在することを確認してください。

3. BEのアップグレード​

MetaServiceとRecycler（別途インストールされている場合）のすべてのインスタンスがアップグレードされていることを確認してください。

以下の環境変数を想定します：

  • ${BE_HOME}：BEの作業ディレクトリ。
  • ${BE_PACKAGE_DIR}：新しいBEパッケージを含むディレクトリ。

以下の手順に従って各BEインスタンスをアップグレードします。

3.1. 現在のBEを停止する：

cd ${BE_HOME}
sh bin/stop_be.sh

3.2. 既存のBEバイナリをバックアップする：

mv ${BE_HOME}/bin bin_backup_$(date +%Y%m%d_%H%M%S)
mv ${BE_HOME}/lib lib_backup_$(date +%Y%m%d_%H%M%S)

3.3. 新しいパッケージをデプロイする:

cp ${BE_PACKAGE_DIR}/bin ${BE_HOME}/bin
cp ${BE_PACKAGE_DIR}/lib ${BE_HOME}/lib

3.4. 新しいBEを開始する：

sh ${BE_HOME}/bin/start_be.sh --daemon

3.5. 新しいBEのステータスを確認する：

新しいBEが新しいバージョンで実行され、動作していることを確認してください。ステータスとバージョンは以下のSQLを使用して取得できます。

show backends;

4. FEをアップグレードする​

BEのすべてのインスタンスがアップグレードされていることを確認してください。

以下の環境変数を想定します：

  • ${FE_HOME}: FEの作業ディレクトリ。
  • ${FE_PACKAGE_DIR}: 新しいFEパッケージを含むディレクトリ。

Frontend (FE) インスタンスを以下の順序でアップグレードします：

  1. Observer FEノード
  2. Non-master FEノード
  3. Master FEノード

以下の手順に従って各Frontend (FE) ノードをアップグレードします。

4.1. 現在のFEを停止する：

cd ${FE_HOME}
sh bin/stop_fe.sh

4.2. 既存のFEバイナリをバックアップする：

mv ${FE_HOME}/bin bin_backup_$(date +%Y%m%d_%H%M%S)
mv ${FE_HOME}/lib lib_backup_$(date +%Y%m%d_%H%M%S)

4.3. 新しいpackageをデプロイする：

cp ${FE_PACKAGE_DIR}/bin ${FE_HOME}/bin
cp ${FE_PACKAGE_DIR}/lib ${FE_HOME}/lib

4.4. 新しいFEを開始する:

sh ${FE_HOME}/bin/start_fe.sh --daemon

4.5. 新しいFEのステータスを確認する:

新しいFEが新しいバージョンで稼働し、動作していることを確認します。ステータスとバージョンは以下のSQLを使用して取得できます。

show frontends;

FAQ​

  1. ローカルモードのDorisでは、アップグレード前にレプリカバランス機能を無効にする必要がありますか？また、クラウドモードのクラスターでも必要ですか？

いいえ。クラウドモードでは、データはHDFSまたはS3サービスに保存されるため、レプリカバランスは不要です。

  1. 独立したMetaServiceがメタデータサービスを提供しているのに、なぜFEのメタデータをバックアップする必要があるのですか？

現在、MetaServiceが一部のメタデータを保存し、FEも一部のメタデータを保存しているためです。安全上の理由から、FEのメタデータをバックアップすることをお勧めします。

Report issue
ASF
Resources
Community
Join the community
Copyright © 2026 The Apache Software Foundation,Licensed under the Apache License, Version 2.0. Apache, Doris, Apache Doris, the Apache feather logo and the Apache Doris logo are trademarks of The Apache Software Foundation.