第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 キーを提供している。
  • 独自にプロビジョニングしたインフラストラクチャーにクラスターのインストールを試行した場合には、コントロールプレーン、またはマスター、マシンの完全修飾ドメイン名があること。

手順

  1. ブートストラップおよびコントロールプレーンマシンからインストールログを収集するために必要なコマンドを生成します。

    • インストーラーでプロビジョニングされるインフラストラクチャーを使用している場合は、以下のコマンドを実行します。

      $ ./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
      1
      installation_directory は、インストールプログラムが作成する OpenShift Container Platform 定義ファイルを保存しているディレクトリーです。
      2
      <bootstrap_address> は、クラスターのブートストラップマシンの完全修飾ドメイン名または IP アドレスです。
      3
      <master_address> は、クラスター内のコントロールプレーン、またはマスター、マシンの完全修飾ドメイン名または IP アドレスです。クラスター内のすべてのコントロールプレーンマシンが含まれるスペースで区切られた一覧を指定します。

    コマンド出力は以下の例のようになります。

    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 .

    表示される両方のコマンドを使用し、ログを収集し、ダウンロードします。

  2. ブートストラップおよびマスターマシンからログを収集します。

    $ ssh -A core@<bootstrap_address> '/usr/local/bin/installer-gather.sh <master_address> <master_address> <master_address>'

    SSH をブートストラップマシンに対して実行し、クラスター内のブートストラップおよびコントロールプレーンマシンからできる限り多くのデータを収集することを目的に設計された収集ツールを実行します。 その後に収集されたファイルすべてを圧縮します。

    注記

    通常、コマンド出力にエラーが表示されることがあります。コマンド出力に、圧縮されたログファイル log-bundle.tar.gz のダウンロード方法についての説明が表示される場合、コマンドは問題なく実行されたことを示します。

  3. ログが含まれる圧縮ファイルをダウンロードします。

    $ scp core@<bootstrap_address>:~/log-bundle.tar.gz . 1
    1
    <bootstrap_address> は、ブートストラップマシンの完全修飾ドメイン名または IP アドレスです。

    ログファイルをダウンロードするためのコマンドは、収集コマンドの出力の末尾に含まれます。

    インストールの失敗についての Red Hat サポートケースを作成する場合は、圧縮したログをケースに含めるようにしてください。

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.