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-rhel-8dotx-to-9dotx-saphana-sapapps.md
+54-43Lines changed: 54 additions & 43 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,8 +1,10 @@
1
1
---
2
2
title: Leapp upgrade from RHEL 8.x to RHEL 9.x on SAP-HANA and SAP-APPS pay-as-you-go VMs
3
-
description: Provides steps to help you upgrade SAP-HANA and SAP-APPS pay-as-you-go virtual machines from RHEL 8.x to RHEL 9.x by using the Leapp tool.
3
+
description: Provides steps to help you upgrade SAP-HANA and SAP-APPS pay-as-you-go virtual machines from RHEL 8.x to RHEL 9.x by using the Leapp utility.
4
+
author: msaenzbosupport
5
+
ms.author: msaenzbo
4
6
ms.reviewer: divargas, msaenzbo, v-weizhu
5
-
ms.date: 12/24/2024
7
+
ms.date: 06/03/2025
6
8
ms.service: azure-virtual-machines
7
9
ms.topic: how-to
8
10
ms.custom: sap:VM Admin - Linux (Guest OS), linux-related-content
@@ -35,24 +37,27 @@ You can perform an in-place upgrade from RHEL 8 to the following RHEL 9 minor ve
35
37
36
38
|System configuration | Source OS version| Target version |
|SAP NetWeaver and other SAP Applications | RHEL 8.8| RHEL 9.2|
41
-
|SAP NetWeaver and other SAP Applications | RHEL 8.10 | RHEL 9.4|
40
+
|SAP HANA | RHEL 8.10| RHEL 9.4|
41
+
|SAP HANA | RHEL 8.10 | RHEL 9.6|
42
+
|SAP NetWeaver and other SAP Applications | RHEL 8.10| RHEL 9.4|
43
+
|SAP NetWeaver and other SAP Applications | RHEL 8.10 | RHEL 9.6|
42
44
43
45
44
-
According to the [Upgrading SAP environments from RHEL 8 to RHEL 9 - Supported upgrade paths](https://docs.redhat.com/en/documentation/red_hat_enterprise_linux_for_sap_solutions/9/html/upgrading_sap_environments_from_rhel_8_to_rhel_9/asmb_supported-upgrade-paths_how-to-in-place-upgrade-sap-environments-from-rhel8-to-rhel9#asmb_supported-upgrade-paths_how-to-in-place-upgrade-sap-environments-from-rhel8-to-rhel9) documentation, SAP validates SAP HANA for the RHEL minor versions that receive package updates for more than six months. Currently, the supported in-place upgrade paths for an SAP HANA system are from RHEL 8.8 to RHEL 9.2 and from RHEL 8.10 to RHEL 9.4. This documentation also describes restrictions and detailed steps for upgrading an SAP HANA system.
46
+
According to the [Upgrading SAP environments from RHEL 8 to RHEL 9 - Supported upgrade paths](https://docs.redhat.com/en/documentation/red_hat_enterprise_linux_for_sap_solutions/9/html/upgrading_sap_environments_from_rhel_8_to_rhel_9/asmb_supported-upgrade-paths_how-to-in-place-upgrade-sap-environments-from-rhel8-to-rhel9#asmb_supported-upgrade-paths_how-to-in-place-upgrade-sap-environments-from-rhel8-to-rhel9) documentation, SAP validates SAP HANA for the RHEL minor versions that receive package updates for more than six months. Currently, the supported in-place upgrade paths for an SAP HANA system are from RHEL 8.10 to RHEL 9.4 and from RHEL 8.10 to RHEL 9.6. This documentation also describes restrictions and detailed steps for upgrading an SAP HANA system.
45
47
46
-
SAP validates SAP NetWeaver for each major RHEL version. The supported in-place upgrade paths for an SAP NetWeaver system are the two latest Extended Update Support (EUS)/Update Services for SAP Solutions (E4S) releases that the Leapp tool supports for non-HANA systems. For more information, see [Upgrading from RHEL 8 to RHEL 9 - Supported upgrade paths](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/upgrading_from_rhel_8_to_rhel_9). Certain deviations from the default upgrade procedure are described in [Upgrading an SAP NetWeaver system](https://docs.redhat.com/en/documentation/red_hat_enterprise_linux_for_sap_solutions/9/html/upgrading_sap_environments_from_rhel_8_to_rhel_9/asmb_upgrading_netweaver_asmb_upgrading-hana-system). For systems where both SAP HANA and SAP NetWeaver are installed, the SAP HANA restrictions apply.
48
+
SAP validates SAP NetWeaver for each major RHEL version. The supported in-place upgrade paths for an SAP NetWeaver system are the two latest Extended Update Support (EUS)/Update Services for SAP Solutions (E4S) releases that the Leapp utility supports for non-HANA systems. For more information, see [Upgrading from RHEL 8 to RHEL 9 - Supported upgrade paths](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/upgrading_from_rhel_8_to_rhel_9). Certain deviations from the default upgrade procedure are described in [Upgrading an SAP NetWeaver system](https://docs.redhat.com/en/documentation/red_hat_enterprise_linux_for_sap_solutions/9/html/upgrading_sap_environments_from_rhel_8_to_rhel_9/asmb_upgrading_netweaver_asmb_upgrading-hana-system). For systems where both SAP HANA and SAP NetWeaver are installed, the SAP HANA restrictions apply.
47
49
48
-
### [RHEL 8.8 to RHEL 9.2 - SAP-HANA PAYG VMs](#tab/rhel92saphana)
50
+
### [RHEL 8.10 to RHEL 9.4 - SAP-HANA PAYG VMs](#tab/rhel94saphana)
49
51
50
-
This section outlines the necessary steps before performing an in-place upgrade from RHEL 8.8 to RHEL 9.2 using the Leapp utility on SAP-HANA PAYG VMs.
52
+
This section outlines the necessary steps before you perform an in-place upgrade from RHEL 8.10 to RHEL 9.4 by using the Leapp utility on SAP-HANA PAYG VMs.
51
53
52
54
> [!NOTE]
53
55
> If your VM is part of a Hight Availability cluster, the upgrade is possible if the cluster nodes do *not* use any packages that are part of [Resilient Storage](https://access.redhat.com/articles/3130101). For more information, see [Procedure to upgrade a RHEL 8 High Availability cluster to RHEL 9](https://access.redhat.com/articles/7012677).
54
56
55
-
1. Make sure your current Red Hat release is 8.8:
57
+
> [!NOTE]
58
+
> To update an SAP-HANA system from RHEL 8.10 to RHEL 9.4, you must first upgrade the system to RHEL 8.10 if it isn't already upgaded. For more information, see [How to upgrade RHEL-SAP-HANA and RHEL-SAP-APPS pay-as-you-go virtual machines from 8.x to 8.10](upgrade-rhel-8-dot-x-to-8-dot-10-on-sap-hana-apps.md).
59
+
60
+
1. Make sure that your current Red Hat release is 8.10:
56
61
57
62
```bash
58
63
sudo cat /etc/redhat-release
@@ -62,7 +67,7 @@ This section outlines the necessary steps before performing an in-place upgrade
62
67
sudo cat /etc/yum/vars/releasever
63
68
```
64
69
65
-
2. To ensure your system is ready for upgrade, install required RHUI packages:
70
+
2. To make sure your system is ready for upgrade, install required RHUI packages:
66
71
67
72
```bash
68
73
sudo dnf install leapp-rhui-azure-sap
@@ -86,7 +91,7 @@ This section outlines the necessary steps before performing an in-place upgrade
86
91
All other settings configured in the files */etc/sysctl.conf* and */etc/sysctl.d/sap_hana.conf* are the same for both RHEL 8 and RHEL 9 and should remain unchanged. For more information, see the [SAP Notes 2382421](https://launchpad.support.sap.com/#/notes/2382421).
87
92
88
93
89
-
5. To make sure your RHEL 8.8 system is up-to-date, update all packages:
94
+
5. To make sure that your RHEL 8.10 system is up to date, update all packages:
90
95
91
96
```bash
92
97
sudo dnf update
@@ -102,21 +107,24 @@ This section outlines the necessary steps before performing an in-place upgrade
102
107
103
108
7. Temporarily disable antivirus software to prevent the upgrade from failing.
104
109
105
-
8. 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).
110
+
8. Before you run 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).
106
111
107
112
9. Install the Leapp utility:
108
113
109
114
```bash
110
115
sudo dnf install leapp-upgrade
111
116
```
112
117
113
-
### [RHEL 8.10 to RHEL 9.4 - SAP-HANA PAYG VMs](#tab/rhel94saphana)
118
+
### [RHEL 8.10 to RHEL 9.6 - SAP-HANA PAYG VMs](#tab/rhel96saphana)
114
119
115
-
This section outlines the necessary steps before performing an in-place upgrade from RHEL 8.10 to RHEL 9.4 using the Leapp utility on SAP-HANA PAYG VMs.
120
+
This section outlines the necessary steps before performing an in-place upgrade from RHEL 8.10 to RHEL 9.6 using the Leapp utility on SAP-HANA PAYG VMs.
116
121
117
122
> [!NOTE]
118
123
> If your VM is part of a Hight Availability cluster, the upgrade is possible if the cluster nodes do*not* use any packages that are part of [Resilient Storage](https://access.redhat.com/articles/3130101). For more information, see [Procedure to upgrade a RHEL 8 High Availability cluster to RHEL 9](https://access.redhat.com/articles/7012677).
119
124
125
+
> [!NOTE]
126
+
> To update an SAP-HANA system from RHEL 8.10 to RHEL 9.6, you must first upgrade the system to RHEL 8.10 if it isn't. For more information, see [How to upgrade RHEL-SAP-HANA and RHEL-SAP-APPS pay-as-you-go virtual machines from 8.x to 8.10](upgrade-rhel-8-dot-x-to-8-dot-10-on-sap-hana-apps.md).
127
+
120
128
1. Make sure your current Red Hat release is 8.10:
121
129
122
130
```bash
@@ -146,7 +154,7 @@ This section outlines the necessary steps before performing an in-place upgrade
146
154
147
155
All other settings forSAP HANA, configuredin the files */etc/sysctl.conf* and */etc/sysctl.d/sap_hana.conf*, are the same for both RHEL 8 and RHEL 9 and should remain unchanged. For more information, see the [SAP Notes 2382421](https://launchpad.support.sap.com/#/notes/2382421).
148
156
149
-
5. To make sure your RHEL 8.10 system is up-to-date, update all packages:
157
+
5. To make sure that your RHEL 8.10 system is up to date, update all packages:
150
158
151
159
```bash
152
160
sudo dnf update
@@ -170,11 +178,14 @@ This section outlines the necessary steps before performing an in-place upgrade
170
178
sudo dnf install leapp-upgrade
171
179
```
172
180
173
-
### [RHEL 8.8 to RHEL 9.2 - SAP-APPS PAYG VMs](#tab/rhel92sapapps)
181
+
### [RHEL 8.10 to RHEL 9.4 - SAP-APPS PAYG VMs](#tab/rhel94sapapps)
174
182
175
-
This section outlines the necessary steps before performing an in-place upgrade from RHEL 8.8 to RHEL 9.2 using the Leapp utility on SAP-APPS PAYG VMs.
183
+
This section outlines the necessary steps before performing an in-place upgrade from RHEL 8.10 to RHEL 9.4 using the Leapp utility on SAP-APPS PAYG VMs.
176
184
177
-
1. Make sure your current Red Hat release is 8.8:
185
+
> [!NOTE]
186
+
> To update an SAP-APPS system from RHEL 8.10 to RHEL 9.4, you must first upgrade the system to RHEL 8.10 if it isn't. For more information, see [How to upgrade RHEL-SAP-HANA and RHEL-SAP-APPS pay-as-you-go virtual machines from 8.x to 8.10](upgrade-rhel-8-dot-x-to-8-dot-10-on-sap-hana-apps.md).
187
+
188
+
1. Make sure your current Red Hat release is 8.10:
178
189
179
190
```bash
180
191
sudo cat /etc/redhat-release
@@ -208,7 +219,7 @@ This section outlines the necessary steps before performing an in-place upgrade
208
219
All other settings forSAP, configuredin the file */etc/sysctl.conf*, are the same for both RHEL 8 and RHEL 9 and should remain unchanged. For more information, see the [SAP Notes 2382421](https://launchpad.support.sap.com/#/notes/2382421).
209
220
210
221
211
-
5. To make sure your RHEL 8.10 system is up-to-date, update all packages:
222
+
5. To make sure that your RHEL 8.10 system is up to date, update all packages:
212
223
213
224
```bash
214
225
sudo dnf update
@@ -232,12 +243,12 @@ This section outlines the necessary steps before performing an in-place upgrade
232
243
sudo dnf install leapp-upgrade
233
244
```
234
245
235
-
### [RHEL 8.10 to RHEL 9.4 - SAP-APPS PAYG VMs](#tab/rhel94sapapps)
246
+
### [RHEL 8.10 to RHEL 9.6 - SAP-APPS PAYG VMs](#tab/rhel96sapapps)
236
247
237
-
This section outlines the necessary steps before performing an in-place upgrade from RHEL 8.10 to RHEL 9.4 using the Leapp utility on SAP-APPS PAYG VMs.
248
+
This section outlines the necessary steps before performing an in-place upgrade from RHEL 8.10 to RHEL 9.6 using the Leapp utility on SAP-APPS PAYG VMs.
238
249
239
250
> [!NOTE]
240
-
> To update an SAP-APPS system from RHEL 8.10 to RHEL 9.4, you must first upgrade the system to RHEL 8.10 if it isn't. For more information, see [How to upgrade RHEL-SAP-HANA and RHEL-SAP-APPS pay-as-you-go virtual machines from 8.x to 8.10](upgrade-rhel-8-dot-x-to-8-dot-10-on-sap-hana-apps.md).
251
+
> To update an SAP-APPS system from RHEL 8.10 to RHEL 9.6, you must first upgrade the system to RHEL 8.10 if it isn't. For more information, see [How to upgrade RHEL-SAP-HANA and RHEL-SAP-APPS pay-as-you-go virtual machines from 8.x to 8.10](upgrade-rhel-8-dot-x-to-8-dot-10-on-sap-hana-apps.md).
241
252
242
253
1. Make sure your current Red Hat release is 8.10:
243
254
@@ -269,7 +280,7 @@ This section outlines the necessary steps before performing an in-place upgrade
269
280
All other settings forSAP, configuredin the file */etc/sysctl.conf*, are the same for both RHEL 8 and RHEL 9 and should remain unchanged. For more information, see [SAP Notes 2382421](https://launchpad.support.sap.com/#/notes/2382421).
270
281
271
282
272
-
4. To make sure your RHEL 8.10 system is up-to-date, update all packages:
283
+
4. To make sure that your RHEL 8.10 system is up to date, update all packages:
273
284
274
285
```bash
275
286
sudo dnf update
@@ -299,47 +310,47 @@ This section outlines the necessary steps before performing an in-place upgrade
299
310
300
311
The Leapp pre-upgrade report highlights possible issues, provides recommended solutions, and helps determine whether it's feasible or advisable to proceed with the upgrade.
301
312
302
-
### [RHEL 8.8 to RHEL 9.2 - SAP-HANA PAYG VMs](#tab/rhel92saphana)
313
+
### [RHEL 8.10 to RHEL 9.4 - SAP-HANA PAYG VMs](#tab/rhel94saphana)
303
314
304
315
Run the `leapp preupgrade` command with the `e4s` channel:
Replace `<target_os_version>` with the target OS version, for example, `9.4`.
332
+
Replace `<target_os_version>` with the target OS version, for example, `9.6`.
322
333
323
334
324
-
### [RHEL 8.8 to RHEL 9.2 - SAP-APPS PAYG VMs](#tab/rhel92sapapps)
335
+
### [RHEL 8.10 to RHEL 9.4 - SAP-APPS PAYG VMs](#tab/rhel94sapapps)
325
336
326
337
Run the `leapp preupgrade` command with the `eus` channel:
327
338
328
339
```bash
329
340
sudo leapp preupgrade --target <target_os_version> --channel eus --no-rhsm
330
341
```
331
342
332
-
Replace `<target_os_version>` with the target OS version, for example, `9.2`.
343
+
Replace `<target_os_version>` with the target OS version, for example, `9.4`.
333
344
334
-
### [RHEL 8.10 to RHEL 9.4 - SAP-APPS PAYG VMs](#tab/rhel94sapapps)
345
+
### [RHEL 8.10 to RHEL 9.6 - SAP-APPS PAYG VMs](#tab/rhel96sapapps)
335
346
336
347
Run the `leapp preupgrade` command with the `eus` channel:
337
348
338
349
```bash
339
350
sudo leapp preupgrade --target <target_os_version> --channel eus --no-rhsm
340
351
```
341
352
342
-
Replace `<target_os_version>` with the target OS version, for example, `9.4`.
353
+
Replace `<target_os_version>` with the target OS version, for example, `9.6`.
343
354
344
355
---
345
356
@@ -353,15 +364,15 @@ Continue the Leapp upgrade process after the Leapp pre-upgrade report shows no e
353
364
> - Make sure to run the `leapp upgrade`command through the Serial Console to avoid any network interruptions that could affect your secure shell (SSH) terminal and disrupt the upgrade process.
354
365
> - If you want to perform an automatic reboot, which is needed during the upgrade process, add the `--reboot` option to the `leapp upgrade` command.
355
366
356
-
### [RHEL 8.8 to RHEL 9.2 - SAP-HANA PAYG VMs](#tab/rhel92saphana)
367
+
### [RHEL 8.10 to RHEL 9.4 - SAP-HANA PAYG VMs](#tab/rhel94saphana)
357
368
358
369
1. Run the `leapp upgrade`command with the `e4s` channel:
Replace `<target_os_version>` with the target OS version, for example, `9.2`.
375
+
Replace `<target_os_version>` with the target OS version, for example, `9.4`.
365
376
366
377
2. If the `--reboot` option wasn't included in the previous command, monitor the Serial Console. Once the upgrade process confirms that a reboot is required to continue the process, as shown in the following output, manually reboot the VM:
367
378
@@ -377,15 +388,15 @@ Continue the Leapp upgrade process after the Leapp pre-upgrade report shows no e
377
388
sudo reboot
378
389
```
379
390
380
-
### [RHEL 8.10 to RHEL 9.4 - SAP-HANA PAYG VMs](#tab/rhel94saphana)
391
+
### [RHEL 8.10 to RHEL 9.6 - SAP-HANA PAYG VMs](#tab/rhel96saphana)
381
392
382
393
1. Run the `leapp upgrade` command with the `e4s` channel.
Replace `<target_os_version>` with the target OS version, for example, `9.4`.
399
+
Replace `<target_os_version>` with the target OS version, for example, `9.6`.
389
400
390
401
2. If the `--reboot` option wasn't included in the previous command, monitor the Serial Console. Once the upgrade process confirms that a reboot is required to continue the process, as shown in the following output, manually reboot the VM:
391
402
@@ -401,15 +412,15 @@ Continue the Leapp upgrade process after the Leapp pre-upgrade report shows no e
401
412
sudo reboot
402
413
```
403
414
404
-
### [RHEL 8.8 to RHEL 9.2 - SAP-APPS PAYG VMs](#tab/rhel92sapapps)
415
+
### [RHEL 8.10 to RHEL 9.4 - SAP-APPS PAYG VMs](#tab/rhel94sapapps)
405
416
406
417
1. Run the `leapp upgrade`command with the `eus` channel.
407
418
408
419
```bash
409
420
sudo leapp upgrade --target <target_os_version> --channel eus --no-rhsm
410
421
```
411
422
412
-
Replace `<target_os_version>` with the target OS version, for example, `9.2`.
423
+
Replace `<target_os_version>` with the target OS version, for example, `9.4`.
413
424
414
425
2. If the `--reboot` option wasn't included in the previous command, monitor the Serial Console. Once the upgrade process confirms that a reboot is required to continue the process, as shown in the following output, manually reboot the VM:
415
426
@@ -426,15 +437,15 @@ Continue the Leapp upgrade process after the Leapp pre-upgrade report shows no e
426
437
```
427
438
428
439
429
-
### [RHEL 8.10 to RHEL 9.4 - SAP-APPS PAYG VMs](#tab/rhel94sapapps)
440
+
### [RHEL 8.10 to RHEL 9.6 - SAP-APPS PAYG VMs](#tab/rhel96sapapps)
430
441
431
442
1. Run the `leapp upgrade` command with the `eus` channel.
432
443
433
444
```bash
434
445
sudo leapp upgrade --target <target_os_version> --channel eus --no-rhsm
435
446
```
436
447
437
-
Replace `<target_os_version>` with the target OS version, for example, `9.4`.
448
+
Replace `<target_os_version>` with the target OS version, for example, `9.6`.
438
449
439
450
2. If the `--reboot` option wasn't included in the previous command, monitor the Serial Console. Once the upgrade process confirms that a reboot is required to continue the process, as shown in the following output, manually reboot the VM:
440
451
@@ -458,7 +469,7 @@ Once the upgrade is finished, check if the system is in the desired state.
458
469
459
470
This section outlines the recommended verification steps after completing an in-place upgrade.
460
471
461
-
### [RHEL 9.2 or RHEL 9.4 - SAP-HANA PAYG VMs](#tab/rhel9294saphana)
472
+
### [RHEL 9.4 or RHEL 9.6 - SAP-HANA PAYG VMs](#tab/rhel9496saphana)
462
473
463
474
1. Verify that the current OS version belongs to RHEL 9:
464
475
@@ -494,7 +505,7 @@ This section outlines the recommended verification steps after completing an in-
494
505
rhel-9-for-x86_64-sap-solutions-e4s-rhui-rpms Red Hat Enterprise Linux 9 for x86_64 - SAP Solutions - Update Services for SAP Solutions from RHUI (RPMs)
495
506
```
496
507
497
-
### [RHEL 9.2 or RHEL 9.4 - SAP-APPS PAYG VMs](#tab/rhel9294sapapps)
508
+
### [RHEL 9.4 or RHEL 9.6 - SAP-APPS PAYG VMs](#tab/rhel9496sapapps)
498
509
499
510
500
511
1. Verify that the current OS version belongs to RHEL 9:
0 commit comments