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
Copy file name to clipboardExpand all lines: support/azure/virtual-machines/linux/leapp-upgrade-process-rhel-7-and-8.md
+157-3Lines changed: 157 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,9 +21,11 @@ Upgrading your Red Hat Enterprise Linux (RHEL) system is a crucial task to ensur
21
21
22
22
For more information about performing a Leapp upgrade on custom, golden, or PAYG images provided by Red Hat, see the following articles:
23
23
24
-
-[Upgrading from RHEL 7 to RHEL 8](https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/8/html-single/upgrading_from_rhel_7_to_rhel_8/index)
24
+
-[Upgrading from RHEL 7 to RHEL 8](https://docs.redhat.com/documentation/red_hat_enterprise_linux/8/html-single/upgrading_from_rhel_7_to_rhel_8/index)
25
25
26
-
-[Upgrading from RHEL 8 to RHEL 9](https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/9/html/upgrading_from_rhel_8_to_rhel_9/index)
26
+
-[Upgrading from RHEL 8 to RHEL 9](https://docs.redhat.com/documentation/red_hat_enterprise_linux/9/html/upgrading_from_rhel_8_to_rhel_9/index)
27
+
28
+
-[Upgrading from RHEL 9 to RHEL 10](https://docs.redhat.com/documentation/red_hat_enterprise_linux/10/html/upgrading_from_rhel_9_to_rhel_10/index)
27
29
28
30
## Prerequisites
29
31
@@ -141,6 +143,56 @@ You can perform an in-place upgrade from RHEL 8 to the following RHEL 9 minor ve
141
143
142
144
8. RHEL 9 no longer supports the legacy network-scripts package, which was deprecated in RHEL 8. Before upgrading, migrate your custom network scripts and create a NetworkManager dispatcher script to run your existing custom scripts. For more information, see [Migrating custom network scripts to NetworkManager dispatcher scripts](https://access.redhat.com/solutions/6900331).
143
145
146
+
### [RHEL 9.7 to RHEL 10.1](#tab/rhel9-rhel10)
147
+
148
+
You can perform an in-place upgrade from RHEL 9 to the following RHEL 10 minor versions.
149
+
150
+
| Source OS version| Target version |
151
+
|------------------|--------------------|
152
+
| RHEL 9.7 | RHEL 10.1 |
153
+
154
+
> [!NOTE]
155
+
> For more information, see [Supported in-place upgrade paths for Red Hat Enterprise Linux](https://access.redhat.com/articles/4263361).
156
+
157
+
158
+
> [!NOTE]
159
+
> If you locked the VM to a minor release, remove the version lock. For more information, see [Switch a RHEL 9.x VM back to non-EUS](/azure/virtual-machines/workloads/redhat/redhat-rhui#switch-a-rhel-server-to-non-eus-repositories).
160
+
161
+
162
+
163
+
1. If you restricted packages to a specific version using the `dnf-command(versionlock)` command, remove the restriction:
164
+
165
+
```bash
166
+
sudo dnf versionlock clear
167
+
```
168
+
169
+
2. To ensure your system is ready for the upgrade, enable required RHUI repositories and install required RHUI packages:
4. Update all packages to the latest RHEL 8 version:
181
+
182
+
```bash
183
+
sudo dnf update
184
+
```
185
+
5. Reboot the VM:
186
+
187
+
```bash
188
+
sudo reboot
189
+
```
190
+
6. To prevent upgrade failures, temporarily disable your antivirus software.
191
+
192
+
7. Before running the `leapp preupgrade` command, disable any configuration management systems with a client-server architecture (such as Puppet, Salt, or Chef) or an agentless architecture (such as Ansible).
193
+
194
+
8. If the system has been previously upgraded from RHEL 8 to RHEL 9, ensure that all required post-upgrade steps have been completed. For more information, see Performing post-upgrade tasks in the Upgrading from RHEL 8 to RHEL 9 guide[Performing post-upgrade](https://docs.redhat.com/documentation/red_hat_enterprise_linux/9/html-single/upgrading_from_rhel_8_to_rhel_9/index#performing-post-upgrade-tasks-on-the-rhel-9-system_upgrading-from-rhel-8-to-rhel-9)
195
+
144
196
---
145
197
146
198
## Leapp pre-upgrade process
@@ -166,7 +218,21 @@ Run the following `leapp preupgrade` command:
> - Replace `<target_os_version>` with the target OS version, for example, `10.1`.
309
+
> - If you want to perform an automatic reboot, which is needed during the upgrade process, add the `--reboot` option to the `leapp upgrade` command.
310
+
311
+
2. If the `--reboot` option wasn't included in the previous command, monitor the Serial Console. Once the upgrade process shows that a reboot is required to continue the process as follows, manually reboot the VM:
312
+
313
+
314
+
```output
315
+
====> * add_upgrade_boot_entry
316
+
Add new boot entry for Leapp provided initramfs.
317
+
A reboot is required to continue. Please reboot your system.
318
+
```
319
+
320
+
```bash
321
+
sudo reboot
322
+
```
323
+
324
+
232
325
---
233
326
234
327
Once the upgrade is finished, check if the system is in the desired state.
@@ -277,6 +370,26 @@ This section outlines the recommended verification steps after completing an in-
277
370
sudo dnf repolist
278
371
```
279
372
373
+
### [RHEL 9.7 to RHEL 10.1](#tab/rhel9-rhel10)
374
+
375
+
1. Verify that the current OS version belongs to RHEL 9:
376
+
377
+
```bash
378
+
sudo cat /etc/redhat-release
379
+
```
380
+
381
+
2. Check the kernel version:
382
+
383
+
```bash
384
+
uname -r
385
+
```
386
+
387
+
3. Verify the new repositories:
388
+
389
+
```bash
390
+
sudo dnf repolist
391
+
```
392
+
280
393
---
281
394
282
395
## Post-upgrade tasks
@@ -401,8 +514,49 @@ Once the VM is successfully upgraded, perform the following tasks:
401
514
> [!IMPORTANT]
402
515
> Removing this data might limit Microsoft and Red Hat Support's ability to investigate and troubleshoot post-upgrade problems.
403
516
517
+
518
+
### [RHEL 9.7 to RHEL 10.1](#tab/rhel9-rhel10)
519
+
520
+
521
+
1. Delete all remaining Leapp packages, including the *`snactor`* package, from the exclude list in the */etc/dnf/dnf.conf* configuration file. These Leapp packages are installed during the in-place upgrade.
0 commit comments