Skip to content

Commit 30ed3d0

Browse files
yuravksboldyreva
andauthored
Update docs to cover "ELevating CentOS 7 to AlmaLinux 10" (#625)
* Update Changelog.md as of 2025-06-05 * Add "ELevating CentOS 7 to AlmaLinux 10" guide. * Update "About ELevate project" to cover CentOS7 to AlmaLinux 10 upgrade path. Replace docs/elevate/ELevating-CentOS7-to-AlmaLinux-9.md with docs/elevate/ELevating-CentOS7-to-AlmaLinux-10.md * Update "ELevate Quickstart Guide" and "AlmaLinux Migration Projects" page * Update ELevate URL on the left menue. * Update docs/elevate/ELevate-quickstart-guide.md Co-authored-by: Sofia Boldyreva <[email protected]> * Update docs/elevate/ELevating-CentOS7-to-AlmaLinux-10.md Co-authored-by: Sofia Boldyreva <[email protected]> * Update docs/elevate/ELevating-CentOS7-to-AlmaLinux-10.md Co-authored-by: Sofia Boldyreva <[email protected]> * Update docs/elevate/ELevating-CentOS7-to-AlmaLinux-10.md Co-authored-by: Sofia Boldyreva <[email protected]> * Update docs/elevate/ELevating-CentOS7-to-AlmaLinux-10.md Co-authored-by: Sofia Boldyreva <[email protected]> --------- Co-authored-by: Sofia Boldyreva <[email protected]>
1 parent bec3f43 commit 30ed3d0

File tree

7 files changed

+592
-309
lines changed

7 files changed

+592
-309
lines changed

docs/.vuepress/config.js

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@ module.exports = {
6262
{
6363
title: "AlmaLinux 9 betas",
6464
children: [
65-
'/release-notes/9.6-beta',
65+
'/release-notes/9.6-beta',
6666
'/release-notes/9.5-beta',
6767
'/release-notes/9.4-beta',
6868
'/release-notes/9.3-beta',
@@ -297,7 +297,7 @@ module.exports = {
297297
path: '/elevate/',
298298
children: [
299299
'/elevate/ELevate-quickstart-guide',
300-
'/elevate/ELevating-CentOS7-to-AlmaLinux-9',
300+
'/elevate/ELevating-CentOS7-to-AlmaLinux-10',
301301
'/elevate/ELevating-CentOS6-to-CentOS7',
302302
'/elevate/ELevate-offline-guide',
303303
'/elevate/ELevate-testing-guide',

docs/elevate/Changelog.md

Lines changed: 47 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,58 @@
22
title: 'ELevate Changelog'
33
---
44

5-
###### last updated: 2025-05-22
5+
###### last updated: 2025-06-05
66

77
# ELevate Changelog
88

99
**Note**, this changelog only includes updates made from 2024-09-24 onwards, and does not include any changes made prior to this date.
1010

11+
## 2025-06-05
12+
Released from Testing to Stable:
13+
14+
#### General updates
15+
16+
* Leapp data updated to [the latest upstream state](https://github.com/oamg/leapp-repository/commit/ffd6d8e456484630f99d98d5bff955914af02aa5).
17+
* Leapp version updated to `0.22.0-3.elevate.1`.
18+
19+
#### PES data updates
20+
* Add support for:
21+
* **AlmaLinux release 10.0**
22+
* **AlmaLinux Kitten release 10**
23+
* **CentOS Stream release 10**
24+
* Install rpm public GPG key(s) into distro specific path
25+
* Device driver deprecation data:
26+
* leapp-repository sha 9c621a91199c093f603ef30ba3daf59010c20e47
27+
* PES data, `pes-events.json` leapp-repository sha ffd6d8e456484630f99d98d5bff955914af02aa5
28+
* updated 9to10 data
29+
* solve valgrind-docs, valgrind-scripts with valgrind package conflicts during 8to9 upgrade
30+
* PES data, `config.json`:
31+
* add libreport-rhel-anaconda-bugzilla (except centos) to the removable packages list, with scenarios: 9to9, 9to10
32+
* add redhat-flatpak-repo, redhat-flatpak-preinstall-firefox, redhat-flatpak-preinstall-thunderbird to the removable packages list, with scenarios: 9to10
33+
34+
#### Leapp code enhancements
35+
* Leapp code updated to [the latest upstream version](https://github.com/oamg/leapp-repository/commit/ffd6d8e456484630f99d98d5bff955914af02aa5).
36+
* Minor updates in generated reports
37+
* Resolves: RHEL-67621, RHEL-67719, RHEL-16881
38+
* Require leapp-framework >= 6.1
39+
* Simplified use of the LiveMode experimental feature with additional enhancements
40+
* Fix the check of deprecated PCI devices and drivers
41+
* Add RHEL 9.7 product certificates
42+
* Gracefully handle CentOS OS versioning style
43+
* Introduced the --enable-experimental-feature to simplify use of experimental features
44+
* Manage RPM GPG keys during the upgrade respecting used linux distributions
45+
* Minor fixes in reports
46+
* Prevent a crach during post-upgrade phases when no custom SELinux modules needs to be migrated
47+
* Update leapp upgrade data files
48+
* Resolves: RHEL-53801, RHEL-77945, RHEL-84978
49+
50+
#### Vendor-Specific Changes
51+
* Create symlinks of RHSM certs path like `prod-certs/VERSION_MAJOR -> prod-certs/VERSION_MAJOR.VERSION_MINOR`
52+
* Exclude CentOS packages public GPG keys
53+
* Correct the list of leapp and leapp-repository rpms, that should be preserved during the 9to10 upgrade
54+
* Exclude **Microsoft** Vendor from all upgrade paths
55+
* Add **EPEL**, **Docker CE** and **PostgreSQL** Vendors for 9to10 upgrade path
56+
1157
## 2025-01-23
1258
Released from Testing to Stable:
1359

docs/elevate/ELevate-quickstart-guide.md

Lines changed: 33 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: "ELevate Quickstart Guide"
33
---
44

5-
###### last updated: 2025-06-05
5+
###### last updated: 2025-06-06
66

77
# ELevate Quickstart Guide
88

@@ -12,11 +12,12 @@ Before beginning, we **HIGHLY** recommend that you follow system administration
1212

1313
This guide contains steps on how to upgrade your RHEL-based operating system to the next major version.
1414

15-
:::tip
16-
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.
15+
:::tip
16+
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 10](/elevate/ELevating-CentOS7-to-AlmaLinux-10.md) guide for more information.
1717
:::
1818

1919
The ELevate project supports a number of 3rd party repositories:
20+
2021
* EPEL support is currently available for upgrades to AlmaLinux OS only. **Note**, that the support works only for those packages from EL 9 that are currently available for EL 10. Unavailable packages from EL 9 will remain on the system after the upgrade.
2122
* Docker CE - for all supported operating systems.
2223
* MariaDB - for supported operating systems excluding AlmaLinux 10, AlmaLinux Kitten 10, and CentOS Stream 10.
@@ -37,34 +38,43 @@ Currently, the following upgrade paths are available:
3738
\** - 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>
3839
\*** - Currently, updgrades to AlmaLinux 10 and AlmaLinux Kitten 10 don't support x86_64_v2 architecture.
3940

40-
### Requirements
41+
### Requirements
42+
43+
Depending on your upgrade path, you'll need one of the following systems installed to use this guide:
44+
* CentOS 7 – if you're upgrading to EL 8
45+
* Scientific Linux 7 – if you're upgrading to AlmaLinux 8
46+
* AlmaLinux 8, CentOS Stream 8, or Rocky Linux 8 – if you're upgrading to EL 9
47+
* AlmaLinux 9 or CentOS Stream 9 – if you're upgrading to EL10
4148

42-
You need CentOS 7, Scientific Linux 7, AlmaLinux 8, CentOS Stream 8, or Rocky Linux 8 system installed to use this guide.
4349
**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:
44-
```
50+
51+
```bash
4552
sudo curl -o /etc/yum.repos.d/CentOS-Base.repo https://el7.repo.almalinux.org/centos/CentOS-Base.repo
4653
```
4754

4855
## Upgrade steps
4956

5057
* A fully updated system is required to accomplish the upgrade. Install the latest updates and reboot your machine:
51-
```
58+
59+
```bash
5260
sudo yum update -y
5361
sudo reboot
5462
```
5563

5664
* Install `elevate-release` package with the project repo and GPG key.
57-
```
65+
66+
```bash
5867
sudo yum install -y http://repo.almalinux.org/elevate/elevate-release-latest-el$(rpm --eval %rhel).noarch.rpm
5968
```
6069

6170
* Install leapp packages and upgrade data for the target OS you want to upgrade to. Possible options are:
6271
* leapp-data-almalinux
72+
* leapp-data-almalinux-kitten <small>* leapp-data-almalinux-kitten package is designed for upgrades from AlmaLinux OS 9 to AlmaLinux Kitten OS 10.</small>
6373
* leapp-data-centos <small>* leapp-data-centos package is designed for upgrades to CentOS Stream.</small>
6474
* leapp-data-oraclelinux
6575
* leapp-data-rocky
66-
67-
```
76+
77+
```bash
6878
sudo yum install -y leapp-upgrade leapp-data-almalinux
6979
```
7080
* 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.
@@ -73,7 +83,7 @@ sudo curl -o /etc/yum.repos.d/CentOS-Base.repo https://el7.repo.almalinux.org/ce
7383
Preupgrade check will fail as the default install doesn't meet all requirements for upgrade.
7484
:::
7585

76-
```
86+
```bash
7787
sudo leapp preupgrade
7888
```
7989

@@ -85,43 +95,49 @@ sudo curl -o /etc/yum.repos.d/CentOS-Base.repo https://el7.repo.almalinux.org/ce
8595

8696
* 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.
8797
* For CentOS 7:
88-
```
98+
99+
```bash
89100
sudo rmmod pata_acpi
90101
echo PermitRootLogin yes | sudo tee -a /etc/ssh/sshd_config
91102
sudo leapp answer --section remove_pam_pkcs11_module_check.confirm=True
92103
```
93104
* For RHEL8-based operating systems:
94-
```
105+
106+
```bash
95107
sudo sed -i "s/^AllowZoneDrifting=.*/AllowZoneDrifting=no/" /etc/firewalld/firewalld.conf
96108
sudo leapp answer --section check_vdo.confirm=True
97109
```
110+
* There have been no widely popular fixes for RHEL9-based operating systems. The inhibitor can be unsupported x86_64_v2 hardware.
98111

99112
Check the [ELevate Frequent Issues](/elevate/ELevate-frequent-issues) page for known and frequent issues and guidance steps to solve them.
100113

101114
* Start an upgrade. You'll be offered to reboot the system after this process is completed.
102-
```
115+
116+
```bash
103117
sudo leapp upgrade
104118
sudo reboot
105119
```
106120
107121
* 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.
108122
109123
* 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.
110-
```
124+
125+
```bash
111126
cat /etc/redhat-release
112127
cat /etc/os-release
113128
rpm -qa | grep el7 # for 7 to 8 upgrade
114129
rpm -qa | grep el8 # for 8 to 9 upgrade
130+
rpm -qa | grep el9 # for 9 to 10 upgrade
115131
cat /var/log/leapp/leapp-report.txt
116132
cat /var/log/leapp/leapp-upgrade.log
117133
```
118134
119135
### Demo Video
120136
121-
Here we have provided a demo of a CentOS 7.x to AlmaLinux 8.x upgrade using the AlmaLinux ELevate Project.
137+
Here we have provided a demo of a CentOS 7.x to AlmaLinux 8.x upgrade using the AlmaLinux ELevate Project.
122138
123139
<iframe width="856" height="482" src="https://www.youtube.com/embed/Vzl9QxG5mvo" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
124140
125-
## Get Help
141+
## Get Help
126142
127143
For more help and assistance reach out to us in the ~migration channel on the [AlmaLinux Community Chat](https://chat.almalinux.org/almalinux/channels/migration).

0 commit comments

Comments
 (0)