Skip to content

Commit

Permalink
Merge pull request #574 from sboldyreva/elevate-c10s
Browse files Browse the repository at this point in the history
Updating ELevate to include CS9 to CS10 upgrade
  • Loading branch information
bennyvasquez authored Jan 30, 2025
2 parents 726727b + 9bdbd81 commit 416b02b
Show file tree
Hide file tree
Showing 7 changed files with 46 additions and 16 deletions.
2 changes: 1 addition & 1 deletion docs/.vuepress/public/images/ELevate.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion docs/.vuepress/public/images/ELevateNG.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
37 changes: 32 additions & 5 deletions docs/elevate/ELevate-NG-testing-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "ELevate NG Testing Guide"
---

###### last updated: 2024-12-19
###### last updated: 2025-01-30

# ELevate NG Testing Guide

Expand Down Expand Up @@ -31,7 +31,7 @@ Currently, the following upgrade paths are available:

\* - upgrading from Scientific Linux 7 to AlmaLinux 8 requires a workaround. Please, see more in the [known issues](#known-issues). <br>
\** - 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.<br>
\*** - Upgrade to AlmaLinux OS 10 is only available to the version **10.0 Beta**. Currently, it doesn't have support x86_64_v2.
\*** - Upgrade to AlmaLinux OS 10 is only available to the version **10.0 Beta**. Currently, it doesn't have support for x86_64_v2.


## Upgrade CentOS 7 to AlmaLinux 8
Expand Down Expand Up @@ -174,7 +174,7 @@ After these preparations are completed, you can upgrade your AlmaLinux 8 machine
```
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
Expand Down Expand Up @@ -292,6 +292,11 @@ After these preparations are completed, you can upgrade your AlmaLinux 9 machine
This upgrade is currently in development and testing. The main goals are to deliver working `leapp-data` and `leapp-repository` packages needed for the upgrade and to be able to upgrade to AlmaLinux OS 10 successfully. This upgrade is not recommended for production machines.
:::
:::tip
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.
:::
* Install ELevate NG version repo config for AlmaLinux 9:
```
sudo curl -o /etc/yum.repos.d/elevate-ng.repo https://repo.almalinux.org/elevate/testing/elevate-ng-el$(rpm -E %rhel).repo
Expand All @@ -304,7 +309,12 @@ This upgrade is currently in development and testing. The main goals are to deli
```
sudo yum install -y leapp-upgrade leapp-data-almalinux
```
:::tip
For the upgrade to CentOS Stream 10, please, use the `leapp-data-centos` package:
```
sudo yum install -y leapp-upgrade leapp-data-centos
```
* 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
Expand All @@ -322,6 +332,10 @@ This upgrade is currently in development and testing. The main goals are to deli
:::
* 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.
:::tip
For CentOS Stream 9 to CentOS Stream 10 upgrade, please, also see the [known issues](#known-issues) section.
:::
* Start an upgrade. You'll be offered to reboot the system after this process is completed.
```
Expand Down Expand Up @@ -382,7 +396,20 @@ If the system has been progressively upgraded from CentOS 7, the following issue
GRUB_TERMINAL_OUTPUT="console"
GRUB_CMDLINE_LINUX="console=ttyS0,115200 console=tty0"
```
### Upgrade from CentOS Strem 9 to CentOS Stream 10
During CentOS Stream 9 to CentOS Stream 10 upgrade the following error can appear during preupgrade/upgrade step and can also be found in the generated */var/log/leapp/leapp-report.txt* file:
```
error: Verifying a signature using certificate 99DB70FAE1D7CE227FB6488205B555B38483C65D (CentOS (CentOS Official Signing Key) <security@centos.org>)
```
To fix the error, please, manually remove and import the CentOS GPG Key using the following commands:
```
rpm -e gpg-pubkey-8483c65d-5ccc5b19
rpm --import https://www.centos.org/keys/RPM-GPG-KEY-CentOS-Official-SHA256
```
## Get Help
Report your feedback to [AlmaLinux ~Migration Channel](https://chat.almalinux.org/almalinux/channels/migration). We're especially interested in packages left from the previous OS versions. This information will allow us to improve ELevate's configuration files.
Expand Down
5 changes: 3 additions & 2 deletions docs/elevate/ELevate-quickstart-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "ELevate Quickstart Guide"
---

###### last updated: 2024-12-10
###### last updated: 2025-01-30

# ELevate Quickstart Guide

Expand Down Expand Up @@ -35,7 +35,8 @@ Currently, the following upgrade paths are available:
![image](/images/ELevate.svg)

\* - upgrading from Scientific Linux 7 to AlmaLinux 8 requires a workaround. Please, see more in the [known issues](/elevate/ELevate-frequent-issues). <br>
\** - 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.
\** - 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.<br>
\*** - upgrade is available as ELevate NG and currently in testing. For details, please, see the [ELevate NG Guide](/elevate/ELevate-NG-testing-guide).

### Requirements

Expand Down
5 changes: 3 additions & 2 deletions docs/elevate/ELevate-testing-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "ELevate Testing Guide"
---

###### last updated: 2024-12-10
###### last updated: 2025-01-30

# ELevate Testing Guide

Expand All @@ -29,7 +29,8 @@ Currently, the following upgrades are available:
![image](/images/ELevate.svg)

\* - upgrading from Scientific Linux 7 to AlmaLinux 8 requires a workaround. Please, see more in the [known issues](/elevate/ELevate-frequent-issues). <br>
\** - 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.
\** - 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.<br>
\*** - upgrade is available as ELevate NG and currently in testing. For details, please, see the [ELevate NG Guide](/elevate/ELevate-NG-testing-guide).


## Upgrade CentOS 7 to AlmaLinux 8
Expand Down
5 changes: 3 additions & 2 deletions docs/elevate/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "About ELevate project"
---

###### last updated: 2024-12-10
###### last updated: 2025-01-30

# About the project

Expand Down Expand Up @@ -36,7 +36,8 @@ Currently, the following upgrade paths are available:
![image](/images/ELevate.svg)

\* - upgrading from Scientific Linux 7 to AlmaLinux 8 requires a workaround. Please, see more in the [known issues](/elevate/ELevate-frequent-issues). <br>
\** - 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.
\** - 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.<br>
\*** - upgrade is available as ELevate NG and currently in testing. For details, please, see the [ELevate NG Guide](/elevate/ELevate-NG-testing-guide).

## How to upgrade

Expand Down
6 changes: 3 additions & 3 deletions docs/migration/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: 'AlmaLinux Migration Projects'
---

###### last updated: 2024-11-14
###### last updated: 2025-01-30

# AlmaLinux Migration Projects

Expand Down Expand Up @@ -52,5 +52,5 @@ Currently, the following upgrade paths are available:

\* - upgrading from Scientific Linux 7 to AlmaLinux 8 requires a workaround. Please, see more in the [known issues](/elevate/ELevate-frequent-issues). <br>
\** - 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.

See the [ELevate](/elevate/) section for the update steps.<br>
\*** - upgrade is available as ELevate NG and currently in testing. For details, please, see the [ELevate NG Guide](/elevate/ELevate-NG-testing-guide).

0 comments on commit 416b02b

Please sign in to comment.