第15章 トラブルシューティング
Assisted Installer がインストールを開始できない場合や、クラスターが正しくインストールされない場合があります。これらのイベントでは、可能性のある障害モードと、障害のトラブルシューティング方法を理解しておくと役に立ちます。
15.1. 検出 ISO の問題のトラブルシューティング リンクのコピーリンクがクリップボードにコピーされました!
Assisted Installer は、ISO イメージを使用して、ホストをクラスターに登録し、OpenShift のインストールを試行する前にハードウェアとネットワークの検証を実行するエージェントを実行します。以下の手順に従って、ホスト検出に関連する問題をトラブルシューティングできます。
検出 ISO イメージを使用してホストを起動すると、Assisted Installer がホストを検出し、Assisted Service Web コンソールに表示します。詳細は、検出イメージの設定 を参照してください。
15.1.1. 検出エージェントが実行されていることを確認する リンクのコピーリンクがクリップボードにコピーされました!
前提条件
- API を使用してインフラストラクチャー環境を作成したか、Web コンソールを使用してクラスターを作成している。
- インフラストラクチャー環境検出 ISO を使用してホストを起動したがホストの登録に失敗する。
- ホストに SSH アクセスできる。
- パスワードなしでマシンに SSH 接続できるように、Discovery ISO を生成する前に "Add hosts" ダイアログで SSH 公開キーを指定した。
手順
- ホストマシンの電源が入っていることを確認します。
- DHCP ネットワーク を選択した場合は、DHCP サーバーが有効になっていることを確認します。
- 静的 IP、ブリッジ、および結合 ネットワーキングを選択した場合は、設定が正しいことを確認してください。
SSH、BMC などのコンソール、または仮想マシンコンソールを使用してホストマシンにアクセスできることを確認します。
ssh core@<host_ip_address>
$ ssh core@<host_ip_address>Copy to Clipboard Copied! Toggle word wrap Toggle overflow デフォルトディレクトリーに格納されていない場合は、
-iパラメーターを使用して秘密鍵ファイルを指定できます。ssh -i <ssh_private_key_file> core@<host_ip_address>
$ ssh -i <ssh_private_key_file> core@<host_ip_address>Copy to Clipboard Copied! Toggle word wrap Toggle overflow SSH 経由でホストに接続できない場合は、ホストの起動中に失敗したか、ネットワークの設定に失敗しました。
ログインすると、次のメッセージが表示されます。
ログイン例
このメッセージが表示されない場合は、ホストが Assisted Installer ISO イメージを使用して起動しなかったことを意味します。起動順序を正しく設定したことを確認してください (ホストは live-ISO から 1 回起動する必要があります)。
エージェントサービスログを確認します。
sudo journalctl -u agent.service
$ sudo journalctl -u agent.serviceCopy to Clipboard Copied! Toggle word wrap Toggle overflow 次の例のエラーは、ネットワークに問題があることを示しています。
エージェントサービスログの例: エージェントサービスログのスクリーンショット
エージェントイメージのプルでエラーが発生した場合は、プロキシー設定を確認してください。ホストがネットワークに接続されていることを確認します。
nmcliを使用して、ネットワーク設定に関する追加情報を取得できます。
15.1.2. エージェントが assisted-service にアクセスできることを確認する リンクのコピーリンクがクリップボードにコピーされました!
前提条件
- API を使用してインフラストラクチャー環境を作成したか、Web コンソールを使用してクラスターを作成している。
- インフラストラクチャー環境検出 ISO を使用してホストを起動したがホストの登録に失敗する。
- 検出エージェントが実行されていることを確認した。
手順
エージェントログをチェックして、エージェントが Assisted Service にアクセスできることを確認します。
sudo journalctl TAG=agent
$ sudo journalctl TAG=agentCopy to Clipboard Copied! Toggle word wrap Toggle overflow 次の例のエラーは、エージェントが Assisted Service へのアクセスに失敗したことを示しています。
エージェントログの例
クラスター用に設定したプロキシー設定を確認します。設定されている場合、プロキシーは Assisted Service URL へのアクセスを許可する必要があります。