What information do I need to gather for troubleshooting Red Hat Advanced Cluster Management?

Solution Verified - Updated

Environment

  • Red Hat Advanced Cluster Management (RHACM)

Issue

  • What information do I need to gather information for troubleshooting Red Hat Advanced Cluster Management
  • How do I collect system log files, configuration details and system information from a Red Hat Advanced Cluster Management (RHACM) system to provide to Red Hat Technical Support for analysis?
  • What data I have to provide for initial analysis of my system?
  • How can I generate an ACM must-gather?

Resolution

  • Please provide the 2 following items:
    • What kind of OpenShift you installed on, e.g., if it's on Azure Red Hat OpenShift or if it's OpenShift on OpenStack or OpenShift on Red Hat Enterprise Virtualization, etc.
    • The must-gather archive specific to ACM version running.

Note: For details about ACM must-gather, refer to: ACM 2.11 Troubleshooting Red Hat Advanced Cluster Management for Kubernetes. The documentation is version specific; ensure to select the version you are using.

Data Collection for Red Hat Advanced Cluster Management for Kubernetes (ACM)

For ACM 2.10 and later:

Note: Replace [ACM_version] with the cluster's ACM version, for example 2.10.

$ oc adm must-gather --image=registry.redhat.io/rhacm2/acm-must-gather-rhel9:v[ACM_version] |& tee must-gather-collect.log

For ACM 2.9 and earlier:

Note: Replace [ACM_version] with the cluster's ACM version, for example 2.9.

$ oc adm must-gather --image=registry.redhat.io/rhacm2/acm-must-gather-rhel8:v[ACM_version] |& tee must-gather-collect.log

Must-gather in a disconnected environment

  1. In a disconnected environment, mirror the Red Hat operator catalog images into their mirror registry. For details, refer to Install on disconnected networks

  2. Run the following command to extract logs, which reference the image from their mirror registry:

For ACM 2.10 and later:

Note: Replace [ACM_version] with the cluster's ACM version, for example 2.10.

REGISTRY=registry.example.com:5000
IMAGE=$REGISTRY/rhacm2/acm-must-gather-rhel9:v[ACM_version]

oc adm must-gather --image=$IMAGE --dest-dir=./data |& tee must-gather-collect.log

For ACM 2.9 and earlier:

Note: Replace [ACM_version] with the cluster's ACM version, for example 2.9.

REGISTRY=registry.example.com:5000
IMAGE=$REGISTRY/rhacm2/acm-must-gather-rhel8:v[ACM_version]

oc adm must-gather --image=$IMAGE --dest-dir=./data |& tee must-gather-collect.log

Note: please also share the must-gather-collect.log file. This will help us troubleshoot situations where must-gather collection fails.

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.