How to collect ODF must-gather data

Solution Verified - Updated

Environment

  • Red Hat OpenShift Data Foundation (RHODF)
    • 4
  • Red Hat OpenShift Container Platform (RHOCP)
    • 4
  • Must Gather

Issue

  • How to collect a must-gather for ODF 4.13 and above, which is based on RHEL9?
  • How to collect a must-gather for ODF 4.9 through ODF 4.12, which are based on RHEL8?

Resolution

For collecting the must-gather in disconnected environments, the required image needs to be mirrored. Refer to how to collect ODF must-gather in a Disconnected Environment for additional information.

Note: if the ODF must-gather pod fails, not all the required information is properly collected. In that case, please refer to capturing data via CLI terminal when the OpenShift Data Foundation must-gather fails.

Collecting ODF must-gather

  • Collect must-gather for ODF 4.13 and above (Based on RHEL9):

    $ oc adm must-gather --image=registry.redhat.io/odf4/odf-must-gather-rhel9:[Version] --dest-dir=<directory-name>

    For example:

    $ oc adm must-gather --image=registry.redhat.io/odf4/odf-must-gather-rhel9:v4.13 --dest-dir=<directory-name>

  • Collect must-gather for ODF 4.9 through ODF 4.12 (Based on RHEL8):

    $ oc adm must-gather --image=registry.redhat.io/odf4/ocs-must-gather-rhel8:[Version] --dest-dir=<directory-name>

    For example:

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

Note: for the OCS/ODF must-gather, it is needed to change the "[Version]" with the correct OCS/ODF version (e.g.: v4.8, v4.9, ...) in the above commands. Refer to the OCS/ODF documentation for downloading log files and diagnostic information using must-gather v4.12 or downloading log files and diagnostic information using must-gather v4.13.

Root Cause

The image used for ODF must-gather is different for each version, and the image needs to be mirrored for disconnected installations.

SBR
Product(s)
Category

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.