mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
80 lines
3.2 KiB
Plaintext
80 lines
3.2 KiB
Plaintext
:_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] |