diff --git a/docs/elevate/ELevate-NG-testing-guide.md b/docs/elevate/ELevate-NG-testing-guide.md index 81416ea90..2d8bba871 100644 --- a/docs/elevate/ELevate-NG-testing-guide.md +++ b/docs/elevate/ELevate-NG-testing-guide.md @@ -168,7 +168,7 @@ After these preparations are completed, you can upgrade your AlmaLinux 8 machine sudo curl -o /etc/yum.repos.d/elevate-ng.repo https://repo.almalinux.org/elevate/testing/elevate-ng-el$(rpm -E %rhel).repo ``` -* Install leapp packages and upgrade data for AlmaLinux: +* Install leapp packages and upgrade data for AlmaLinux which is target OS: ``` sudo yum install -y leapp-upgrade leapp-data-almalinux ``` diff --git a/docs/elevate/ELevate-frequent-issues.md b/docs/elevate/ELevate-frequent-issues.md index f223d2ed6..06b38a1f2 100644 --- a/docs/elevate/ELevate-frequent-issues.md +++ b/docs/elevate/ELevate-frequent-issues.md @@ -2,7 +2,7 @@ title: ELevate Frequent Issues --- -###### last updated: 2024-07-08 +###### last updated: 2024-09-20 # ELevate Frequent Issues @@ -112,10 +112,17 @@ To resolve this issue, please, follow the steps below: ## Known issues -* For now, the ELevate project supports only CentOS repositories. It doesn't support other third-party (external) repositories. +AlmaLinux Team is working hard to get a solution for these issues. Any contribution is valuable and helps us out. If you want to help and contribute, see [how to contribute](/elevate/#how-to-contribute) information. + * Some CentOS 7 packages can remain after the upgrade. -AlmaLinux Team is working hard to get a solution for these issues. Any contribution is valuable and helps us out. If you want to help and contribute, see [how to contribute](/elevate/#how-to-contribute) information. +### Upgrading from Scientific Linux 7 + +Upgrading from Scientific Linux 7 to AlmaLinux 8 requires a workaround. You can apply it by running the following command before the preupgrade check: + + ``` + rm -rf /usr/share/redhat-release /usr/share/doc/redhat-release + ``` ## Get Help diff --git a/docs/elevate/ELevate-offline-guide.md b/docs/elevate/ELevate-offline-guide.md index 2a945160a..d71a130aa 100644 --- a/docs/elevate/ELevate-offline-guide.md +++ b/docs/elevate/ELevate-offline-guide.md @@ -2,7 +2,7 @@ title: "ELevate Offline Guide" --- -###### last updated: 2024-04-18 +###### last updated: 2024-09-20 # ELevate Offline Guide @@ -80,7 +80,7 @@ To be able to install ELevate packages you need to add the local ELevate mirror ### Install ELevate packages -* Install leapp packages and migration data for the OS you want to upgrade from the private mirror: +* Install leapp packages and migration data for the target OS you want to upgrade to from the private mirror: ``` sudo yum install -y leapp-upgrade leapp-data-almalinux ``` @@ -223,7 +223,7 @@ If this migration is the first one, you have to [create your local mirrors](#pre ### Install ELevate packages -* Install leapp packages and migration data for the OS you want to upgrade from the private mirror: +* Install leapp packages and migration data for the target OS you want to upgrade to from the private mirror: ``` sudo yum install -y leapp-upgrade leapp-data-almalinux ``` diff --git a/docs/elevate/ELevate-quickstart-guide.md b/docs/elevate/ELevate-quickstart-guide.md index 11bc7334a..36172fcc1 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-08-30 +###### last updated: 2024-09-20 # ELevate Quickstart Guide @@ -32,7 +32,7 @@ Currently, the following upgrade paths are available: ![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 from Scientific Linux 7 to AlmaLinux 8 requires a workaround. Please, see more in the [known issues](/elevate/ELevate-frequent-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 @@ -56,17 +56,16 @@ sudo curl -o /etc/yum.repos.d/CentOS-Base.repo https://el7.repo.almalinux.org/ce 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: +* Install leapp packages and upgrade data for the target OS you want to upgrade to. Possible options are: * leapp-data-almalinux - * leapp-data-centos + * leapp-data-centos * leapp-data-centos package is designed for upgrades to CentOS Stream. * leapp-data-eurolinux * leapp-data-oraclelinux * leapp-data-rocky - + ``` 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 diff --git a/docs/elevate/ELevate-testing-guide.md b/docs/elevate/ELevate-testing-guide.md index e7a31e278..642695b91 100644 --- a/docs/elevate/ELevate-testing-guide.md +++ b/docs/elevate/ELevate-testing-guide.md @@ -2,7 +2,7 @@ title: "ELevate Testing Guide" --- -###### last updated: 2024-09-05 +###### last updated: 2024-09-20 # ELevate Testing Guide @@ -28,7 +28,7 @@ Currently, the following upgrades are available: ![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 from Scientific Linux 7 to AlmaLinux 8 requires a workaround. Please, see more in the [known issues](/elevate/ELevate-frequent-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. @@ -48,7 +48,7 @@ Currently, the following upgrades are available: sudo rpm --import https://repo.almalinux.org/elevate/RPM-GPG-KEY-ELevate ``` -* Install leapp packages and upgrade data for AlmaLinux: +* Install leapp packages and upgrade data for AlmaLinux which is target OS to upgrade to: ``` sudo yum install -y leapp-upgrade leapp-data-almalinux ``` diff --git a/docs/elevate/ELevating-CentOS7-to-AlmaLinux-9.md b/docs/elevate/ELevating-CentOS7-to-AlmaLinux-9.md index 7a8a0ca97..c9244e814 100644 --- a/docs/elevate/ELevating-CentOS7-to-AlmaLinux-9.md +++ b/docs/elevate/ELevating-CentOS7-to-AlmaLinux-9.md @@ -38,7 +38,7 @@ You can contribute to the project and add more 3rd party repositories support. S 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 AlmaLinux: +* Install leapp packages and upgrade data for AlmaLinux which is target OS: ``` sudo yum install -y leapp-upgrade leapp-data-almalinux ``` diff --git a/docs/elevate/README.md b/docs/elevate/README.md index a6206ac8b..8af0d880d 100644 --- a/docs/elevate/README.md +++ b/docs/elevate/README.md @@ -2,7 +2,7 @@ title: "About ELevate project" --- -###### last updated: 2024-08-30 +###### last updated: 2024-09-20 # About the project @@ -34,7 +34,7 @@ Currently, the following upgrade paths are available: ![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 from Scientific Linux 7 to AlmaLinux 8 requires a workaround. Please, see more in the [known issues](/elevate/ELevate-frequent-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 diff --git a/docs/migration/README.md b/docs/migration/README.md index 0933049be..a7a8c7cb5 100644 --- a/docs/migration/README.md +++ b/docs/migration/README.md @@ -48,7 +48,7 @@ Currently, the following upgrade paths are available: ![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 from Scientific Linux 7 to AlmaLinux 8 requires a workaround. Please, see more in the [known issues](/elevate/ELevate-frequent-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.