ONTAP toolsの導入エラーのトラブルシューティング
変更を提案
PDF
デプロイメントで問題が発生した場合は、ログとエラーコードを確認して問題を診断し、解決してください。ONTAP tools for VMware vSphere 10.5以降、ポッドから収集されるログバンドルには、MongoDB、RabbitMQ、Vaultのログに加え、すべてのポッドのステータスと説明が含まれます。これらは既存のONTAP toolsサービスログに加えて提供され、サポート性とトラブルシューティング性が向上します。
ログ ファイルの収集
ONTAP tools for VMware vSphere のログファイルは、ONTAP tools Manager ユーザーインターフェイスで使用可能なオプションから収集できます。テクニカルサポート担当者から、問題解決のためにログファイルの収集を依頼される場合があります。
|
ONTAP tools Managerからログを生成すると、すべてのvCenter Serverインスタンスのすべてのログが含まれます。vCenter Clientユーザーインターフェイスからログを生成すると、選択したvCenter Serverに対してスコープされます。 |
-
Web ブラウザから ONTAP tools Manager を起動します：
https://<ONTAPtoolsIP>:8443/virtualization/ui/ -
デプロイ時に指定した ONTAP tools for VMware vSphere の管理者認証情報を使用してログインします。
-
サイドバーから Log Bundles を選択します。
この処理には数分かかることがあります。
-
ログファイルを生成するには、*生成*を選択してください。
-
ログバンドルのラベルを入力し、Generate を選択します。
tar.gzファイルをダウンロードして、テクニカルサポートに送信してください。
vCenter クライアントユーザーインターフェースを使用してログバンドルを生成するには、以下の手順に従ってください：
-
vSphere クライアントにログインします。
-
vSphere Client のホームページで、サポート > ログバンドル > 生成 に移動します。
-
ログバンドルラベルを指定して、ログバンドルを生成します。ファイルが生成されると、ダウンロードオプションが表示されます。ダウンロードには時間がかかる場合があります。
|
|
生成されたログバンドルは、過去3日間または72時間以内に生成されたログバンドルを置き換えます。 |
展開エラーコード
ONTAP tools for VMware vSphere の導入、再起動、およびリカバリ操作中にエラーコードが表示される場合があります。エラーコードは5桁で、最初の2桁は問題が発生したスクリプトを表し、最後の3桁はそのスクリプト内の特定のワークフローを表します。
すべてのエラーログは、問題の追跡と解決を容易にするため、/var/log ディレクトリ内の ansible-perl-errors.log ファイルに記録されます。このログファイルには、エラーコードと失敗した Ansible タスクが含まれています。
|
|
このページに記載されているエラーコードは参考情報としてのみご利用ください。エラーが解消されない場合、または解決策が記載されていない場合は、サポートチームにお問い合わせください。 |
以下の表は、エラーコードとそれに対応するファイル名を示しています。
エラーコード |
スクリプト名 |
00 |
firstboot-network-config.pl、mode deploy |
01 |
firstboot-network-config.pl、mode upgrade |
02 |
firstboot-inputs-validation.pl |
03 |
firstboot-deploy-otv-ng.pl、デプロイ、HA |
04 |
firstboot-deploy-otv-ng.pl、デプロイ、非 HA |
05 |
firstboot-deploy-otv-ng.pl、再起動 |
06 |
firstboot-deploy-otv-ng.pl、アップグレード、HA |
07 |
firstboot-deploy-otv-ng.pl、アップグレード、非HA |
08 |
firstboot-otv-recovery.pl |
09 |
post-deploy-upgrade.pl |
エラーコードの最後の3桁は、スクリプト内の具体的なワークフローエラーを示します。
デプロイメントエラーコード |
ワークフロー |
解決 |
049 |
ネットワークと検証用の Perl スクリプトも間もなくそれらを割り当てます。 |
- |
050 |
SSHキーの生成に失敗しました |
プライマリ仮想マシン（VM）を再起動します。 |
053 |
RKE2のインストールに失敗しました |
以下のコマンドを実行してプライマリ VM を再起動するか、再デプロイしてください：sudo rke2-killall.sh (すべての VM) sudo rke2-uninstall.sh (すべての VM)。 |
054 |
kubeconfigの設定に失敗しました |
再導入 |
055 |
レジストリのデプロイに失敗しました |
レジストリポッドが存在する場合は、ポッドの準備が整うまで待ってから、プライマリ VM を再起動するか、再デプロイしてください。 |
059 |
KubeVip のデプロイに失敗しました |
Kubernetes コントロール プレーンの仮想 IP アドレスと、導入時に指定した ONTAP tools の IP アドレスが同じ VLAN に属し、使用可能な IP アドレスであることを確認します。前述の項目がすべて正しければ、再起動してください。そうでない場合は、再導入してください。 |
060 |
オペレーターの展開に失敗しました |
再起動 |
061 |
サービスのデプロイに失敗しました |
Kubernetes の基本的なデバッグ（get pods、get rs、get svc など）を ntv-system 名前空間で実行し、詳細とエラーログを /var/log/ansible-perl-errors.log および /var/log/ansible-run.log で確認してから再デプロイしてください。 |
062 |
ONTAP tools サービスのデプロイに失敗しました |
詳細については、/var/log/ansible-perl-errors.log にあるエラーログを参照し、再デプロイしてください。 |
065 |
SwaggerページのURLにアクセスできません |
再導入 |
066 |
ゲートウェイ証明書のデプロイ後の手順が失敗しました |
アップグレードを復旧／完了するには、次の手順を実行します。
|
088 |
journald のログローテーションの設定に失敗しました |
VMがホストされているホストと互換性のあるVMネットワーク設定を確認してください。別のホストに移行して、VMを再起動してみてください。 |
089 |
サマリーログローテーション設定ファイルの所有権変更に失敗しました |
プライマリVMを再起動します。 |
096 |
動的ストレージプロビジョナーをインストールする |
- |
108 |
シードスクリプトが失敗しました |
- |
114 |
MongoDBコレクションの内部証明書更新が失敗しました |
デプロイがエラーコード114で失敗した場合は、以下の手順を実行してください：
|
再起動エラーコード |
ワークフロー |
解決 |
067 |
rke2-serverの待機がタイムアウトしました。 |
- |
101 |
メンテナンス/コンソールユーザーのパスワードのリセットに失敗しました。 |
- |
102 |
メンテナンス/コンソールユーザーのパスワードリセット中に、パスワードファイルの削除に失敗しました。 |
- |
103 |
保管庫内の新しいメンテナンス/コンソールユーザーのパスワードの更新に失敗しました。 |
- |
088 |
journald のログローテーションの設定に失敗しました。 |
VMがホストされているホストと互換性のあるVMネットワーク設定を確認してください。別のホストに移行して、VMを再起動してみてください。 |
089 |
サマリーログローテーション設定ファイルの所有権変更に失敗しました。 |
仮想マシンを再起動してください。 |