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 は指定された秘密鍵を使用してリモート ホストにログインできない可能性があります。3 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 チームは、移行プロセス中に不足しているコンポーネントを完成させます。