Chapter 1. Diagnosing the problem

Procedure

1. Log in to your cluster:

   oc login <openshift_url>

   Copy to Clipboard Toggle word wrap

2. Run one of the following commands based on your level of access in the cluster:

   • Run must-gather across the entire cluster:

     oc adm must-gather --image=registry.redhat.io/ansible-automation-platform-25/aap-must-gather-rhel8 --dest-dir <dest_dir>

     Copy to Clipboard Toggle word wrap
     • --image specifies the image that gathers data
     • --dest-dir specifies the directory for the output

   • Run must-gather for a specific namespace in the cluster:

     oc adm must-gather --image=registry.redhat.io/ansible-automation-platform-25/aap-must-gather-rhel8 --dest-dir <dest_dir> – /usr/bin/ns-gather <namespace>

     Copy to Clipboard Toggle word wrap
     • – /usr/bin/ns-gather limits the must-gather data collection to a specified namespace

3. To attach the must-gather archive to your support case, create a compressed file from the must-gather directory created before and attach it to your support case.

   • For example, on a computer that uses a Linux operating system, run the following command, replacing <must-gather-local.5421342344627712289/> with the must-gather directory name:

     $ tar cvaf must-gather.tar.gz <must-gather.local.5421342344627712289/>

     Copy to Clipboard Toggle word wrap