Skip to content

Commit 2fdd0c9

Browse files
authored
Merge pull request #9040 from MicrosoftDocs/main
Update leapp-upgrade-rhel-8dotx-to-9dotx-saphana-sapapps.md (#9039)
2 parents 320cb9b + 1577572 commit 2fdd0c9

File tree

1 file changed

+54
-43
lines changed

1 file changed

+54
-43
lines changed

support/azure/virtual-machines/linux/leapp-upgrade-rhel-8dotx-to-9dotx-saphana-sapapps.md

Lines changed: 54 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,10 @@
11
---
22
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
46
ms.reviewer: divargas, msaenzbo, v-weizhu
5-
ms.date: 12/24/2024
7+
ms.date: 06/03/2025
68
ms.service: azure-virtual-machines
79
ms.topic: how-to
810
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
3537

3638
|System configuration | Source OS version| Target version |
3739
|----------------------|------------------|-------------------|
38-
|SAP High-performance ANalytic Appliance (HANA) | RHEL 8.8 | RHEL 9.2 |
39-
|SAP HANA | RHEL 8.10 | RHEL 9.4 |
40-
|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 |
4244

4345

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.
4547

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.
4749

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)
4951

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.
5153

5254
> [!NOTE]
5355
> 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).
5456
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:
5661

5762
```bash
5863
sudo cat /etc/redhat-release
@@ -62,7 +67,7 @@ This section outlines the necessary steps before performing an in-place upgrade
6267
sudo cat /etc/yum/vars/releasever
6368
```
6469

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:
6671

6772
```bash
6873
sudo dnf install leapp-rhui-azure-sap
@@ -86,7 +91,7 @@ This section outlines the necessary steps before performing an in-place upgrade
8691
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).
8792

8893

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:
9095

9196
```bash
9297
sudo dnf update
@@ -102,21 +107,24 @@ This section outlines the necessary steps before performing an in-place upgrade
102107

103108
7. Temporarily disable antivirus software to prevent the upgrade from failing.
104109

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).
106111

107112
9. Install the Leapp utility:
108113

109114
```bash
110115
sudo dnf install leapp-upgrade
111116
```
112117

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)
114119

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.
116121

117122
> [!NOTE]
118123
> 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).
119124

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+
120128
1. Make sure your current Red Hat release is 8.10:
121129
122130
```bash
@@ -146,7 +154,7 @@ This section outlines the necessary steps before performing an in-place upgrade
146154

147155
All other settings for SAP HANA, 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).
148156

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:
150158

151159
```bash
152160
sudo dnf update
@@ -170,11 +178,14 @@ This section outlines the necessary steps before performing an in-place upgrade
170178
sudo dnf install leapp-upgrade
171179
```
172180

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)
174182

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.
176184

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:
178189
179190
```bash
180191
sudo cat /etc/redhat-release
@@ -208,7 +219,7 @@ This section outlines the necessary steps before performing an in-place upgrade
208219
All other settings for SAP, configured in 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).
209220

210221

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:
212223

213224
```bash
214225
sudo dnf update
@@ -232,12 +243,12 @@ This section outlines the necessary steps before performing an in-place upgrade
232243
sudo dnf install leapp-upgrade
233244
```
234245

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)
236247

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.
238249

239250
> [!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).
241252
242253
1. Make sure your current Red Hat release is 8.10:
243254
@@ -269,7 +280,7 @@ This section outlines the necessary steps before performing an in-place upgrade
269280
All other settings for SAP, configured in 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).
270281

271282

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:
273284

274285
```bash
275286
sudo dnf update
@@ -299,47 +310,47 @@ This section outlines the necessary steps before performing an in-place upgrade
299310

300311
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.
301312
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)
303314
304315
Run the `leapp preupgrade` command with the `e4s` channel:
305316
306317
```bash
307318
sudo leapp preupgrade --target <target_os_version> --channel e4s --no-rhsm
308319
```
309320
310-
Replace `<target_os_version>` with the target OS version, for example, `9.2`.
321+
Replace `<target_os_version>` with the target OS version, for example, `9.4`.
311322
312323
313-
### [RHEL 8.10 to RHEL 9.4 - SAP-HANA PAYG VMs](#tab/rhel94saphana)
324+
### [RHEL 8.10 to RHEL 9.6 - SAP-HANA PAYG VMs](#tab/rhel96saphana)
314325
315326
Run the `leapp preupgrade` command with the `e4s` channel:
316327
317328
```bash
318329
sudo leapp preupgrade --target <target_os_version> --channel e4s --no-rhsm
319330
```
320331
321-
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`.
322333
323334
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)
325336
326337
Run the `leapp preupgrade` command with the `eus` channel:
327338
328339
```bash
329340
sudo leapp preupgrade --target <target_os_version> --channel eus --no-rhsm
330341
```
331342
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`.
333344
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)
335346
336347
Run the `leapp preupgrade` command with the `eus` channel:
337348
338349
```bash
339350
sudo leapp preupgrade --target <target_os_version> --channel eus --no-rhsm
340351
```
341352
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`.
343354
344355
---
345356
@@ -353,15 +364,15 @@ Continue the Leapp upgrade process after the Leapp pre-upgrade report shows no e
353364
> - 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.
354365
> - If you want to perform an automatic reboot, which is needed during the upgrade process, add the `--reboot` option to the `leapp upgrade` command.
355366

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)
357368

358369
1. Run the `leapp upgrade` command with the `e4s` channel:
359370

360371
```bash
361372
sudo leapp upgrade --target <target_os_version> --channel e4s --no-rhsm
362373
```
363374

364-
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`.
365376

366377
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:
367378
@@ -377,15 +388,15 @@ Continue the Leapp upgrade process after the Leapp pre-upgrade report shows no e
377388
sudo reboot
378389
```
379390
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)
381392
382393
1. Run the `leapp upgrade` command with the `e4s` channel.
383394
384395
```bash
385396
sudo leapp upgrade --target <target_os_version> --channel e4s --no-rhsm
386397
```
387398
388-
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`.
389400
390401
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:
391402

@@ -401,15 +412,15 @@ Continue the Leapp upgrade process after the Leapp pre-upgrade report shows no e
401412
sudo reboot
402413
```
403414

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)
405416

406417
1. Run the `leapp upgrade` command with the `eus` channel.
407418

408419
```bash
409420
sudo leapp upgrade --target <target_os_version> --channel eus --no-rhsm
410421
```
411422

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`.
413424

414425
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:
415426
@@ -426,15 +437,15 @@ Continue the Leapp upgrade process after the Leapp pre-upgrade report shows no e
426437
```
427438
428439
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)
430441
431442
1. Run the `leapp upgrade` command with the `eus` channel.
432443
433444
```bash
434445
sudo leapp upgrade --target <target_os_version> --channel eus --no-rhsm
435446
```
436447
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`.
438449
439450
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:
440451

@@ -458,7 +469,7 @@ Once the upgrade is finished, check if the system is in the desired state.
458469

459470
This section outlines the recommended verification steps after completing an in-place upgrade.
460471

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)
462473

463474
1. Verify that the current OS version belongs to RHEL 9:
464475

@@ -494,7 +505,7 @@ This section outlines the recommended verification steps after completing an in-
494505
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)
495506
```
496507
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)
498509
499510
500511
1. Verify that the current OS version belongs to RHEL 9:

0 commit comments

Comments
 (0)