[OSDOCS-13848]: Add must gather docs for day 2 HCP

Author: lahinson

hosted_control_planes/hcp-troubleshooting.adoc

@@ -12,14 +12,14 @@ 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]
 
+include::modules/hcp-must-gather-day-2.adoc[leveloffset=+1]
+
 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.13/html/clusters/cluster_mce_overview#install-on-disconnected-networks[Install on disconnected networks]
 
 [id="hcp-ts-ocp-virt"]
@@ -32,7 +32,6 @@ 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.13/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]
@@ -45,7 +44,6 @@ 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.13/html/clusters/cluster_mce_overview#remove-managed-cluster[Removing a cluster from management]
 
 [id="hcp-ts-bm"]
@@ -57,14 +55,8 @@ 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.13/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]
-
-[role="_additional-resources"]
-.Additional resources
-
-* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.13/html/clusters/cluster_mce_overview#trouble-hosted-cluster-backplane[Must-gather for a hosted cluster]
+include::modules/scale-down-data-plane.adoc[leveloffset=+1]

modules/hcp-must-gather-day-2.adoc

@@ -0,0 +1,76 @@
+// Module included in the following assemblies:
+//
+// * hosted_control_planes/hcp-troubleshooting.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="hcp-must-gather-day-2_{context}"]
+= Troubleshooting Day 2 operations for {hcp}
+
+To troubleshoot Day 2 operations for a hosted cluster, you run the `must-gather` command and review the output.
+
+The output for the management cluster contains the following content:
+
+* *Cluster-scoped resources:* These resources are node definitions of the management cluster.
+* *The `hypershift-dump` compressed file:* This file is useful if you need to share the content with other people.
+* *Namespaced resources:* These resources include all of the objects from the relevant namespaces, such as config maps, services, events, and logs.
+* *Network logs:* These logs include the OVN northbound and southbound databases and the status for each one.
+* *Hosted clusters:* This level of output involves all of the resources inside of the hosted cluster.
+
+The output for the hosted cluster contains the following content:
+
+* *Cluster-scoped resources:* These resources include all of the cluster-wide objects, such as nodes and CRDs.
+* *Namespaced resources:* These resources include all of the objects from the relevant namespaces, such as config maps, services, events, and logs.
+
+Although the output does not contain any secret objects from the cluster, it can contain references to the names of secrets.
+
+.Prerequisites
+
+* You must have `cluster-admin` access to the management cluster.
+
+* You need the `name` value for the `HostedCluster` resource and the namespace where the CR is deployed.
+
+* You must have the `hcp` command-line interface installed. For more information, see "Installing the {hcp} command-line interface".
+
+* You must have the OpenShift CLI (`oc`) installed.
+
+* You must ensure that the `kubeconfig` file is loaded and is pointing to the management cluster.
+
+.Procedure
+
+You can collect must-gather information for a hosted cluster by using the {mce-short} web console or by using the `hcp` CLI.
+
+* To collect must-gather information by using the web console, complete the following steps:
++
+. In the web console, select *All Clusters* and select the cluster you want to troubleshoot.
+. In the upper-right corner, select *Download kubeconfig*.
+. Export the downloaded `kubeconfig` file.
+. Collect the must-gather information by entering the following command:
++
+[source,terminal]
+----
+$ oc adm must-gather
+----
+
+* To collect must-gather information by using the `hcp` CLI, complete the following steps:
++
+. Generate the `kubeconfig` file by entering the following command:
++
+[source,terminal]
+----
+$ hcp create kubeconfig --namespace <hosted_cluster_namespace> \
+  --name <hosted_cluster_name> > <hosted_cluster_name>.kubeconfig
+----
+
+. After you save the `kubeconfig` file, you can access the hosted cluster by entering the following example command:
++
+[source,terminal]
+----
+$ oc --kubeconfig <hosted_cluster_name>.kubeconfig get nodes
+----
+
+. . Collect the must-gather information by entering the following command:
++
+[source,terminal]
+----
+$ oc adm must-gather
+----