Add Conversion QS, Pre-Upgrade QS, and Edits to Pre-conversion. (RedH…

…atInsights#175)

* added new convert qs

* updated text to say conversion vs preconversion

* minor text updates to both preconversion and conversion QS to align with guidlines.

* edits and added pre-upgrade QS

* Updated metadata tag to match the quickstart name

docs/quickstarts/insights-tasks-convert/insights-tasks-convert.yml

@@ -0,0 +1,88 @@
+# Additional info: https://docs.openshift.com/container-platform/4.9/web_console/creating-quick-start-tutorials.html
+metadata:
+  name: insights-tasks-convert
+  # you can add additional metadata here
+  instructional: true
+spec:
+  displayName: Convert to RHEL from CentOS Linux 7 in Insights
+  durationMinutes: 10 (active)
+  # Optional type section, will display as a tile on the card
+  type:
+    text: Quick start
+    # 'blue' | 'cyan' | 'green' | 'orange' | 'purple' | 'red' | 'grey'
+    color: green
+  icon: data:image/svg+xml;base64,PCEtLSBHZW5lcmF0ZWQgYnkgSWNvTW9vbi5pbyAtLT4KPHN2ZyB2ZXJzaW9uPSIxLjEiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgd2lkdGg9IjUxMiIgaGVpZ2h0PSI1MTIiIHZpZXdCb3g9IjAgMCA1MTIgNTEyIj4KPHRpdGxlPjwvdGl0bGU+CjxnIGlkPSJpY29tb29uLWlnbm9yZSI+CjwvZz4KPHBhdGggZD0iTTQ0OCA2NHY0MTZoLTMzNmMtMjYuNTEzIDAtNDgtMjEuNDktNDgtNDhzMjEuNDg3LTQ4IDQ4LTQ4aDMwNHYtMzg0aC0zMjBjLTM1LjE5OSAwLTY0IDI4LjgtNjQgNjR2Mzg0YzAgMzUuMiAyOC44MDEgNjQgNjQgNjRoMzg0di00NDhoLTMyeiI+PC9wYXRoPgo8cGF0aCBkPSJNMTEyLjAyOCA0MTZ2MGMtMC4wMDkgMC4wMDEtMC4wMTkgMC0wLjAyOCAwLTguODM2IDAtMTYgNy4xNjMtMTYgMTZzNy4xNjQgMTYgMTYgMTZjMC4wMDkgMCAwLjAxOS0wLjAwMSAwLjAyOC0wLjAwMXYwLjAwMWgzMDMuOTQ1di0zMmgtMzAzLjk0NXoiPjwvcGF0aD4KPC9zdmc+Cg==
+  prerequisites:
+    - You have completed, reviewed, and addressed any issues in a pre-conversion analysis report using Insights for the systems you plan to convert.
+  description: |-
+    Convert your operating system from CentOS Linux 7 to Red Hat Enterprise Linux (RHEL) 7.  
+  introduction: |-  
+    After running the “Pre-conversion analysis for converting to RHEL” task and resolving all reported issues, use this quick start to convert your CentOS Linux 7 systems to RHEL 7.
+    <br>
+    <br>
+    Before performing the conversion, make sure you have completed all necessary [preparation steps.](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/converting_from_an_rpm-based_linux_distribution_to_rhel/converting-using-insights_converting-from-a-linux-distribution-to-rhel)
+    <br>
+    Additional information:
+    
+    - It is possible to convert systems from other Linux distributions. [View supported conversion paths.](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/converting_from_an_rpm-based_linux_distribution_to_rhel/con_supported-conversion-paths_converting-from-a-linux-distribution-to-rhel)
+
+    - You can convert to RHEL using several supported methods depending on your requirements. [View supported conversion methods.](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/converting_from_an_rpm-based_linux_distribution_to_rhel/conversion-methods_converting-from-a-linux-distribution-to-rhel) 
+
+  tasks:
+    - title: Convert a CentOS 7 system to RHEL 7 using Insights
+      description: |-
+        [Before converting, back up your systems and verify that you can restore them if needed]{{admonition important}}
+
+        [To avoid serious problems after the conversion, do not convert any systems with unresolved inhibitors and warnings in the pre-conversion analysis.]{{admonition important}}
+
+        After running the “Pre-conversion analysis for converting to RHEL” task and resolving all reported issues, you can convert your CentOS Linux 7 systems to RHEL 7. The conversion task generates a conversion report detailing the systems that were successfully converted and summarizing any problems for any that were not.<br>       
+        
+        **Run the conversion task:**
+
+        1. Log into the Red Hat Hybrid Cloud Console and go to **Red Hat Insights > RHEL > Automation toolkit > Tasks.**
+      
+        1. Locate the **Convert to RHEL from CentOS 7 Linux** task and click **Select systems.**
+
+        1. You can rename the task name. It will be used on the report generated. 
+
+        1. Select the CentOS Linux 7 systems you want to convert to RHEL and click  **Run task.**
+        
+        [The conversion process can take up to an hour to complete.]{{admonition note}}
+    
+    - title: Review conversion report
+      description: |-
+        1. Go to the **Activity tab** and find the newly generated conversion report. Select the report to view a summary of the status of each system.
+        
+        1. After task completion, you can review each system and message:<br> 
+              <br>
+              Each issue is assigned a severity level.
+              - **Inhibitor:** The conversion failed because converting would very likely result in a deteriorated system state. This issue must be resolved before converting the affected system.
+              - **Overridable inhibitor**: The conversion failed because converting would very likely result in a deteriorated system state. This issue must be resolved or manually overridden before converting.
+              - **Skipped:** The conversion failed because the Conversion task could not run one or more tests. This issue must be resolved before converting the affected system.
+              - **Converted:** The system has been converted. Reboot this system.
+
+        1. If a system has been successfully converted with no issues, reboot the system and skip the next step.
+
+        1. If the system was not converted, review the message for more information on the found problems and how to resolve them. Additionally, verify the following:<br>
+              - You have completed all the steps to [prepare for a conversion using Insights.] (https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/converting_from_an_rpm-based_linux_distribution_to_rhel/converting-using-insights_converting-from-a-linux-distribution-to-rhel)
+              - The system contains all packages required for the conversion.
+              - The system is running.
+              - You have resolved all issues in the Pre-conversion analysis for converting to RHEL task.
+
+        1. After rebooting the system that has been successfully converted, remove third-party packages from the original OS that remained unchanged. These are typically packages that do not have a RHEL counterpart. To get a list of these packages, use:<br>
+              - `# yum list extras --disablerepo="*" --enablerepo=`{{copy}}<br>
+              - Add your repository after `enablerepo`.
+
+        1. **Optional:** Perform an in-place upgrade to RHEL 9 to ensure your system is updated with the latest enhancements, security features, and bug fixes.<br>
+        <br>
+        For more information, see the [Upgrading from RHEL 7 to RHEL 8] (https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/upgrading_from_rhel_7_to_rhel_8/index) and [Upgrading from RHEL 8 to RHEL 9] (https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/upgrading_from_rhel_8_to_rhel_9/index) guides.
+                            
+  conclusion: |-
+    <br>
+    **Thank you for taking the time to explore this feature!**
+
+    For additional information about tasks, [visit the documentation for remediating systems using tasks in Insights.](https://access.redhat.com/documentation/en-us/red_hat_insights/1-latest/html-single/assessing_and_remediating_system_issues_using_red_hat_insights_tasks/index)
+
+    For additional information about conversions, [visit the conversion documentation.](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html-single/converting_from_an_rpm-based_linux_distribution_to_rhel/index)
+
+    If you need additional assistance, [open a support case](https://access.redhat.com/support). 

docs/quickstarts/insights-tasks-convert/metadata.yml

@@ -0,0 +1,6 @@
+kind: QuickStarts # kind must always be "QuickStarts"
+name: insights-tasks-convert
+tags: # If you want to use more granular filtering add tags to the quickstart
+  - kind: bundle
+    value: insights
+