Chapter 2. Downloading log files and diagnostic information using must-gather

Procedure

• Run the must-gather command from the client connected to the Openshift Container Storage cluster:

  $ oc adm must-gather --image=registry.redhat.io/ocs4/ocs-must-gather-rhel8:v4.5 --dest-dir=<directory-name> --node-name=<node-name>

  where <node-name> is any master node in Ready state.

  Note

  --node-name is optional and needs to be used specifically for situations when either one or more worker nodes are not in Ready state.

  Important

  When OpenShift Container Storage is deployed in external mode, must-gather only collects logs from the Redhat Openshift Container Storage cluster and does not collect debug data and logs from the external Red Hat Ceph Storage cluster. To collect debug logs from the external Red Hat Ceph Storage cluster, see Red Hat Ceph Storage Troubleshooting guide and contact your Red Hat Ceph Storage Administrator.

  This collects the following information in the specified directory:

• Collects all OpenShift Container Storage cluster related Custom Resources (CRs) with their namespaces.
• Collects pod logs of all the OpenShift Container Storage related pods.
• Collects output of some standard Ceph commands like Status, Cluster health, and others.