You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* 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
Copy file name to clipboardExpand all lines: docs/elevate/ELevate-quickstart-guide.md
+33-17Lines changed: 33 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
title: "ELevate Quickstart Guide"
3
3
---
4
4
5
-
###### last updated: 2025-06-05
5
+
###### last updated: 2025-06-06
6
6
7
7
# ELevate Quickstart Guide
8
8
@@ -12,11 +12,12 @@ Before beginning, we **HIGHLY** recommend that you follow system administration
12
12
13
13
This guide contains steps on how to upgrade your RHEL-based operating system to the next major version.
14
14
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.
17
17
:::
18
18
19
19
The ELevate project supports a number of 3rd party repositories:
20
+
20
21
* 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.
21
22
* Docker CE - for all supported operating systems.
22
23
* 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:
37
38
\** - 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>
38
39
\*** - Currently, updgrades to AlmaLinux 10 and AlmaLinux Kitten 10 don't support x86_64_v2 architecture.
39
40
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
41
48
42
-
You need CentOS 7, Scientific Linux 7, AlmaLinux 8, CentOS Stream 8, or Rocky Linux 8 system installed to use this guide.
43
49
**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:
* Install leapp packages and upgrade data for the target OS you want to upgrade to. Possible options are:
62
71
* 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>
63
73
* leapp-data-centos <small>* leapp-data-centos package is designed for upgrades to CentOS Stream.</small>
* 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.
* There have been no widely popular fixes for RHEL9-based operating systems. The inhibitor can be unsupported x86_64_v2 hardware.
98
111
99
112
Check the [ELevate Frequent Issues](/elevate/ELevate-frequent-issues) page for known and frequent issues and guidance steps to solve them.
100
113
101
114
* Start an upgrade. You'll be offered to reboot the system after this process is completed.
102
-
```
115
+
116
+
```bash
103
117
sudo leapp upgrade
104
118
sudo reboot
105
119
```
106
120
107
121
* 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.
108
122
109
123
* 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
111
126
cat /etc/redhat-release
112
127
cat /etc/os-release
113
128
rpm -qa | grep el7 # for 7 to 8 upgrade
114
129
rpm -qa | grep el8 # for 8 to 9 upgrade
130
+
rpm -qa | grep el9 # for 9 to 10 upgrade
115
131
cat /var/log/leapp/leapp-report.txt
116
132
cat /var/log/leapp/leapp-upgrade.log
117
133
```
118
134
119
135
### Demo Video
120
136
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.
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