TiUPを使用してTiDBをアップグレードする

このドキュメントは、次のアップグレードパスを対象としています。

• TiDB4.0バージョンからTiDB5.4バージョンにアップグレードします。
• TiDB5.0バージョンからTiDB5.4バージョンにアップグレードします。
• TiDB5.1バージョンからTiDB5.4バージョンにアップグレードします。
• TiDB5.2バージョンからTiDB5.4バージョンにアップグレードします。
• TiDB5.3バージョンからTiDB5.4バージョンにアップグレードします。

ノート：

アップグレードするクラスタがv3.1以前のバージョン（v3.0またはv2.1）の場合、v5.4またはそのパッチバージョンへの直接アップグレードはサポートされていません。最初にクラスタをv4.0にアップグレードし、次にv5.4にアップグレードする必要があります。

アップグレードの警告

• TiDBは現在、バージョンのダウングレードまたはアップグレード後の以前のバージョンへのロールバックをサポートしていません。
• TiDB Ansibleを使用して管理されるv4.0クラスタの場合、 TiUP（v4.0）を使用してTiDBをアップグレードするに従って新しい管理を行うために、クラスタをTiUP（ tiup cluster ）にインポートする必要があります。次に、このドキュメントに従って、クラスタをv5.4またはそのパッチバージョンにアップグレードできます。
• 3.0より前のバージョンを5.4に更新するには：
  1. TiDB Ansibleを使用してこのバージョンを3.0に更新します。
  2. TiUP（ tiup cluster ）を使用して、TiDBAnsible構成をインポートします。
  3. TiUP（v4.0）を使用してTiDBをアップグレードするに従って3.0バージョンを4.0に更新します。
  4. このドキュメントに従って、クラスタをv5.4にアップグレードします。
• TiDB Binlog、TiCDC、TiFlash、およびその他のコンポーネントのバージョンのアップグレードをサポートします。
• 異なるバージョンの互換性の変更の詳細については、各バージョンのリリースノートを参照してください。対応するリリースノートの「互換性の変更」セクションに従って、クラスタ構成を変更します。
• v5.3より前のバージョンからv5.3以降のバージョンにアップグレードするクラスターの場合、デフォルトでデプロイされているPrometheusはv2.8.1からv2.27.1にアップグレードされます。 Prometheus v2.27.1は、より多くの機能を提供し、セキュリティの問題を修正します。 v2.8.1と比較して、v2.27.1のアラート時間の表現が変更されています。詳細については、 プロメテウスコミットを参照してください。

準備

このセクションでは、TiUPおよびTiUPクラスターコンポーネントのアップグレードを含む、TiDBクラスタをアップグレードする前に必要な準備作業を紹介します。

ステップ1：TiUPまたはTiUPオフラインミラーをアップグレードする

TiDBクラスタをアップグレードする前に、まずTiUPまたはTiUPミラーをアップグレードする必要があります。

TiUPとTiUPクラスターをアップグレードする

ノート：

アップグレードするクラスタの制御マシンがhttps://tiup-mirrors.pingcap.comにアクセスできない場合は、このセクションをスキップしてTiUPオフラインミラーをアップグレードするを参照してください。

1. TiUPバージョンをアップグレードします。 TiUPのバージョンは1.9.0以降にすることをお勧めします。

   tiup update --self
   tiup --version
   

2. TiUPクラスターのバージョンをアップグレードします。 TiUPクラスターのバージョンは1.9.0以降にすることをお勧めします。

   tiup update cluster
   tiup cluster --version
   

TiUPオフラインミラーをアップグレードする

ノート：

アップグレードするクラスタがオフライン方式を使用せずにデプロイされた場合は、この手順をスキップしてください。

TiUPを使用してTiDBクラスターをデプロイする-TiUPをオフラインでデプロイを参照して、新しいバージョンのTiUPミラーをダウンロードし、制御マシンにアップロードします。 local_install.shを実行した後、TiUPは上書きアップグレードを完了します。

tar xzvf tidb-community-server-${version}-linux-amd64.tar.gz
sh tidb-community-server-${version}-linux-amd64/local_install.sh
source /home/tidb/.bash_profile

