From c3e3535f9301274a9a3dad1cd981ab30bdf7e6ac Mon Sep 17 00:00:00 2001 From: Sofia Boldyreva <87830789+sboldyreva@users.noreply.github.com> Date: Thu, 8 Aug 2024 13:54:15 +0200 Subject: [PATCH] Edits as ELevate NG goes to stable (#472) * Edits as ELevate NG goes to stable --- docs/elevate/ELevate-quickstart-guide.md | 125 +++++++++--------- .../ELevating-CentOS7-to-AlmaLinux-9.md | 11 +- docs/elevate/README.md | 35 ++--- docs/migration/README.md | 27 ++-- 4 files changed, 109 insertions(+), 89 deletions(-) diff --git a/docs/elevate/ELevate-quickstart-guide.md b/docs/elevate/ELevate-quickstart-guide.md index 50b40fe4f..3cabb2915 100644 --- a/docs/elevate/ELevate-quickstart-guide.md +++ b/docs/elevate/ELevate-quickstart-guide.md @@ -2,7 +2,7 @@ title: "ELevate Quickstart Guide" --- -###### last updated: 2024-07-08 +###### last updated: 2024-08-07 # ELevate Quickstart Guide @@ -16,39 +16,41 @@ This guide contains steps on how to upgrade your RHEL-based operating system to Please note, the ELevate project is designed to perform one-step upgrades. If you wish to perform an upgrade from CentOS7, you need to split the process. Please check the [ELevating CentOS7 to AlmaLinux 9](/elevate/ELevating-CentOS7-to-AlmaLinux-9.md) guide for more information. ::: -The ELevate supports a number of 3rd party repositories for all supported systems: -* EPEL -* Imunify -* KernelCare -* MariaDB -* nginx -* PostgreSQL +The ELevate project supports a number of 3rd party repositories: +* EPEL support is currently available for upgrades to AlmaLinux OS only. +* MariaDB - for all supported operating systems. +* nginx - for all supported operating systems. +* PostgreSQL - for all supported operating systems. +* Imunify - for upgrades to EL 8. +* KernelCare - for upgrades to EL 8. Currently, the following upgrade paths are available: -![image](/images/ELevate.svg) +![image](/images/ELevateNG.svg) -\* - upgrade to CentOS Stream 9 is currently in process and will be available later.
-\** - upgrade to Oracle Linux 9 is available with the [Oracle Leapp utility](https://blogs.oracle.com/linux/post/upgrade-oracle-linux-8-to-oracle-linux-9-using-leapp) and will not be supported by ELevate project. +\* - upgrading from Scientific Linux 7 to AlmaLinux 8 requires a workaround. Please, see more in the [known issues](#known-issues).
+\** - upgrading to Oracle Linux 9 is available with the [Oracle Leapp utility](https://blogs.oracle.com/linux/post/upgrade-oracle-linux-8-to-oracle-linux-9-using-leapp) and will not be supported by ELevate project. -**Requirements:** You need CentOS 7, AlmaLinux 8, EuroLinux 8 or Rocky Linux 8 system installed to use this guide. +### Requirements -* A fully updated system is required to accomplish the upgrade. So, install the latest updates first, and reboot. +You need CentOS 7, Scientific Linux 7, AlmaLinux 8, CentOS Stream 8, EuroLinux 8 or Rocky Linux 8 system installed to use this guide. +**NOTE:** Since the CentOS 7 repositories are now offline you will need to swap to the CentOS vault, or you can use our CentOS 7 mirror that we've setup for use with ELevate: +``` +sudo curl -o /etc/yum.repos.d/CentOS-Base.repo https://el7.repo.almalinux.org/centos/CentOS-Base.repo +``` + +## Upgrade steps + +* A fully updated system is required to accomplish the upgrade. Install the latest updates and reboot your machine: ``` sudo yum update -y sudo reboot ``` - **NOTE:** Since the CentOS 7 repositories are now offline you will need to swap to the CentOS vault, or you can use our CentOS 7 mirror that we've setup for use with ELevate: - ```bash - sudo curl -o /etc/yum.repos.d/CentOS-Base.repo https://el7.repo.almalinux.org/centos/CentOS-Base.repo - sudo yum upgrade -y - sudo reboot - ``` * Install `elevate-release` package with the project repo and GPG key. -``` -sudo yum install -y http://repo.almalinux.org/elevate/elevate-release-latest-el$(rpm --eval %rhel).noarch.rpm -``` + ``` + sudo yum install -y http://repo.almalinux.org/elevate/elevate-release-latest-el$(rpm --eval %rhel).noarch.rpm + ``` * Install leapp packages and upgrade data for the OS you want to upgrade. Possible options are: * leapp-data-almalinux @@ -56,58 +58,59 @@ sudo yum install -y http://repo.almalinux.org/elevate/elevate-release-latest-el$ * leapp-data-eurolinux * leapp-data-oraclelinux * leapp-data-rocky -``` -sudo yum install -y leapp-upgrade leapp-data-almalinux -``` + + ``` + sudo yum install -y leapp-upgrade leapp-data-almalinux + ``` * 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 -Preupgrade check will fail as the default install doesn't meet all requirements for upgrade. -::: + :::warning + Preupgrade check will fail as the default install doesn't meet all requirements for upgrade. + ::: -``` -sudo leapp preupgrade -``` + ``` + sudo leapp preupgrade + ``` -This summary report will help you get a picture of whether it is possible to continue the upgrade. + This summary report will help you get a picture of whether it is possible to continue the upgrade. -:::tip -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 + 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. + ::: -* The following fixes from *the /var/log/leapp/leapp-report.txt* file are the most popular for CentOS 7, but it's recommended to review the whole file. -``` -sudo rmmod pata_acpi -echo PermitRootLogin yes | sudo tee -a /etc/ssh/sshd_config -sudo leapp answer --section remove_pam_pkcs11_module_check.confirm=True -``` +* The following fixes from *the /var/log/leapp/leapp-report.txt* file are the most popular ones, but it's recommended to review the whole file. + * For CentOS 7: + ``` + sudo rmmod pata_acpi + echo PermitRootLogin yes | sudo tee -a /etc/ssh/sshd_config + sudo leapp answer --section remove_pam_pkcs11_module_check.confirm=True + ``` + * For RHEL8-based operating systems: + ``` + sudo sed -i "s/^AllowZoneDrifting=.*/AllowZoneDrifting=no/" /etc/firewalld/firewalld.conf + sudo leapp answer --section check_vdo.no_vdo_devices=True + ``` -* Here are the most popular fixes for RHEL8-based operating systems: -``` -sudo sed -i "s/^AllowZoneDrifting=.*/AllowZoneDrifting=no/" /etc/firewalld/firewalld.conf -sudo leapp answer --section check_vdo.no_vdo_devices=True -``` -Check the [ELevate Frequent Issues](/elevate/ELevate-frequent-issues) page for known and frequent issues and guidance steps to solve them. + Check the [ELevate Frequent Issues](/elevate/ELevate-frequent-issues) page for known and frequent issues and guidance steps to solve them. * Start an upgrade. You'll be offered to reboot the system after this process is completed. -``` -sudo leapp upgrade -sudo reboot -``` + ``` + sudo leapp upgrade + sudo reboot + ``` -* A new entry in GRUB called `ELevate-Upgrade-Initramfs` will appear. The system will be automatically booted into it. - See how the update process goes in the console. +* A new entry in GRUB called `ELevate-Upgrade-Initramfs` will appear. The system will be automatically booted into it. See how the update process goes in the console. * After reboot, login to the system and check how the upgrade went. Verify that the current OS is the one you need. Check logs and packages left from previous OS version, consider removing them or update manually. -``` -cat /etc/redhat-release -cat /etc/os-release -rpm -qa | grep el7 # for 7 to 8 upgrade -rpm -qa | grep el8 # for 8 to 9 upgrade -cat /var/log/leapp/leapp-report.txt -cat /var/log/leapp/leapp-upgrade.log -``` + ``` + cat /etc/redhat-release + cat /etc/os-release + rpm -qa | grep el7 # for 7 to 8 upgrade + rpm -qa | grep el8 # for 8 to 9 upgrade + cat /var/log/leapp/leapp-report.txt + cat /var/log/leapp/leapp-upgrade.log + ``` ### Demo Video diff --git a/docs/elevate/ELevating-CentOS7-to-AlmaLinux-9.md b/docs/elevate/ELevating-CentOS7-to-AlmaLinux-9.md index 59c19d27e..2b8705923 100644 --- a/docs/elevate/ELevating-CentOS7-to-AlmaLinux-9.md +++ b/docs/elevate/ELevating-CentOS7-to-AlmaLinux-9.md @@ -6,10 +6,19 @@ title: "ELevating CentOS 7 to AlmaLinux 9" # ELevating CentOS 7 to AlmaLinux 9 -As the Leapp tool is designed to perform one-step upgrades, in order to upgrade your CentOS 7 machine to AlmaLinux 9 you need to split the upgrade process: +This guide contains steps on how to upgrade your CentOS 7 machine to AlmaLinux OS 9. +As the Leapp tool is designed to perform one-step upgrades, you need to split the upgrade process: * CentOS 7 to AlmaLinux 8 * AlmaLinux 8 to AlmaLinux 9 +The ELevate project supports a number of 3rd party repositories: +* EPEL support is currently available for upgrades to AlmaLinux OS only. +* MariaDB - for all supported operating systems. +* nginx - for all supported operating systems. +* PostgreSQL - for all supported operating systems. +* Imunify - for upgrades to EL 8. +* KernelCare - for upgrades to EL 8. + ## Upgrade CentOS 7 to AlmaLinux 8 * Update the system to get the latest updates and reboot your machine. diff --git a/docs/elevate/README.md b/docs/elevate/README.md index 300de0902..a524240a5 100644 --- a/docs/elevate/README.md +++ b/docs/elevate/README.md @@ -2,7 +2,7 @@ title: "About ELevate project" --- -###### last updated: 2024-07-08 +###### last updated: 2024-08-07 # About the project @@ -14,29 +14,34 @@ The [Red Hat Upgrade Tool](https://github.com/upgrades-migrations/redhat-upgrade # Available migration paths -The ELevate supports several 3rd party repositories for all supported systems: -* EPEL -* Imunify -* KernelCare -* MariaDB -* nginx -* PostgreSQL +:::tip +Please note, the ELevate project is designed to perform one-step upgrades. If you wish to perform an upgrade from CentOS7, you need to split the process. Please check the [ELevating CentOS7 to AlmaLinux 9](/elevate/ELevating-CentOS7-to-AlmaLinux-9.md) guide for more information. +::: -There are several ways to perform upgrade these days. Here is the list to see which upgrade directions are available: +The ELevate project supports a number of 3rd party repositories: +* EPEL support is currently available for upgrades to AlmaLinux OS only. +* MariaDB - for all supported operating systems. +* nginx - for all supported operating systems. +* PostgreSQL - for all supported operating systems. +* Imunify - for upgrades to EL 8. +* KernelCare - for upgrades to EL 8. -![image](/images/ELevate.svg) +Currently, the following upgrade paths are available: -\* - upgrading to CentOS Stream 9 is currently in process and will be available later.
-\** - upgrading to Oracle Linux 9 is available with the [Oracle Leapp utility](https://blogs.oracle.com/linux/post/upgrade-oracle-linux-8-to-oracle-linux-9-using-leapp) and will not be supported by the ELevate project. +![image](/images/ELevateNG.svg) + +\* - upgrading from Scientific Linux 7 to AlmaLinux 8 requires a workaround. Please, see more in the [known issues](#known-issues).
+\** - upgrading to Oracle Linux 9 is available with the [Oracle Leapp utility](https://blogs.oracle.com/linux/post/upgrade-oracle-linux-8-to-oracle-linux-9-using-leapp) and will not be supported by ELevate project. # How to upgrade Various guides cover the update steps depending on the upgrade type: -* The [ELevate Quickstart Guide](/elevate/ELevate-quickstart-guide) covers the update steps using the Leapp utility version with 3rd party repositories support and provides the Demo video. +* The [ELevate Quickstart Guide](/elevate/ELevate-quickstart-guide) covers the upgrade steps using the Leapp utility version with 3rd party repositories support and provides the Demo video. * The [ELevate CentOS 7 to AlmaLinux 9 Guide](/elevate/ELevating-CentOS7-to-AlmaLinux-9) covers a two-stage process to upgrade a CentOS 7 machine to AlmaLinux OS 9. * The [ELevate CentOS 6 to CentOS 7 Guide](/elevate/ELevating-CentOS6-to-CentOS7) covers steps to be performed to upgrade CentOS 6 machines to CentOS 7. -* The [ELevate Offline Guide](/elevate/ELevate-offline-guide) covers the update steps on air-gapped machines. -* The [ELevate NG Guide](/elevate/ELevate-NG-testing-guide) covers the update steps using the next Leapp tool version - 0.19.0. +* The [ELevate Offline Guide](/elevate/ELevate-offline-guide) covers the upgrade steps on air-gapped machines. +* The [ELevate NG Guide](/elevate/ELevate-NG-testing-guide) covers the upgrade steps using the next Leapp tool version. +* The [ELevate Testing Guide](/elevate/ELevate-testing-guide) covers the steps for upgrade processes that are in testing. # Package Evolution Service diff --git a/docs/migration/README.md b/docs/migration/README.md index b24e4df4a..95809c7ff 100644 --- a/docs/migration/README.md +++ b/docs/migration/README.md @@ -2,7 +2,7 @@ title: 'AlmaLinux Migration Projects' --- -###### last updated: 2024-04-18 +###### last updated: 2024-08-07 # AlmaLinux Migration Projects @@ -28,20 +28,23 @@ The [Leapp utility](https://leapp.readthedocs.io) and a few [patches](https://gi The [Red Hat Upgrade Tool](https://github.com/upgrades-migrations/redhat-upgrade-tool.git) is used to perform in-place migration between CentOS 6 and CentOS 7. -ELevate supports a number of 3rd party repositories for all supported systems: -* EPEL -* Imunify -* KernelCare -* MariaDB -* nginx -* PostgreSQL +:::tip +Please note, the ELevate project is designed to perform one-step upgrades. If you wish to perform an upgrade from CentOS7, you need to split the process. Please check the [ELevating CentOS7 to AlmaLinux 9](/elevate/ELevating-CentOS7-to-AlmaLinux-9.md) guide for more information. +::: -The project supports the following migration paths: +The ELevate project supports a number of 3rd party repositories: +* EPEL support is currently available for upgrades to AlmaLinux OS only. +* MariaDB - for all supported operating systems. +* nginx - for all supported operating systems. +* PostgreSQL - for all supported operating systems. +* Imunify - for upgrades to EL 8. +* KernelCare - for upgrades to EL 8. -![image](/images/ELevate.svg) +Currently, the following upgrade paths are available: -\* - migration to CentOS Stream 9 is currently in process and will be available later.
-\** - migration to Oracle Linux 9 is available with the [Oracle Leapp utility](https://blogs.oracle.com/linux/post/upgrade-oracle-linux-8-to-oracle-linux-9-using-leapp) and will not be supported by ELevate project. +![image](/images/ELevateNG.svg) +\* - upgrading from Scientific Linux 7 to AlmaLinux 8 requires a workaround. Please, see more in the [known issues](#known-issues).
+\** - upgrading to Oracle Linux 9 is available with the [Oracle Leapp utility](https://blogs.oracle.com/linux/post/upgrade-oracle-linux-8-to-oracle-linux-9-using-leapp) and will not be supported by ELevate project. See the [ELevate](/elevate/) section for the update steps.