Merge pull request #67698 from obrown1205/OSDOCS-7531

[OSDOCS-7531]: Troubleshooting chapter to Upgrading clusters

Author: adellape

_topic_maps/_topic_map.yml

@@ -662,8 +662,14 @@ Topics:
     File: migrating-to-multi-payload
   - Name: Updating hosted control planes
     File: updating-hosted-control-planes
-# - Name: Troubleshooting an update
-#  File: updating-troubleshooting
+- Name: Troubleshooting a cluster update
+  Dir: troubleshooting_updates
+  Distros: openshift-enterprise,openshift-origin
+  Topics:
+  #- Name: Recovering when an update fails before it is applied
+   # File: recovering-update-before-applied
+  - Name: Gathering data about your cluster update
+    File: gathering-data-cluster-update
 ---
 Name: Support
 Dir: support

modules/gathering-log-data.adoc

@@ -0,0 +1,9 @@
+// Module included in the following assemblies:
+//
+// * updating/troubleshooting_updates/gathering-data-cluster-update.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="gathering-log-data_{context}"]
+= Gathering log data for a support case
+
+To gather data from your cluster, including log data, use the `oc adm must-gather` command. See _Gathering data about your cluster for Red Hat Support_.

modules/updating-clear.adoc

@@ -0,0 +1,18 @@
+// Module included in the following assemblies:
+//
+// * updating/troubleshooting_updates/recovering-update-before-applied.adoc
+
+[id="updating-troubleshooting-clear_{context}"]
+= Recovering when an update fails before it is applied
+
+If an update fails before it is applied, such as when the version that you specify cannot be found, you can cancel the update:
+
+[source,terminal]
+----
+$ oc adm upgrade --clear
+----
+
+[IMPORTANT]
+====
+If an update fails at any other point, you must contact Red Hat support. Rolling your cluster back to a previous version is not supported.
+====

modules/updating-troubleshooting-clear.adoc

@@ -0,0 +1 @@
+../../_attributes/

updating/troubleshooting_updates/_attributes

@@ -0,0 +1,17 @@
+:_mod-docs-content-type: ASSEMBLY
+[id="gathering-data-cluster-update"]
+= Gathering data about your cluster update
+include::_attributes/common-attributes.adoc[]
+:context: troubleshooting_updates
+
+toc::[]
+
+When reaching out to Red Hat support for issues with an update, it is important to provide data for the support team to use for troubleshooting your failed cluster update.
+
+include::modules/gathering-log-data.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+[id="additional-resources_gathering-cluster-data"]
+.Additional resources
+
+* xref:../../support/gathering-cluster-data.adoc#support_gathering_data_gathering-cluster-data[Gathering data about your cluster for Red Hat Support]

updating/troubleshooting_updates/gathering-data-cluster-update.adoc

@@ -0,0 +1 @@
+../../images/

updating/troubleshooting_updates/images

@@ -0,0 +1 @@
+../../modules/

updating/troubleshooting_updates/modules

@@ -0,0 +1,11 @@
+:_mod-docs-content-type: ASSEMBLY
+[id="recovering-update-before-applied"]
+= Recovering when an update fails before it is applied
+include::_attributes/common-attributes.adoc[]
+:context: troubleshooting_updates
+
+toc::[]
+
+In some situations, you can recover from a failed update of {product-title}. 
+
+include::modules/updating-troubleshooting-clear.adoc[leveloffset=+1]

updating/troubleshooting_updates/recovering-update-before-applied.adoc

@@ -0,0 +1 @@
+../../snippets/