Skip to content

Commit 2505ee5

Browse files
authored
Update os-upgrade-hana-large-instance.md
1 parent 6e3ccf5 commit 2505ee5

File tree

1 file changed

+29
-32
lines changed

1 file changed

+29
-32
lines changed

articles/virtual-machines/workloads/sap/os-upgrade-hana-large-instance.md

Lines changed: 29 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -47,85 +47,82 @@ The following are the few common known issues during the upgrade:
4747
- On SKU Type II class SKU, the software foundation software (SFS) is removed after the OS upgrade. You need to reinstall the compatible SFS after the OS upgrade.
4848
- Ethernet card drivers (ENIC and FNIC) rolled back to older version. You need to reinstall the compatible version of the drivers after the upgrade.
4949

50-
# SAP HANA Large Instance (Type I) Recommended SLES Configuration
50+
## SAP HANA Large Instance (Type I) Recommended SLES Configuration
5151

5252
Operating system configuration can drift from the recommended settings over time due to patching, system upgrades, and changes made by customers. Additionally, Microsoft identifies updates needed for existing systems to ensure they are optimally configured for the best performance and resiliency. Following instructions outline recommendations that address network performance, system stability, and optimal HANA performance.
5353

54-
## Compatible eNIC/fNIC driver versions
54+
### Compatible eNIC/fNIC driver versions
5555
In order to have proper network performance and system stability, it is advised to ensure that the OS specific appropriate version of eNIC and fNIC drivers are installed as depicted in following compatibility table. Servers are delivered to customers with compatible versions. Note that, in some cases, during OS/Kernel patching, drivers can get rolled back to the default driver versions. Ensure that appropriate driver version is running post OS/Kernel patching operations.
5656

5757

5858
| OS Vendor | OS Package Version | eNIC Driver | fNIC Driver |
5959
|---------------|-------------------------|---------------|--------------|
60-
| SUSE | SLES 12 SP2 | 2.3.0.40 | 1.6.0.34 |
61-
| SUSE | SLES 12 SP3 | 2.3.0.44 | 1.6.0.36 |
62-
| RHEL | RHEL 7.2 | 2.3.0.39 | 1.6.0.34 |
60+
| SuSE | SLES 12 SP2 | 2.3.0.40 | 1.6.0.34 |
61+
| SuSE | SLES 12 SP3 | 2.3.0.44 | 1.6.0.36 |
62+
| Red Het | RHEL 7.2 | 2.3.0.39 | 1.6.0.34 |
6363

6464

65-
## Commands for driver upgrade and to clean old rpm packages
65+
### Commands for driver upgrade and to clean old rpm packages
6666
```
67-
* rpm -U driverpackage.rpm
68-
* rpm -e olddriverpackage.rpm
67+
rpm -U driverpackage.rpm
68+
rpm -e olddriverpackage.rpm
6969
```
7070

71-
* Commands to confirm:
71+
####Commands to confirm:
7272
```
73-
* modinfo enic
74-
* modinfo fnic
73+
modinfo enic
74+
modinfo fnic
7575
```
7676

77-
## SUSE HLIs GRUB UPDATE FAILURE
77+
### SuSE HLIs GRUB Update Failure
7878
SAP on Azure HANA Large Instances (Type I) can be in a non-bootable state after upgrade. The below procedure fixes this issue.
79-
### Execution Steps
79+
#### Execution Steps
8080

8181

82-
* Execute multipath -ll command.
82+
* Execute `multipath -ll` command.
8383
* Get the LUN ID whose size is approximately 50G or use the command : `fdisk -l | grep mapper`
8484
* Update `/etc/default/grub_installdevice` file with line `/dev/mapper/<LUN ID>`. Example: /dev/mapper/3600a09803830372f483f495242534a56
8585
* Please note that LUN ID varies from server to server.
8686

8787

88-
## Disable EDAC (The Error Detection And Correction):
88+
### Disable EDAC (The Error Detection And Correction):
8989
The Error Detection And Correction (EDAC) module helps in detecting and correcting memory errors. However, the underlying hardware for SAP HANA on Azure Large Instances (Type I) is already performing the same function. Having the same feature enabled at the hardware and operating system (OS) levels can cause conflicts and can lead to occasional, unplanned shutdowns of the server. Therefore, it is recommended to disable the module from the OS.
9090

91-
### Execution Steps
92-
91+
#### Execution Steps
9392

9493
* Check if EDAC module is enabled. If an output is returned in below command, that means the module is enabled.
9594
```
96-
lsmod | grep -i edac
95+
lsmod | grep -i edac
9796
```
98-
* Add the modules in `/etc/modprobe.d/blacklist.conf` file using any text editor.
97+
* Blacklist the modules by appending the following lines to the file `/etc/modprobe.d/blacklist.conf`
9998
```
100-
#vim /etc/modprobe.d/blacklist.conf
101-
blacklist sb_edac
102-
blacklist edac_core
99+
blacklist sb_edac
100+
blacklist edac_core
103101
```
104102
A reboot is required to take changes in place. Execute `lsmod` command and verify the module is not present there in output.
105103

106104

107-
## Kernel parameters
105+
### Kernel parameters
108106
Make sure the correct setting for `transparent_hugepage`, `numa_balancing`, `processor.max_cstate`, `ignore_ce` and `intel_idle.max_cstate` are applied.
109107

110108
```
111-
* intel_idle.max_cstate =1
112-
* processor.max_cstate=1
113-
* transparent_hugepage=never
114-
* numa_balancing=disable
115-
* mce=ignore_ce
109+
intel_idle.max_cstate =1
110+
processor.max_cstate=1
111+
transparent_hugepage=never
112+
numa_balancing=disable
113+
mce=ignore_ce
116114
```
117-
Incorrect settings have created both performance and instability issues in the past. Follow SAP’s recommendation in your next maintenance window at the latest. Check all your SAP HANA instances on SUSE and ensure the correct setting is applied.
118-
119-
### Execution Steps
115+
Incorrect settings have created both performance and instability issues in the past. Follow SAP’s recommendation in your next maintenance window at the latest. Check all your SAP HANA instances on SuSE and ensure the correct setting is applied.
120116

117+
#### Execution Steps
121118

122119
* Add these parameters to the `GRB_CMDLINE_LINUX` line in the file `/etc/default/grub`
123120
```
124121
intel_idle.max_cstate=1 processor.max_cstate=1 transparent_hugepage=never numa_balancing=disable mce=ignore_ce
125122
```
126123
* Create a new grub file.
127124
```
128-
#grub2-mkconfig -o /boot/grub2/grub.cfg
125+
grub2-mkconfig -o /boot/grub2/grub.cfg
129126
```
130127
* Reboot system.
131128

0 commit comments

Comments
 (0)