diff --git a/docs/quickstarts/insights-tasks-pre-conversion/insights-tasks-pre-conversion.yml b/docs/quickstarts/insights-tasks-pre-conversion/insights-tasks-pre-conversion.yml index cc78f535..44687914 100644 --- a/docs/quickstarts/insights-tasks-pre-conversion/insights-tasks-pre-conversion.yml +++ b/docs/quickstarts/insights-tasks-pre-conversion/insights-tasks-pre-conversion.yml @@ -15,24 +15,22 @@ spec: description: |- Generate a pre-conversion analysis report that summarizes potential problems and suggests recommended solutions to help you convert to RHEL. introduction: |- - [Red Hat Insights can be used only to run the pre-conversion analysis on CentOS Linux 7 systems.]{{admonition important}} + [Red Hat Insights can be used only to run the pre-conversion analysis on CentOS Linux 7 systems.]{{admonition note}} In this quick start, you will connect and run a pre-conversion analysis on CentOS Linux machines on the Red Hat Hybrid Cloud Console. The task generates a report that summarizes potential problems and suggests recommended solutions to help you convert to RHEL.

Additional information: + - Before running the pre-conversion analysis by using Red Hat Insights and performing the conversion, you must first complete 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) + - 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) - Depending on your requirements, you can convert to RHEL using a number of supported methods. [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) - - - [Explore additional conversion considerations](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/converting_from_an_rpm-based_linux_distribution_to_rhel/con_planning-a-rhel-conversion_converting-from-a-linux-distribution-to-rhel) when planning your RHEL conversion. tasks: - title: Verify CentOS Linux machines are connected description: |- - [The only Red Hat Insights service you can use with registered CentOS Linux systems is the RHEL conversion. All other Insights services are available only after the conversion to RHEL.]{{admonition note}} - - Before running the pre-conversion analysis in Red Hat Insights, you must connect your CentOS machines to Insights
+ Before running the pre-conversion analysis in Red Hat Insights, you must connect your CentOS systems to Insights
**To verify CentOS Linux machines are connected:** @@ -64,7 +62,9 @@ spec: 1. Log in to the [Red Hat Hybrid Cloud Console](http://console.redhat.com) and go to **Red Hat Insights > RHEL > Inventory > Systems.** 1. Verify that your CentOS Linux systems appear as expected. - + + [The only Red Hat Insights service you can use with registered CentOS Linux systems is the RHEL conversion. All other Insights services are available only after the conversion to RHEL.]{{admonition note}} + # optional - the task's Check your work module review: instructions: |- @@ -78,15 +78,16 @@ spec: - title: Review the pre-conversion analysis report using Insights description: |- [Back up your systems and verify that you can restore your systems if needed]{{admonition important}} + To assess whether your CentOS Linux systems can be converted to RHEL, run the Pre-conversion analysis for converting to RHEL task. The pre-conversion analysis generates a report summarizing potential problems and recommending solutions. The report also helps you decide whether it is possible or advisable to convert to RHEL.
**Run a Pre-Conversion analysis:** 1. Log in to the Red Hat Hybrid Cloud Console and go to **Red Hat Insights > RHEL > Automation toolkit > Tasks.** - 1. Locate the **Pre-conversion analysis for converting to RHEL** task and click **Run task.** + 1. Locate the **Pre-conversion analysis for converting to RHEL** task and click **Select systems.** - 1. Select the CentOS Linux 7 systems you want to analyze for conversion and click **Execute task.** + 1. Select the CentOS Linux 7 systems you want to analyze for conversion and click **Run task.**
 **Don't see your system?**
@@ -123,16 +124,19 @@ spec:
- 1. The pre-conversion analysis utility generates a new report in the **Activity tab**. Click the report to view a summary of issues found in each system. + [The pre-conversion process can take up to an hour to complete.]{{admonition note}} + + 1. The pre-conversion analysis utility generates a new report in the **Activity tab**. Select the report to view a summary of issues found in each system. 1. After task completion, you can drill down further by selecting a system to view each issue and, when applicable, a potential remediation in detail.

Each issue is assigned a severity level: - - **Inhibitor:** This would cause the conversion to fail because it will likely result in a deteriorated system state. This issue must be resolved before converting. - - **Overridable inhibitor**: This would cause the conversion to fail because it will likely result in a deteriorated system state. This issue must be resolved or manually overridden before converting. - Skipped: The test could not run because of a prerequisite test failing. This issue could cause the conversion to fail. - - **Warning:** This would not cause the conversion to fail. System and application issues might occur after the conversion. + - **Inhibitor:** Would cause the conversion to fail because it is very likely to result in a deteriorated system state. This issue must be resolved before converting. + - **Overridable inhibitor**: Would cause the conversion to fail because it is very likely to result in a deteriorated system state. This issue must be resolved or manually overridden before converting. + Skipped: Could not run this test because of a prerequisite test failing. Could cause the conversion to fail. + - **Warning:** Would not cause the conversion to fail. System and application issues might occur after the conversion. - **Info:** Informational with no expected impact to the system or applications. + - **Ready for conversion:** No issues were found.
 **Why did the Pre-conversion analysis task fail to complete?** @@ -161,10 +165,7 @@ spec: 1. After reviewing the report and resolving all reported issues, click **Run task again** to rerun the analysis and confirm that no issues are outstanding. - 1. Perform the conversion to RHEL in the command-line interface. See [Converting a RHEL system](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/converting_from_an_rpm-based_linux_distribution_to_rhel/proc_converting-to-a-rhel-system_converting-from-a-linux-distribution-to-rhel) for more information. - - [It is not currently possible to perform the conversion to RHEL using Red Hat Insights.]{{admonition note}} - + 1. Perform the conversion to RHEL with the Convert to RHEL from CentOS Linux 7 task or in the command-line interface. See [converting from an RPM-based Linux distrbution to RHEL](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html-single/converting_from_an_rpm-based_linux_distribution_to_rhel/index) for more information. # optional - the task's Check your work module review: instructions: |- diff --git a/docs/quickstarts/subs-create-activation-key/subs-create-activation-key.yaml b/docs/quickstarts/subs-create-activation-key/subs-create-activation-key.yaml index b3a540c1..ff2164c8 100644 --- a/docs/quickstarts/subs-create-activation-key/subs-create-activation-key.yaml +++ b/docs/quickstarts/subs-create-activation-key/subs-create-activation-key.yaml @@ -12,5 +12,5 @@ spec: icon: ~ description: Create or manage an activation key to register your systems with Red Hat hosted services. link: - href: https://access.redhat.com/documentation/en-us/subscription_central/2023/html/creating_and_managing_activation_keys_on_the_hybrid_cloud_console + href: https://access.redhat.com/documentation/en-us/subscription_central/1-latest/html/getting_started_with_activation_keys_on_the_hybrid_cloud_console text: View documentation diff --git a/docs/quickstarts/subs-getting-started/subs-getting-started.yaml b/docs/quickstarts/subs-getting-started/subs-getting-started.yaml index 346ff1f7..1fa416e2 100644 --- a/docs/quickstarts/subs-getting-started/subs-getting-started.yaml +++ b/docs/quickstarts/subs-getting-started/subs-getting-started.yaml @@ -12,5 +12,5 @@ spec: icon: ~ description: Review current and historical subscription usage against total capacity with the subscriptions service. link: - href: https://access.redhat.com/documentation/en-us/subscription_central/2023/html/getting_started_with_the_subscriptions_service + href: https://access.redhat.com/documentation/en-us/subscription_central/1-latest/html/getting_started_with_the_subscriptions_service text: View documentation diff --git a/docs/quickstarts/subs-simple-content-access/subs-simple-content-access.yaml b/docs/quickstarts/subs-simple-content-access/subs-simple-content-access.yaml index fa4886e6..17b3434f 100644 --- a/docs/quickstarts/subs-simple-content-access/subs-simple-content-access.yaml +++ b/docs/quickstarts/subs-simple-content-access/subs-simple-content-access.yaml @@ -12,5 +12,5 @@ spec: icon: ~ description: Streamline your subscription workflow by enabling simple content access. link: - href: https://access.redhat.com/documentation/en-us/subscription_central/2023/html/getting_started_with_simple_content_access + href: https://access.redhat.com/documentation/en-us/subscription_central/1-latest/html/getting_started_with_simple_content_access text: View documentation diff --git a/docs/quickstarts/subs-view-inventory/subs-view-inventory.yaml b/docs/quickstarts/subs-view-inventory/subs-view-inventory.yaml index 29161fc4..f6c01e46 100644 --- a/docs/quickstarts/subs-view-inventory/subs-view-inventory.yaml +++ b/docs/quickstarts/subs-view-inventory/subs-view-inventory.yaml @@ -12,5 +12,5 @@ spec: icon: ~ description: View details and status information about each subscription in your inventory. link: - href: https://access.redhat.com/documentation/en-us/subscription_central/2023/html/viewing_and_managing_your_subscription_inventory_on_the_hybrid_cloud_console + href: https://access.redhat.com/documentation/en-us/subscription_central/1-latest/html/viewing_and_managing_your_subscription_inventory_on_the_hybrid_cloud_console text: View documentation