openshift/openshift-docs
1
0
Fork 0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00
Code Issues Releases Activity

Add troubleshooting docs for HCP on bare metal

Browse Source
This commit is contained in:
Laura Hinson
2024-10-22 14:44:22 -04:00
committed by openshift-cherrypick-robot
parent 1eb4c70bd4
commit feacb08436
2 changed files with 51 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
hosted_control_planes/hcp-troubleshooting.adoc
View File

@@ -48,6 +48,18 @@ include::modules/hcp-ts-non-bm.adoc[leveloffset=+2]
* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.12/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-short} 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.12/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]

39
modules/hcp-ts-bm-nodes-not-added.adoc Normal file
View File

@@ -0,0 +1,39 @@
// Module included in the following assemblies:
//
// * hosted_control_planes/hcp-troubleshooting.adoc
:_mod-docs-content-type: PROCEDURE
[id="hcp-ts-bm-nodes-not-added_{context}"]
= Nodes fail to be added to {hcp} on bare metal
When you scale up a {hcp} cluster with nodes that were provisioned by using Assisted Installer, the host fails to pull the ignition with a URL that contains port 22642. That URL is invalid for {hcp} and indicates that an issue exists with the cluster.
.Procedure
. To determine the issue, review the assisted-service logs:
+
[source,terminal]
----
$ oc logs -n multicluster-engine <assisted_service_pod_name> <1>
----
+
<1> Specify the Assisted Service pod name.
. In the logs, find errors that resemble these examples:
+
[source,terminal]
----
error="failed to get pull secret for update: invalid pull secret data in secret pull-secret"
----
+
[source,terminal]
----
pull secret must contain auth for \"registry.redhat.io\"
----
. To fix this issue, see "Add the pull secret to the namespace" in the {mce} documentation.
+
[NOTE]
====
To use {hcp}, you must have {mce-short} installed, either as a standalone operator or as part of {rh-rhacm-title}. Because the operator has a close association with {rh-rhacm-title}, the documentation for the operator is published within that product's documentation. Even if you do not use {rh-rhacm-title}, the parts of its documentation that cover {mce-short} are relevant to {hcp}.
====