Skip to content

Commit c6f3fb0

Browse files
yuravkyuravk
committed
Update ELevate documentation
Update Changelog as of 2025-11-03. Update vendors list in Contribution Guide, README, NG Testing Guide, Quickstart Guide, Testing Guide and ELevating CentOS 7 to AlmaLinux 10. Add warning, to the "Prepare the system for upgrading to ..." chapters, to proceed with certain steps if incremental upgrade only. Add "Import ELevate GPG key" step where it is missed. Update elevate-release package to use $releasever instead of %{rhel} in baseurl
1 parent 628d86f commit c6f3fb0

File tree

7 files changed

+181
-35
lines changed

7 files changed

+181
-35
lines changed

‎docs/elevate/Changelog.md‎

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

5-
###### last updated: 2025-08-20
5+
###### last updated: 2025-11-03
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-11-03
12+
13+
Released to Stable:
14+
15+
#### PES data updates
16+
17+
- New Vendor **elevate** - ELevate enables upgrades between major versions of RHEL derivatives. Enabled for all upgrade paths
18+
- Enable Vendors for 9 to 10 upgrade:
19+
- **nginx**
20+
- **kernelcare**
21+
- **mariadb** (without MaxScale and Tools repositories)
22+
- **imunify**
23+
- **imunify360-alt-php**
24+
- Vendor **kernelcare** use `el-sig202505` repository
25+
- Vendor **imunify**: update rpm GPG key, correct EL9 `imunify360-testing` repository baseurl, update packages SIGs
26+
- Vendor **imunify360-alt-php** update rpm GPG key, update packages SIGs
27+
28+
#### ELevate release package
29+
30+
- Use `$releasever` instead of `%{rhel}` in `baseurl`
31+
1132
## 2025-08-20
1233

1334
Released to Stable:

‎docs/elevate/Contribution-guide.md‎

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

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

77
# Contribute to the ELevate project
88

@@ -17,12 +17,13 @@ Currently, the ELevate project supports the following of 3rd party repositories:
1717

1818
- 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.
1919
- Docker CE - for all supported operating systems.
20-
- MariaDB - for supported operating systems excluding AlmaLinux 10, AlmaLinux Kitten 10, and CentOS Stream 10.
21-
- nginx - for supported operating systems excluding AlmaLinux 10, AlmaLinux Kitten 10, and CentOS Stream 10.
20+
- MariaDB - for supported operating systems.
21+
- nginx - for supported operating systems.
2222
- PostgreSQL - for all supported operating systems.
23-
- Imunify - for upgrades to EL 8.
24-
- KernelCare - for supported operating systems excluding AlmaLinux 10, AlmaLinux Kitten 10, and CentOS Stream 10.
23+
- Imunify - for upgrades to EL 8 and EL 10.
24+
- KernelCare - for supported operating systems.
2525
- TuxCare - for all supported operating systems.
26+
- ELevate - for all supported operating systems.
2627

2728
This guide provides steps to integrate 3rd party repository packages into the ELevate upgrade process.
2829
:::danger

‎docs/elevate/ELevate-NG-testing-guide.md‎

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

5-
###### last updated: 2025-07-03
5+
###### last updated: 2025-11-03
66

77
# ELevate NG Testing Guide
88

@@ -14,12 +14,13 @@ The ELevate NG supports a number of 3rd party repositories:
1414

1515
- 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.
1616
- Docker CE - for all supported operating systems.
17-
- MariaDB - for supported operating systems excluding AlmaLinux 10, AlmaLinux Kitten 10, and CentOS Stream 10.
18-
- nginx - for supported operating systems excluding AlmaLinux 10, AlmaLinux Kitten 10, and CentOS Stream 10.
17+
- MariaDB - for supported operating systems.
18+
- nginx - for supported operating systems.
1919
- PostgreSQL - for all supported operating systems.
20-
- Imunify - for upgrades to EL 8.
21-
- KernelCare - for supported operating systems excluding AlmaLinux 10, AlmaLinux Kitten 10, and CentOS Stream 10.
20+
- Imunify - for upgrades to EL 8 and EL 10.
21+
- KernelCare - for supported operating systems.
2222
- TuxCare - for all supported operating systems.
23+
- ELevate - for all supported operating systems.
2324

2425
:::tip
2526
You can add more 3rd party repositories support. See more on the [Contribute](/elevate/Contribution-guide) page.
@@ -143,6 +144,91 @@ EL7 to EL8 upgrades aren't supported by [leapp-repository upstream](https://gith
143144

144145
Please follow the [ELevating CentOS 7 to AlmaLinux 10](/elevate/ELevating-CentOS7-to-AlmaLinux-10) guide to upgrade CentOS7 to AlmaLinux 8.
145146

