diff --git a/docs/.vuepress/public/images/ELevateNGCockpitUI.webp b/docs/.vuepress/public/images/ELevateCockpitUI.webp similarity index 100% rename from docs/.vuepress/public/images/ELevateNGCockpitUI.webp rename to docs/.vuepress/public/images/ELevateCockpitUI.webp diff --git a/docs/elevate/ELevate-NG-testing-guide.md b/docs/elevate/ELevate-NG-testing-guide.md index 6cc76021a..a821ab13d 100644 --- a/docs/elevate/ELevate-NG-testing-guide.md +++ b/docs/elevate/ELevate-NG-testing-guide.md @@ -267,6 +267,10 @@ When successfully upgraded to AlmaLinux 8 OS, consider performing these steps to In certain configurations, Leapp generates _/var/log/leapp/answerfile_ with true/false questions. Leapp utility requires answers to all these questions in order to proceed with the upgrade. ::: + :::tip + You can also inspect the upgrade report in the Cockpit Web UI. See [Inspecting the upgrade report in Cockpit Web UI](/elevate/ELevate-quickstart-guide#inspecting-the-upgrade-report-in-cockpit-web-ui). + ::: + - The following fixes from _the /var/log/leapp/leapp-report.txt_ file are the most popular fixes for RHEL8-based operating systems: ```bash @@ -388,10 +392,6 @@ After these preparations are completed, you can upgrade your AlmaLinux 9 machine These steps can also be used to perform the upgrade from CentOS Stream 9 to CentOS Stream 10. The only difference is the `leapp-data` package. ::: -:::tip -Optionally, you can install the Cockpit Web UI along with the `cockpit-leapp` extension (see the optional steps below) to inspect the upgrade report in a browser. -::: - - Install ELevate NG version repo config for AlmaLinux 9: ```bash @@ -419,24 +419,6 @@ Optionally, you can install the Cockpit Web UI along with the `cockpit-leapp` ex ::: -- Install Cockpit and Leapp in-place upgrade Cockpit UI packages (optional): - - ```bash - sudo yum install -y cockpit cockpit-leapp - ``` - -- Start the Cockpit Web Service Socket, if not running (optional): - - ```bash - sudo systemctl start cockpit.socket - ``` - -- Log into Cockpit Web UI at `http://:9090`. - - :::tip - Make sure the 9090 port is accessible. - ::: - - Start a preupgrade check. In the meanwhile, the Leapp utility creates a special _/var/log/leapp/leapp-report.txt_ file that contains possible problems and recommended solutions. No rpm packages will be installed at this phase. :::warning @@ -456,9 +438,7 @@ Optionally, you can install the Cockpit Web UI along with the `cockpit-leapp` ex ::: :::tip - If you installed the `cockpit-leapp` UI extension, you can review the preupgrade report directly in the Cockpit Web UI, as shown below: - - ![Cockpit Web UI showing the Leapp preupgrade report](/images/ELevateNGCockpitUI.webp) + You can also inspect the upgrade report in the Cockpit Web UI. See [Inspecting the upgrade report in Cockpit Web UI](/elevate/ELevate-quickstart-guide#inspecting-the-upgrade-report-in-cockpit-web-ui). ::: - Currently, the direct upgrade from Almalinux OS 9 to AlmaLinux OS 10.0 Beta goes smoothly. If there is a progressive upgrade from CentOS 7 to AlmaLinux OS 10.0 Beta, please check the [known issues](#known-issues) section. diff --git a/docs/elevate/ELevate-quickstart-guide.md b/docs/elevate/ELevate-quickstart-guide.md index 5bee23425..cf86624da 100644 --- a/docs/elevate/ELevate-quickstart-guide.md +++ b/docs/elevate/ELevate-quickstart-guide.md @@ -135,6 +135,36 @@ sudo curl -o /etc/yum.repos.d/CentOS-Base.repo https://el7.repo.almalinux.org/ce cat /var/log/leapp/leapp-upgrade.log ``` +## Inspecting the upgrade report in Cockpit Web UI + +Optionally, you can install the Cockpit Web UI along with the `cockpit-leapp` extension to inspect the Leapp upgrade report in a browser instead of reading _/var/log/leapp/leapp-report.txt_ directly. + +:::tip +Cockpit is available when upgrading from AlmaLinux 8 or AlmaLinux 9. +::: + +- Install Cockpit and the Leapp in-place upgrade Cockpit UI packages: + + ```bash + sudo yum install -y cockpit cockpit-leapp + ``` + +- Start the Cockpit Web Service Socket, if not running: + + ```bash + sudo systemctl start cockpit.socket + ``` + +- Log into Cockpit Web UI at `http://:9090`. + + :::tip + Make sure the 9090 port is accessible. + ::: + +- After running `leapp preupgrade`, you can review the preupgrade report directly in the Cockpit Web UI, as shown below: + + ![Cockpit Web UI showing the Leapp preupgrade report](/images/ELevateCockpitUI.webp) + ### Demo Video Here we have provided a demo of a CentOS 7.x to AlmaLinux 8.x upgrade using the AlmaLinux ELevate Project. diff --git a/docs/elevate/ELevate-testing-guide.md b/docs/elevate/ELevate-testing-guide.md index 298932a08..1a925fc48 100644 --- a/docs/elevate/ELevate-testing-guide.md +++ b/docs/elevate/ELevate-testing-guide.md @@ -232,6 +232,10 @@ When successfully upgraded to AlmaLinux 8 OS, consider performing these steps to In certain configurations, Leapp generates _/var/log/leapp/answerfile_ with true/false questions. Leapp utility requires answers to all these questions in order to proceed with the upgrade. ::: + :::tip + You can also inspect the upgrade report in the Cockpit Web UI. See [Inspecting the upgrade report in Cockpit Web UI](/elevate/ELevate-quickstart-guide#inspecting-the-upgrade-report-in-cockpit-web-ui). + ::: + - The following fixes from _the /var/log/leapp/leapp-report.txt_ file are the most popular fixes for RHEL8-based operating systems: ```bash @@ -413,6 +417,10 @@ The only difference is the `leapp-data` package. In certain configurations, Leapp generates _/var/log/leapp/answerfile_ with true/false questions. Leapp utility requires answers to all these questions in order to proceed with the upgrade. ::: + :::tip + You can also inspect the upgrade report in the Cockpit Web UI. See [Inspecting the upgrade report in Cockpit Web UI](/elevate/ELevate-quickstart-guide#inspecting-the-upgrade-report-in-cockpit-web-ui). + ::: + - Currently, the direct upgrade from Almalinux OS 9 to AlmaLinux OS 10.0 goes smoothly. If there is a progressive upgrade from CentOS 7 to AlmaLinux OS 10.0, please check the [known issues](#known-issues) section. :::tip diff --git a/docs/elevate/ELevating-CentOS7-to-AlmaLinux-10.md b/docs/elevate/ELevating-CentOS7-to-AlmaLinux-10.md index bfae74b98..6f5146a7c 100644 --- a/docs/elevate/ELevating-CentOS7-to-AlmaLinux-10.md +++ b/docs/elevate/ELevating-CentOS7-to-AlmaLinux-10.md @@ -224,6 +224,10 @@ When successfully upgraded to AlmaLinux 8 OS, consider performing these steps to In certain configurations, Leapp generates _/var/log/leapp/answerfile_ with true/false questions. Leapp utility requires answers to all these questions in order to proceed with the upgrade. ::: + :::tip + You can also inspect the upgrade report in the Cockpit Web UI. See [Inspecting the upgrade report in Cockpit Web UI](/elevate/ELevate-quickstart-guide#inspecting-the-upgrade-report-in-cockpit-web-ui). + ::: + - The following fixes from _the /var/log/leapp/leapp-report.txt_ file are the most popular fixes for RHEL8-based operating systems: ```bash @@ -400,6 +404,10 @@ The only difference is the `leapp-data` package. In certain configurations, Leapp generates _/var/log/leapp/answerfile_ with true/false questions. Leapp utility requires answers to all these questions in order to proceed with the upgrade. ::: + :::tip + You can also inspect the upgrade report in the Cockpit Web UI. See [Inspecting the upgrade report in Cockpit Web UI](/elevate/ELevate-quickstart-guide#inspecting-the-upgrade-report-in-cockpit-web-ui). + ::: + - Currently, the direct upgrade from Almalinux OS 9 to AlmaLinux OS 10.0 goes smoothly. If there is a progressive upgrade from CentOS 7 to AlmaLinux OS 10.0, please check the [known issues](#known-issues) section. :::tip