TiUP トラブルシューティング ガイド

このドキュメントでは、TiUP を使用する際の一般的な問題とトラブルシューティング方法を紹介します。このドキュメントに遭遇した問題が含まれていない場合は、Github TiUP リポジトリで新しい問題を提出する .

TiUP コマンドのトラブルシューティング

tiup listを使用して最新のコンポーネント リストを表示できない

TiUP は、ミラーサーバーから最新のコンポーネント リストを毎回更新するわけではありません。 tiup listを実行すると、コンポーネント リストを強制的に更新できます。

tiup list <component>を使用してコンポーネントの最新バージョン情報を表示できない

前回同様、コンポーネントのバージョン情報はローカルキャッシュがない場合のみミラーサーバーから取得します。 tiup list <component>を実行すると、コンポーネント リストを更新できます。

コンポーネントのダウンロード プロセスが中断されました

ネットワークが不安定な場合、コンポーネントのダウンロード プロセスが中断される可能性があります。コンポーネントのダウンロードを再試行できます。何度か試してもダウンロードできない場合は、CDNサーバーが原因である可能性があり、問題を報告することができますここ

コンポーネントのダウンロード プロセス中にチェックサム エラーが発生する

CDNサーバーのキャッシュ時間が短いため、新しいチェックサム ファイルがコンポーネント パッケージと一致しない場合があります。 5 分後にもう一度ダウンロードしてみてください。新しいチェックサム ファイルが依然としてコンポーネント パッケージと一致しない場合は、問題を報告してくださいここ

TiUP クラスタ コンポーネントのトラブルシューティング

unable to authenticate, attempted methods [none publickey]は、展開中にプロンプトが表示されます

展開中に、コンポーネント パッケージがリモート ホストにアップロードされ、初期化が実行されます。このプロセスでは、リモート ホストに接続する必要があります。このエラーは、リモート ホストに接続するための SSH 秘密鍵が見つからないために発生します。

この問題を解決するには、 tiup cluster deploy -i identity_fileを実行して秘密鍵を指定したかどうかを確認します。

  • -iフラグが指定されていない場合、TiUP が秘密鍵のパスを自動的に見つけられない可能性があります。 -iを使用して秘密鍵のパスを明示的に指定することをお勧めします。
  • -iフラグが指定されている場合、指定された秘密鍵を使用して TiUP がリモート ホストにログインできない可能性があります。 ssh -i identity_file user@remoteコマンドを手動で実行することで確認できます。
  • パスワードを使用してリモート ホストにログインする場合は、 -pフラグを指定し、正しいログイン パスワードを入力したことを確認してください。

TiUP クラスター コンポーネントを使用したクラスターのアップグレード プロセスが中断されました。

誤用を避けるために、TiUP クラスター コンポーネントは指定されたノードのアップグレードをサポートしていないため、アップグレードが失敗した後は、アップグレード プロセス中のべき等操作を含むアップグレード操作を再度実行する必要があります。

アップグレード プロセスは、次の手順に分けることができます。

  1. すべてのノードで古いバージョンのコンポーネントをバックアップします
  2. 新しいコンポーネントをリモートに配布する
  3. すべてのコンポーネントに対してローリング再起動を実行します

ローリング再起動中にアップグレードが中断された場合、 tiup cluster upgradeの操作を繰り返す代わりに、 tiup cluster restart -N <node1> -N <node2>を使用して、再起動が完了していないノードを再起動できます。

同じコンポーネントの再起動されていないノードの数が比較的多い場合は、 tiup cluster restart -R <component>を実行して特定のタイプのコンポーネントを再起動することもできます。

アップグレード中に、 node_exporter-9100.service/blackbox_exporter-9115.serviceが存在しないことがわかります

以前に TiDB Ansible からクラスターを移行し、エクスポーターが TiDB Ansible にデプロイされていない場合、この状況が発生する可能性があります。それを解決するために、当面の間、不足しているファイルを他のノードから新しいノードに手動でコピーできます。 TiUP チームは、移行プロセス中に不足しているコンポーネントを完成させます。

エコシステム
TiDB
TiKV
TiSpark
Chaos Mesh
© 2022 PingCAP. All Rights Reserved.