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クラスターコンポーネントは指定されたノードのアップグレードをサポートしていないため、アップグレードが失敗した後は、アップグレード プロセス中の冪等操作を含むアップグレード操作を再度実行する必要があります。
アップグレード プロセスは次の手順に分かれています。
- すべてのノード上のコンポーネントの古いバージョンをバックアップします。
- 新しいコンポーネントをリモートに配布する
- すべてのコンポーネントに対してローリング再起動を実行する
ローリング再起動中にアップグレードが中断された場合は、 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チームは、移行プロセス中に不足しているコンポーネントを完成させます。