第5章 インストールログの収集
OpenShift Container Platform のインストールした場合のトラブルシューティングのために、ブートストラップおよびコントロールプレーン、またはマスター、マシンからログを収集できます。
前提条件
- OpenShift Container Platform クラスターのインストールを試みたが、インストールに失敗している。
-
SSH キーをインストールプログラムに指定しており、そのキーは実行中の
ssh-agent
プロセスにある。
5.1. 失敗したインストールのログの収集
SSH キーをインストールプログラムに指定している場合、失敗したインストールについてのデータを収集することができます。
実行中のクラスターからログを収集する場合とは異なるコマンドを使用して失敗したインストールについてのログを収集します。実行中のクラスターからログを収集する必要がある場合は、oc adm must-gather
コマンドを使用します。
前提条件
- OpenShift Container Platform のインストールがブートストラッププロセスの終了前に失敗している。ブートストラップノードは実行中であり、SSH でアクセスできる必要がある。
-
ssh-agent
プロセスはコンピューター上でアクティブであり、ssh-agent
プロセスとインストールプログラムの両方に同じ SSH キーを提供している。 - 独自にプロビジョニングしたインフラストラクチャーにクラスターのインストールを試行した場合には、コントロールプレーン、またはマスター、マシンの完全修飾ドメイン名があること。
手順
ブートストラップおよびコントロールプレーンマシンからインストールログを収集するために必要なコマンドを生成します。
インストーラーでプロビジョニングされるインフラストラクチャーを使用している場合は、以下のコマンドを実行します。
$ ./openshift-install gather bootstrap --dir=<directory> 1
- 1
installation_directory
は、インストールプログラムが作成する OpenShift Container Platform 定義ファイルを保存しているディレクトリーです。
インストーラーでプロビジョニングされるインフラストラクチャーの場合、インストールプログラムは、ホスト名または IP アドレスを指定しなくてもよいようにクラスターについての情報を保存します。
独自にプロビジョニングしたインフラストラクチャーを使用している場合は、以下のコマンドを実行します。
$ ./openshift-install gather bootstrap --dir=<directory> \ 1 --bootstrap <bootstrap_address> \ 2 --master "<master_address> <master_address> <master_address>" 3
コマンド出力は以下の例のようになります。
INFO Use the following commands to gather logs from the cluster INFO ssh -A core@<bootstrap_address> '/usr/local/bin/installer-gather.sh <master_address> <master_address> <master_address>' INFO scp core@<bootstrap_address>:~/log-bundle.tar.gz .
表示される両方のコマンドを使用し、ログを収集し、ダウンロードします。
ブートストラップおよびマスターマシンからログを収集します。
$ ssh -A core@<bootstrap_address> '/usr/local/bin/installer-gather.sh <master_address> <master_address> <master_address>'
SSH をブートストラップマシンに対して実行し、クラスター内のブートストラップおよびコントロールプレーンマシンからできる限り多くのデータを収集することを目的に設計された収集ツールを実行します。 その後に収集されたファイルすべてを圧縮します。
注記通常、コマンド出力にエラーが表示されることがあります。コマンド出力に、圧縮されたログファイル
log-bundle.tar.gz
のダウンロード方法についての説明が表示される場合、コマンドは問題なく実行されたことを示します。ログが含まれる圧縮ファイルをダウンロードします。
$ scp core@<bootstrap_address>:~/log-bundle.tar.gz . 1
- 1
<bootstrap_address>
は、ブートストラップマシンの完全修飾ドメイン名または IP アドレスです。
ログファイルをダウンロードするためのコマンドは、収集コマンドの出力の末尾に含まれます。
インストールの失敗についての Red Hat サポートケースを作成する場合は、圧縮したログをケースに含めるようにしてください。