TiUPトラブルシューティングガイド
このドキュメントでは、 TiUPの使用時によくある問題とそのトラブルシューティング方法について解説します。このドキュメントに記載されていない問題が発生した場合、Github TiUPリポジトリの新しい問題を提出する参照してください。
TiUPコマンドのトラブルシューティング
tiup listを使用して最新のコンポーネントリストを表示できません
TiUPはミラーサーバーから最新のコンポーネントリストを毎回更新するわけではありません。1 tiup list実行することで、コンポーネントリストを強制的に更新できます。
tiup list <component>を使用してコンポーネントの最新バージョン情報を表示できません
前回の問題と同様に、コンポーネントのバージョン情報は、ローカルキャッシュが存在しない場合にのみミラーサーバーから取得されます。1 tiup list <component>実行することでコンポーネントリストを更新できます。
コンポーネントのダウンロードプロセスが中断されました
ネットワークが不安定な場合、コンポーネントのダウンロードプロセスが中断される可能性があります。コンポーネントのダウンロードを再度お試しください。複数回試してもダウンロードできない場合は、CDNサーバーに問題がある可能性がありますので、問題を報告してくださいここ 。
コンポーネントのダウンロードプロセス中にチェックサムエラーが発生しました
CDNサーバーのキャッシュ時間が短いため、新しいチェックサムファイルがコンポーネントパッケージと一致しない可能性があります。5分後に再度ダウンロードをお試しください。それでも新しいチェックサムファイルがコンポーネントパッケージと一致しない場合は、問題ここ報告してください。
TiUPクラスタコンポーネントのトラブルシューティング
unable to authenticate, attempted methods [none publickey]プロンプト表示されます。
デプロイメント中に、コンポーネントパッケージがリモートホストにアップロードされ、初期化が実行されます。このプロセスではリモートホストへの接続が必要です。このエラーは、リモートホストに接続するためのSSH秘密鍵が見つからないために発生します。
この問題を解決するには、 tiup cluster deploy -i identity_file実行して秘密鍵を指定したかどうかを確認します。
-iフラグが指定されていない場合、 TiUP は秘密鍵のパスを自動的に検出しない可能性があります。3-i使用して秘密鍵のパスを明示的に指定することをお勧めします。- フラグ
-iが指定されている場合、 TiUPは指定された秘密鍵を使用してリモートホストにログインできない可能性があります。3コマンドssh -i identity_file user@remote手動で実行することで確認できます。 - リモート ホストへのログインにパスワードを使用する場合は、フラグ
-pを指定して正しいログイン パスワードを入力したことを確認してください。
TiUPクラスタコンポーネントを使用したクラスタのアップグレード プロセスが中断されます
誤用を避けるため、 TiUPクラスターコンポーネントは指定されたノードのアップグレードをサポートしていません。そのため、アップグレードが失敗した後は、アップグレード プロセス中のべき等操作を含むアップグレード操作を再度実行する必要があります。
アップグレード プロセスは次の手順に分けられます。
- すべてのノード上のコンポーネントの古いバージョンをバックアップします
- 新しいコンポーネントをリモートに配布
- すべてのコンポーネントのローリング再起動を実行します
ローリング再起動中にアップグレードが中断された場合は、操作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チームは、移行プロセス中に不足しているコンポーネントを補完します。