Merge pull request #64442 from ShaunaDiaz/OSDOCS-6453

OSDOCS-6453: Supportability - install failure and sos reports

Author: bscott-rh

_topic_maps/_topic_map_ms.yml

@@ -55,6 +55,8 @@ Topics:
   File: microshift-embed-in-rpm-ostree
 - Name: Greenboot health check
   File: microshift-greenboot
+- Name: Troubleshooting installation issues
+  File: microshift-installing-troubleshooting
 ---
 Name: Updating
 Dir: microshift_updating

microshift_install/microshift-installing-troubleshooting.adoc

@@ -0,0 +1,17 @@
+:_content-type: ASSEMBLY
+[id="microshift-installing-troubleshooting"]
+= Troubleshooting installation issues
+include::_attributes/attributes-microshift.adoc[]
+:context: microshift-installing-troubleshooting
+
+toc::[]
+
+To troubleshoot a failed {product-title} installation, you can run an sos report. Use the `sos report` command to generate a detailed report that shows all of the enabled plugins and data from the different components and applications in a system.
+
+include::modules/microshift-gathering-sos-report.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+.Additional resources
+* xref:../microshift_support/microshift-sos-report.adoc#microshift-sos-report[About MicroShift sos reports]
+
+* link:https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/getting_the_most_from_your_support_experience/generating-an-sos-report-for-technical-support_getting-the-most-from-your-support-experience[Generating an sos report for technical support]

microshift_support/microshift-sos-report.adoc

@@ -7,7 +7,7 @@ include::_attributes/attributes-microshift.adoc[]
 toc::[]
 
 [role="_abstract"]
-`sos` is a tool you can use to collect troubleshooting information about a host. An `sos report` will generate a detailed report with all the enabled plugins and data from the different components and applications in a system.
+You can use the `sos` tool to collect troubleshooting information about a host. The `sos report` command generates a detailed report that shows all of the enabled plugins and data from the different components and applications in a system.
 
 //:FeatureName: MicroShift
 //include::snippets/microshift-tech-preview-snip.adoc[leveloffset=+1]