上書きアップグレード後、次のコマンドを実行してTiUPクラスターコンポーネントをアップグレードします。

tiup update cluster

これで、オフラインミラーが正常にアップグレードされました。上書き後のTiUP動作中にエラーが発生した場合は、 manifestが更新されていない可能性があります。 TiUPを再度実行する前にrm -rf ~/.tiup/manifests/*を試すことができます。

ステップ2：TiUPトポロジー構成ファイルを編集する

ノート：

次のいずれかの状況が当てはまる場合は、この手順をスキップしてください。

• 元のクラスタの構成パラメーターは変更していません。または、 tiup clusterを使用して構成パラメーターを変更しましたが、それ以上の変更は必要ありません。
• アップグレード後、変更されていない構成アイテムにv5.4のデフォルトのパラメーター値を使用する必要があります。

1. vi編集モードに入り、トポロジファイルを編集します。

   tiup cluster edit-config <cluster-name>
   

2. トポロジーの構成テンプレートの形式を参照し、トポロジーファイルのserver_configsのセクションに変更するパラメーターを入力します。

3. 変更後、 ： + w + qと入力して変更を保存し、編集モードを終了します。 Yを入力して、変更を確認します。

ノート：

クラスタをv5.4にアップグレードする前に、v4.0で変更したパラメーターがv5.4で互換性があることを確認してください。詳細については、 TiKVConfiguration / コンフィグレーションファイルを参照してください。

次の3つのTiKVパラメータは、TiDBv5.0では廃止されています。元のクラスタで次のパラメーターが構成されている場合は、これらのパラメーターをedit-configから削除する必要があります。

• 悲観的-txn.enabled
• server.request-batch-enable-cross-command
• server.request-batch-wait-duration

ステップ3：現在のクラスタのヘルスステータスを確認する

アップグレード中の未定義の動作やその他の問題を回避するために、アップグレードの前に現在のクラスタのリージョンのヘルスステータスを確認することをお勧めします。これを行うには、 checkサブコマンドを使用できます。

tiup cluster check <cluster-name> --cluster

コマンド実行後、「リージョンステータス」チェック結果が出力されます。

• 結果が「すべてのリージョンは正常です」の場合、現在のクラスタのすべてのリージョンは正常であり、アップグレードを続行できます。
• 結果が「リージョンが完全に正常ではない：mミスピア、n保留中ピア」の場合、「他の操作の前に異常なリージョンを修正してください」。プロンプト、現在のクラスタの一部のリージョンが異常です。チェック結果が「すべてのリージョンが正常である」になるまで、異常のトラブルシューティングを行う必要があります。その後、アップグレードを続行できます。

TiDBクラスタをアップグレードする

このセクションでは、TiDBクラスタをアップグレードし、アップグレード後にバージョンを確認する方法について説明します。

TiDBクラスタを指定されたバージョンにアップグレードします

オンラインアップグレードとオフラインアップグレードの2つの方法のいずれかでクラスタをアップグレードできます。

デフォルトでは、TiUPクラスターはオンライン方式を使用してTiDBクラスタをアップグレードします。つまり、TiDBクラスタはアップグレードプロセス中に引き続きサービスを提供できます。オンライン方式では、アップグレードして再起動する前に、各ノードでリーダーが1つずつ移行されます。したがって、大規模なクラスタの場合、アップグレード操作全体を完了するのに長い時間がかかります。

アプリケーションにメンテナンスのためにデータベースを停止するためのメンテナンスウィンドウがある場合は、オフラインアップグレード方法を使用して、アップグレード操作をすばやく実行できます。

オンラインアップグレード

tiup cluster upgrade <cluster-name> <version>

たとえば、クラスタをv5.4.2にアップグレードする場合は、次のようにします。

tiup cluster upgrade <cluster-name> v5.4.2

ノート：

• オンラインアップグレードでは、すべてのコンポーネントが1つずつアップグレードされます。 TiKVのアップグレード中、TiKVインスタンスのすべてのリーダーは、インスタンスを停止する前に削除されます。デフォルトのタイムアウト時間は5分（300秒）です。このタイムアウト時間の後、インスタンスは直接停止します。

• --forceパラメーターを使用すると、リーダーを削除せずにクラスタをすぐにアップグレードできます。ただし、アップグレード中に発生したエラーは無視されます。つまり、アップグレードの失敗は通知されません。したがって、 --forceパラメータは注意して使用してください。

• 安定したパフォーマンスを維持するには、インスタンスを停止する前に、TiKVインスタンスのすべてのリーダーが削除されていることを確認してください。 --transfer-timeoutをより大きな値（たとえば、 --transfer-timeout 3600 （単位：秒））に設定できます。

• TiFlashを5.3より前のバージョンから5.3以降にアップグレードするには、TiFlashを停止してからアップグレードする必要があります。次の手順は、他のコンポーネントを中断せずにTiFlashをアップグレードするのに役立ちます。
  1. TiFlashインスタンスを停止します： tiup cluster stop <cluster-name> -R tiflash
  2. TiDBクラスタを再起動せずにアップグレードします（ファイルの更新のみ）： tiup cluster upgrade <cluster-name> <version> --offline
  3. TiDBクラスタをリロードします： tiup cluster reload <cluster-name> 。リロード後、TiFlashインスタンスが開始され、手動で開始する必要はありません。

オフラインアップグレード

1. オフラインアップグレードの前に、まずクラスタ全体を停止する必要があります。

   tiup cluster stop <cluster-name>
   

2. オフラインアップグレードを実行するには、 upgradeコマンドと--offlineオプションを使用します。

   tiup cluster upgrade <cluster-name> <version> --offline
   

3. アップグレード後、クラスタは自動的に再起動されません。再起動するには、 startコマンドを使用する必要があります。

   tiup cluster start <cluster-name>
   

クラスタのバージョンを確認する

displayコマンドを実行して、最新のクラスタバージョンTiDB Versionを表示します。

tiup cluster display <cluster-name>

Cluster type:       tidb
Cluster name:       
Cluster version:    v5.4.2

ノート：

デフォルトでは、TiUPとTiDBは使用法の詳細をPingCAPと共有して、製品を改善する方法を理解するのに役立ちます。共有される内容と共有を無効にする方法の詳細については、 テレメトリーを参照してください。

FAQ

このセクションでは、TiUPを使用してTiDBクラスタを更新するときに発生する一般的な問題について説明します。

エラーが発生してアップグレードが中断された場合、このエラーを修正した後にアップグレードを再開するにはどうすればよいですか？

tiup cluster upgradeコマンドを再実行して、アップグレードを再開してください。アップグレード操作は、以前にアップグレードされたノードを再起動します。アップグレードされたノードを再起動したくない場合は、 replayサブコマンドを使用して操作を再試行してください。

1. tiup cluster auditを実行して、操作レコードを確認します。

   tiup cluster audit
   

   失敗したアップグレード操作レコードを見つけて、この操作レコードのIDを保持します。 IDは、次のステップの<audit-id>の値です。

2. tiup cluster replay <audit-id>を実行して、対応する操作を再試行します。

   tiup cluster replay <audit-id>
   

エビクトリーダーはアップグレード中にあまりにも長い間待っていました。クイックアップグレードのためにこのステップをスキップするにはどうすればよいですか？

--forceを指定できます。その後、PDリーダーの転送とTiKVリーダーの削除のプロセスは、アップグレード中にスキップされます。クラスタを直接再起動してバージョンを更新します。これは、オンラインで実行されるクラスタに大きな影響を与えます。コマンドは次のとおりです。

tiup cluster upgrade <cluster-name> <version> --force

TiDBクラスタをアップグレードした後にpd-ctlなどのツールのバージョンを更新するにはどうすればよいですか？

TiUPを使用してツールのバージョンをアップグレードし、対応するバージョンのctlつのコンポーネントをインストールできます。

tiup install ctl:v5.4.2

TiDB5.4の互換性の変更

• 互換性の変更については、TiDB5.4リリースノートを参照してください。
• TiDB Binlogを使用してクラスターにローリング更新を適用する場合は、新しいクラスター化インデックステーブルの作成を避けてください。