147+
## Prepare the system for upgrading to AlmaLinux 9
148+
149+
:::warning
150+
Skip these steps if your system was NOT upgraded from EL 7.
151+
:::
152+
153+
When successfully upgraded to AlmaLinux 8 OS, consider performing these steps to prepare your system for upgrading to AlmaLinux 9:
154+
155+
- Navigate to the **/etc/** directory and use an editor of your choice to edit the **yum.conf** file. You need to remove everything from the **exclude** line especially that refers to elevate or leapp.
156+
157+
##### An example of yum.conf file:
158+
159+
```bash
160+
[main]
161+
gpgcheck=1
162+
installonly_limit=3
163+
clean_requirements_on_remove=True
164+
best=True
165+
skip_if_unavailable=False
166+
exclude=python2-leapp,snactor,leapp-upgrade-el7toel8,leapp
167+
```
168+
169+
- Then navigate to the _/etc/dnf/_ directory and use an editor of your choice to do the same in the **dnf.conf** file.
170+
- Now you can remove/manually upgrade packages left from CentOS 7 without any conflicts.
171+
- Check packages left from CentOS 7:
172+
173+
```bash
174+
rpm -qa | grep el7
175+
```
176+
177+
An example output with a list of packages:
178+
179+
```bash
180+
leapp-data-almalinux-0.5-1.el7.20241127.noarch
181+
leapp-0.18.0-2.el7.noarch
182+
kernel-3.10.0-1160.119.1.el7.x86_64
183+
python2-leapp-0.18.0-2.el7.noarch
184+
leapp-upgrade-el7toel8-0.21.0-5.el7.elevate.4.noarch
185+
kernel-3.10.0-1127.el7.x86_64
186+
```
187+
188+
As mentioned above, consider removing these packages or upgrading them manually to proceed with upgrade to AlmaLinux 9.
189+
190+
:::tip
191+
If you face difficulties while removing the packages, the following command might help you:
192+
193+
```bash
194+
sudo rpm -e --nodeps <package_name>
195+
```
196+
197+
:::
198+
199+
- You can also check for the packages left from the upgrade process and remove them:
200+
201+
```bash
202+
rpm -qa | grep elevate
203+
rpm -qa | grep leapp
204+
```
205+
206+
- Check whether you have the _/root/tmp_leapp_py3_ directory created and if so delete it.
207+
208+
```bash
209+
sudo rm -fr /root/tmp_leapp_py3
210+
```
211+
212+
- Clean up your machine.
213+
214+
```bash
215+
sudo dnf clean all
216+
```
217+
218+
- You may also have to remove old RSA/SHA1 GPG keys. List the keys:
219+
220+
```bash
221+
rpm -q gpg-pubkey --qf '%{NAME}-%{VERSION}-%{RELEASE}\t%{SUMMARY}\n'
222+
```
223+
224+
To remove them, use use the `rpm -e` command:
225+
226+
```bash
227+
sudo rpm -e [keyname]
228+
```
229+
230+
After these preparations are completed, you can upgrade your AlmaLinux 8 machine to AlmaLinux 9.
231+
146232
## Upgrading AlmaLinux 8 to AlmaLinux 9
147233

148234
- Install ELevate NG version repo config for AlmaLinux8:
@@ -151,6 +237,12 @@ Please follow the [ELevating CentOS 7 to AlmaLinux 10](/elevate/ELevating-CentOS
151237
sudo curl -o /etc/yum.repos.d/elevate-ng.repo https://repo.almalinux.org/elevate/testing/elevate-ng-el$(rpm -E %rhel).repo
152238
```
153239

240+
- Import ELevate GPG key:
241+
242+
```bash
243+
sudo rpm --import https://repo.almalinux.org/elevate/RPM-GPG-KEY-ELevate
244+
```
245+
154246
- Install leapp packages and upgrade data for AlmaLinux which is target OS:
155247

156248
```bash
@@ -218,6 +310,10 @@ Please follow the [ELevating CentOS 7 to AlmaLinux 10](/elevate/ELevating-CentOS
218310

219311
## Prepare the system for upgrade to AlmaLinux 10
220312

313+
:::warning
314+
Skip these steps if your system was NOT upgraded from EL 8.
315+
:::
316+
221317
When successfully upgraded to AlmaLinux 9 OS, consider performing these steps to prepare your system for upgrading to AlmaLinux 10:
222318

223319
- Navigate to the **/etc/** directory and use an editor of your choice to edit the **yum.conf** file. You need to remove everything from the **exclude** line especially that refers to elevate or leapp.
@@ -288,10 +384,6 @@ After these preparations are completed, you can upgrade your AlmaLinux 9 machine
288384

289385
## Upgrading AlmaLinux 9 to AlmaLinux 10
290386

291-
:::warning
292-
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.
293-
:::
294-
295387
:::tip
296388
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.
297389
:::

‎docs/elevate/ELevate-quickstart-guide.md‎

Lines changed: 6 additions & 5 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-06
5+
###### last updated: 2025-11-03
66

77
# ELevate Quickstart Guide
88

@@ -20,12 +20,13 @@ The ELevate project supports a number of 3rd party repositories:
2020

2121
- 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.
2222
- Docker CE - for all supported operating systems.
23-
- MariaDB - for supported operating systems excluding AlmaLinux 10, AlmaLinux Kitten 10, and CentOS Stream 10.
24-
- nginx - for supported operating systems excluding AlmaLinux 10, AlmaLinux Kitten 10, and CentOS Stream 10.
23+
- MariaDB - for supported operating systems.
24+
- nginx - for supported operating systems.
2525
- PostgreSQL - for all supported operating systems.
26-
- Imunify - for upgrades to EL 8.
27-
- KernelCare - for supported operating systems excluding AlmaLinux 10, AlmaLinux Kitten 10, and CentOS Stream 10.
26+
- Imunify - for upgrades to EL 8 and EL 10.
27+
- KernelCare - for supported operating systems.
2828
- TuxCare - for all supported operating systems.
29+
- ELevate - for all supported operating systems.
2930

3031
:::tip
3132
You can contribute to the project and add more 3rd party repositories support. See more on the [Contribute](/elevate/Contribution-guide) page.

‎docs/elevate/ELevate-testing-guide.md‎

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

5-
###### last updated: 2025-06-09
5+
###### last updated: 2025-11-03
66

77
# ELevate Testing Guide
88

@@ -21,12 +21,13 @@ The ELevate Project supports a number of 3rd party repositories:
2121

2222
- 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.
2323
- Docker CE - for all supported operating systems.
24-
- MariaDB - for supported operating systems excluding AlmaLinux 10, AlmaLinux Kitten 10, and CentOS Stream 10.
25-
- nginx - for supported operating systems excluding AlmaLinux 10, AlmaLinux Kitten 10, and CentOS Stream 10.
24+
- MariaDB - for supported operating systems.
25+
- nginx - for supported operating systems.
2626
- PostgreSQL - for all supported operating systems.
27-
- Imunify - for upgrades to EL 8.
28-
- KernelCare - for supported operating systems excluding AlmaLinux 10, AlmaLinux Kitten 10, and CentOS Stream 10.
27+
- Imunify - for upgrades to EL 8 and EL 10.
28+
- KernelCare - for supported operating systems.
2929
- TuxCare - for all supported operating systems.
30+
- ELevate - for all supported operating systems.
3031

3132
:::tip
3233
You can contribute to the project and add more 3rd party repositories support. See more on the [Contribute](/elevate/Contribution-guide) page.
@@ -116,6 +117,10 @@ ELevate currently does not support the [Raspberry Pi images](https://github.com/
116117

117118
## Prepare the system for upgrading to AlmaLinux 9
118119

120+
:::warning
121+
Skip these steps if your system was NOT upgraded from EL 7.
122+
:::
123+
119124
When successfully upgraded to AlmaLinux 8 OS, consider performing these steps to prepare your system for upgrading to AlmaLinux 9:
120125

121126
- Navigate to the **/etc/** directory and use an editor of your choice to edit the **yum.conf** file. You need to remove everything from the **exclude** line especially that refers to elevate or leapp.
@@ -203,6 +208,12 @@ When successfully upgraded to AlmaLinux 8 OS, consider performing these steps to
203208
sudo curl https://repo.almalinux.org/elevate/testing/elevate-testing.repo -o /etc/yum.repos.d/elevate-testing.repo
204209
```
205210

211+
- Import ELevate GPG key:
212+
213+
```bash
214+
sudo rpm --import https://repo.almalinux.org/elevate/RPM-GPG-KEY-ELevate
215+
```
216+
206217
- Install leapp packages and upgrade data for AlmaLinux:
207218

208219
```bash
@@ -268,6 +279,10 @@ When successfully upgraded to AlmaLinux 8 OS, consider performing these steps to
268279
269280
## Prepare the system for upgrade to AlmaLinux 10
270281
282+
:::warning
283+
Skip these steps if your system was NOT upgraded from EL 8.
284+
:::
285+
271286
When successfully upgraded to AlmaLinux 9 OS, consider performing these steps to prepare your system for upgrading to AlmaLinux 10:
272287
273288
- Navigate to the **/etc/** directory and use an editor of your choice to edit the **yum.conf** file. You need to remove everything from the `exclude=` line especially that refers to elevate or leapp.
@@ -356,6 +371,12 @@ The only difference is the `leapp-data` package.
356371
sudo curl https://repo.almalinux.org/elevate/testing/elevate-testing.repo -o /etc/yum.repos.d/elevate-testing.repo
357372
```
358373
374+
- Import ELevate GPG key:
375+
376+
```bash
377+
sudo rpm --import https://repo.almalinux.org/elevate/RPM-GPG-KEY-ELevate
378+
```
379+
359380
- Install leapp packages and upgrade data for AlmaLinux which is target OS:
360381
361382
```bash

‎docs/elevate/ELevating-CentOS7-to-AlmaLinux-10.md‎

Lines changed: 14 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: "ELevating CentOS 7 to AlmaLinux 10"
33
---
44

5-
###### last updated: 2025-06-09
5+
###### last updated: 2025-11-03
66

77
# ELevating CentOS 7 to AlmaLinux 10
88

@@ -17,12 +17,13 @@ The ELevate project supports a number of 3rd party repositories:
1717

1818
- 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.
1919
- Docker CE - for all supported operating systems.
20-
- MariaDB - for supported operating systems excluding AlmaLinux 10, AlmaLinux Kitten 10, and CentOS Stream 10.
21-
- nginx - for supported operating systems excluding AlmaLinux 10, AlmaLinux Kitten 10, and CentOS Stream 10.
20+
- MariaDB - for supported operating systems.
21+
- nginx - for supported operating systems.
2222
- PostgreSQL - for all supported operating systems.
23-
- Imunify - for upgrades to EL 8.
24-
- KernelCare - for supported operating systems excluding AlmaLinux 10, AlmaLinux Kitten 10, and CentOS Stream 10
23+
- Imunify - for upgrades to EL 8 and EL 10.
24+
- KernelCare - for supported operating systems.
2525
- TuxCare - for all supported operating systems.
26+
- ELevate - for all supported operating systems.
2627

2728
:::tip
2829
You can add more 3rd party repositories support. See more on the [Contribute](/elevate/Contribution-guide) page.
@@ -111,6 +112,10 @@ ELevate currently does not support the [Raspberry Pi images](https://github.com/
111112

112113
## Prepare the system for upgrade to AlmaLinux 9
113114

115+
:::warning
116+
Skip these steps if your system was NOT upgraded from EL 7.
117+
:::
118+
114119
When successfully upgraded to AlmaLinux 8 OS, consider performing these steps to prepare your system for upgrading to AlmaLinux 9:
115120

116121
- Navigate to the **/etc/** directory and use an editor of your choice to edit the **yum.conf** file. You need to remove everything from the `exclude=` line especially that refers to elevate or leapp.
@@ -266,6 +271,10 @@ When successfully upgraded to AlmaLinux 8 OS, consider performing these steps to
266271
267272
## Prepare the system for upgrade to AlmaLinux 10
268273
274+
:::warning
275+
Skip these steps if your system was NOT upgraded from EL 8.
276+
:::
277+
269278
When successfully upgraded to AlmaLinux 9 OS, consider performing these steps to prepare your system for upgrading to AlmaLinux 10:
270279
271280
- Navigate to the **/etc/** directory and use an editor of your choice to edit the **yum.conf** file. You need to remove everything from the `exclude=` line especially that refers to elevate or leapp.

‎docs/elevate/README.md‎

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: "About ELevate project"
33
---
44

5-
###### last updated: 2025-06-06
5+
###### last updated: 2025-11-03
66

77
# About the project
88

@@ -22,12 +22,13 @@ The ELevate project supports a number of 3rd party repositories:
2222

2323
- 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.
2424
- Docker CE - for all supported operating systems.
25-
- MariaDB - for supported operating systems excluding AlmaLinux 10, AlmaLinux Kitten 10, and CentOS Stream 10.
26-
- nginx - for supported operating systems excluding AlmaLinux 10, AlmaLinux Kitten 10, and CentOS Stream 10.
25+
- MariaDB - for supported operating systems.
26+
- nginx - for supported operating systems.
2727
- PostgreSQL - for all supported operating systems.
28-
- Imunify - for upgrades to EL 8.
29-
- KernelCare - for supported operating systems excluding AlmaLinux 10, AlmaLinux Kitten 10, and CentOS Stream 10.
28+
- Imunify - for upgrades to EL 8 and EL 10.
29+
- KernelCare - for supported operating systems.
3030
- TuxCare - for all supported operating systems.
31+
- ELevate - for all supported operating systems.
3132

3233
:::tip
3334
You can contribute to the project and add more 3rd party repositories support. See more on the [Contribute](/elevate/Contribution-guide) page.

0 commit comments

Comments
 (0)