5 Upgrading an SAP HANA cluster #
This chapter describes how to upgrade your SAP HANA cluster with the YaST module
. This acts as a wizard and guides you through all the SAP HANA cluster maintenance procedures.The official SAP HANA documentation describes the so-called Near Zero Downtime Upgrade Process. The YaST module is based on this process and handles the part of the procedure related to the SUSE cluster. Not all steps can be done automatically. Some steps need to be performed manually by the SAP HANA administrator. The YaST module will inform you during the process.
This YaST module is available in the yast2-sap-ha package for SUSE Linux Enterprise Server for SAP Applications 12 SP3 and higher. Currently, the wizard is only prepared to handle the SAP HANA Scale-up Performance Optimized scenario.
The upgrade covers the following tasks:
5.1 Preparing the upgrade #
Ensure passwordless SSH access between the two nodes (primary and secondary) for root
.
Keep in mind, some cloud service providers might not have set up SSH access
for the root
by default.
Install the yast2-hana-update package on both nodes:
#
zypper
install yast2-hana-updateAfter the installation, you can find the module
in the .On the secondary node, start the
and open the module.In the YaST module, review the prerequisites. Make sure to fulfill all of them before continuing with the next step. Keep in mind that the wizard supports only the HANA Scale-up Performance Optimized scenario.
To upgrade the SAP HANA system, select the secondary node.
Select the location of the installation medium.
Point to the location where the SAP medium is located. If wanted, check
and provide the NFS share and path.Important: Differences between SAP HANA version 1.0 and 2.0If you are upgrading from SAP HANA version 1.0 to version 2.0, make sure to check
.The YaST module will copy the PKI SSFS keys from the former secondary node to the former primary node. More information is available through the button.
Continue with Section 5.2, “Upgrading your SAP HANA cluster”.
5.2 Upgrading your SAP HANA cluster #
Review the update plan generated by the wizard.
The wizard shows you two steps: automatic and manual. In this automatic step, the wizard puts cluster resources into maintenance mode before it starts with the automatic steps. The manual steps are SAP HANA-specific and need to be executed by an SAP HANA administrator. For more information, see the official SAP HANA documentation.
Update the SAP HANA software.
The wizard executes the automatic actions and waits until the SAP HANA administrator performs the SAP HANA upgrade.
Perform the SAP HANA upgrade.
Review the plan for the primary (remote) node.
After the SAP HANA upgrade is done, the wizard shows the update plan. When you continue with this step, the wizard turns the primary node into a secondary node to make it ready for the upgrade.
Keep in mind that this step can take some time.
Continue with Section 5.3, “Finishing the upgrade task”.
5.3 Finishing the upgrade task #
Update the former primary node.
Pay special attention to the
--hdbupd_server_nostart
option in this step.Restore the previous state of the cluster.
By default, the wizard registers the former master as now being secondary on the SAP HANA system replication. If you want to revert the system replication to its original state, click the
button.Review the update summary.
You can review the original and current SAP HANA versions and the cluster state.
Note: Dealing with intermediate cluster stateIf the wizard is faster than the status update of the cluster resources, the summary shows an intermediate cluster state. The cluster state is
UNDEFINED
orDEMOTED
.To overcome this, check the cluster status again with the command
SAPHanaSR-showAttr
and make sure the former secondary node is now in the statePROMOTED
.
Refer to the SUSE blog post https://www.suse.com/c/how-to-upgrade-your-suse-sap-hana-cluster-in-an-easy-way/ for further information.