第1章 問題の診断
Ansible Automation Platform のトラブルシューティングを開始するには、OpenShift Container Platform の must-gather コマンドまたは仮想マシンベースのインストールの sos ユーティリティーを使用して、設定と診断情報を収集します。これらのユーティリティーの出力をサポートケースに添付できます。
1.1. must-gather コマンドを使用した OpenShift Container Platform 上の Ansible Automation Platform のトラブルシューティング リンクのコピーリンクがクリップボードにコピーされました!
oc adm must-gather コマンドラインインターフェイス (CLI) コマンドは、OpenShift Container Platform にデプロイされた Ansible Automation Platform インストールから情報を収集します。リソース定義やサービスログなど、問題のデバッグに必要となることが多い情報を収集します。
oc adm must-gather CLI コマンドを実行すると、収集されたデータを含む新しいディレクトリーが作成され、トラブルシューティングやサポートケースへの添付に使用できます。
OpenShift 環境が registry.redhat.io にアクセスできず、must-gather コマンドを実行できない場合は、代わりに oc adm inspect コマンドを実行します。
前提条件
-
OpenShift CLI (
oc) がインストールされている。
手順
クラスターにログインします。
oc login <openshift_url>クラスター内のアクセスレベルに基づいて、次のいずれかのコマンドを実行します。
クラスター全体で
must-gatherを実行します。oc adm must-gather --image=registry.redhat.io/ansible-automation-platform-24/aap-must-gather-rhel8 --dest-dir <dest_dir>-
--imageはデータを収集するイメージを指定する -
--dest-dirは出力先のディレクトリーを指定する
-
クラスター内の特定の namespace に対して
must-gatherを実行します。oc adm must-gather --image=registry.redhat.io/ansible-automation-platform-24/aap-must-gather-rhel8 --dest-dir <dest_dir> – /usr/bin/ns-gather <namespace>-
– /usr/bin/ns-gatherは、must-gatherデータ収集を指定された namespace に制限する
-
must-gatherアーカイブをサポートケースに添付するには、以前に作成したmust-gatherディレクトリーから圧縮ファイルを作成し、サポートケースに添付します。たとえば、Linux オペレーティングシステムを使用するコンピューターでは、
<must-gather-local.5421342344627712289/>をmust-gatherディレクトリー名に置き換えて、次のコマンドを実行します。$ tar cvaf must-gather.tar.gz <must-gather.local.5421342344627712289/>