Troubleshooting OpenShift Hosted Control Planes

Solution Verified - Updated

Environment

  • Red Hat OpenShift Container Platform (RHOCP)
    • 4
  • Hosted Control Planes (HCP)

Issue

  • Gathering logging for OpenShift Hosted Control Planes installation issues.
  • How to troubleshoot OpenShift Hosted Control Planes Hosted cluster issues.

Resolution

For troubleshooting Hosted Control Planes issues, the following information is required:

On Hosting cluster side (change the values of the variables accordingly):

$ HOSTED_CLUSTER_NAMESPACE=[hosted_cluster_namespace_name]    ### for example "clusters"
$ HOSTED_CLUSTER_NAME=[hosted_cluster_name]                   ### for example "hosted01"
$ MCE_VERSION=[mce_version]                                   ### for example "2.6.3"
$ RHEL_VERSION=[rhel_base_image_version]                      ### "rhel8" for mce<=2.4, "rhel9" for mce>=2.5

$ mkdir ./hosting
$ cd ./hosting
$ oc adm must-gather --dest-dir="hosting-must-gather"
$ oc adm inspect ns/${HOSTED_CLUSTER_NAMESPACE}-${HOSTED_CLUSTER_NAME} --dest-dir="namespace-inspect-${HOSTED_CLUSTER_NAMESPACE}-${HOSTED_CLUSTER_NAME}"
$ oc adm inspect -A hostedcluster,nodepool,hostedcontrolplane --dest-dir="resources-inspect-hosted"
$ oc adm must-gather \
  --image=registry.redhat.io/multicluster-engine/must-gather-${RHEL_VERSION}:v${MCE_VERSION} \
  /usr/bin/gather hosted-cluster-namespace=${HOSTED_CLUSTER_NAMESPACE} hosted-cluster-name=${HOSTED_CLUSTER_NAME} --dest-dir="mce${MCE_VERSION}-${HOSTED_CLUSTER_NAMESPACE}-${HOSTED_CLUSTER_NAME}-must-gather" | tee must-gather-mce.log

On Hosted cluster side:

$ HOSTED_CLUSTER_NAME=[hosted01]

$ mkdir ./hosted
$ cd ./hosted
$ oc adm must-gather --dest-dir="${HOSTED_CLUSTER_NAME}-cluster-must-gather"

Compress hosting and hosted directories and attach to the Red Hat customer case

See also This page is not included, but the link has been rewritten to point to the nearest parent document.HCP Troubleshooting section in the OpenShift document.

Root Cause

For troubleshooting Hosted Control Planes issues, information from the "host" cluster and the "hosted" cluster is needed.

SBR
Product(s)
Components
Category
Tags

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.