:_mod-docs-content-type: ASSEMBLY
[id="hcp-troubleshooting"]
include::_attributes/common-attributes.adoc[]
= Troubleshooting {hcp}
:context: hcp-troubleshooting

toc::[]

If you encounter issues with {hcp}, see the following information to guide you through troubleshooting.

include::modules/hosted-control-planes-troubleshooting.adoc[leveloffset=+1]

[role="_additional-resources"]
.Additional resources
* xref:../hosted_control_planes/hcp-prepare/hcp-cli.adoc[Installing the {hcp} command-line interface]

[id="hcp-must-gather-day-2"]
== Gathering {product-title} data for a hosted cluster

You can gather {product-title} debugging information for a hosted cluster by using the {mce-short} web console or by using the CLI.

include::modules/hcp-must-gather-cli.adoc[leveloffset=+2]

include::modules/hcp-must-gather-console.adoc[leveloffset=+2]

include::modules/hcp-must-gather-dc.adoc[leveloffset=+1]

[role="_additional-resources"]
.Additional resources
* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.14/html/clusters/cluster_mce_overview#install-on-disconnected-networks[Install on disconnected networks]

[id="hcp-ts-ocp-virt"]
== Troubleshooting hosted clusters on {VirtProductName}

When you troubleshoot a hosted cluster on {VirtProductName}, start with the top-level `HostedCluster` and `NodePool` resources and then work down the stack until you find the root cause. The following steps can help you discover the root cause of common issues.

include::modules/hcp-ts-hc-stuck.adoc[leveloffset=+2]

include::modules/hcp-ts-no-nodes-reg.adoc[leveloffset=+2]

[role="_additional-resources"]
.Additional resources
* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.14/html/clusters/cluster_mce_overview#identifying-vm-console-logs[Identifying the problem: Access the VM console logs]

include::modules/hcp-ts-nodes-stuck.adoc[leveloffset=+2]

include::modules/hcp-ts-ingress-not-online.adoc[leveloffset=+2]

include::modules/hcp-ts-load-balancer-svcs.adoc[leveloffset=+2]

include::modules/hcp-ts-pvcs-not-avail.adoc[leveloffset=+2]

include::modules/hcp-ts-vm-nodes.adoc[leveloffset=+2]

include::modules/hcp-ts-rhcos.adoc[leveloffset=+2]

include::modules/hcp-ts-non-bm.adoc[leveloffset=+2]

[role="_additional-resources"]
.Additional resources
* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.14/html/clusters/cluster_mce_overview#remove-managed-cluster[Removing a cluster from management]

[id="hcp-ts-bm"]
== Troubleshooting hosted clusters on bare metal

The following information applies to troubleshooting {hcp} on bare metal.

include::modules/hcp-ts-bm-nodes-not-added.adoc[leveloffset=+2]

[role="_additional-resources"]
.Additional resources
* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.14/html-single/clusters/index#on-prem-creating-your-cluster-with-the-cli-pull-secret[Add the pull secret to the namespace]

include::modules/hosted-restart-hcp-components.adoc[leveloffset=+1]

include::modules/hosted-control-planes-pause-reconciliation.adoc[leveloffset=+1]

include::modules/scale-down-data-plane.adoc[leveloffset=+1]

include::modules/agent-service-failure.adoc[leveloffset=+1]