Chapter 3. Upgrading an SAP HANA System

Procedure

1. Complete system-specific setup.

   1. Prepare non-cloud or BYOS cloud systems by executing the following steps:
      

      1. If you previously performed an in-place upgrade from RHEL 7 to RHEL 8, remove the /root/tmp_leapp_py3 directory if it is present on your system:

         # rm -rf /root/tmp_leapp_py3

         Copy to Clipboard Toggle word wrap

      2. Register and subscribe the system to a Red Hat repository source. If you use Red Hat Satellite, ensure that both RHEL 8 and 9 e4s repositories are available and synchronized with the latest updates. Enable the following repositories for the activation key:

         • RHEL 8.10 - normal repositories for RHEL 8 and E4S repositories for RHEL 9:

           rhel-8-for-x86_64-baseos-rpms
           rhel-8-for-x86_64-appstream-rpms
           rhel-8-for-x86_64-sap-netweaver-rpms
           rhel-8-for-x86_64-sap-solutions-rpms
           rhel-9-for-x86_64-baseos-e4s-rpms
           rhel-9-for-x86_64-appstream-e4s-rpms
           rhel-9-for-x86_64-sap-netweaver-e4s-rpms
           rhel-9-for-x86_64-sap-solutions-e4s-rpms

           Copy to Clipboard Toggle word wrap

      3. Check and confirm that your RHEL 8 system has the normal repositories enabled:

         # subscription-manager repos --disable='*' \
         --enable="rhel-8-for-x86_64-baseos-rpms" \
         --enable="rhel-8-for-x86_64-appstream-rpms" \
         --enable="rhel-8-for-x86_64-sap-solutions-rpms" \
         --enable="rhel-8-for-x86_64-sap-netweaver-rpms"

         Copy to Clipboard Toggle word wrap

      4. Remove all files cached by yum/dnf:

         # rm -rf /var/cache/yum

         Copy to Clipboard Toggle word wrap

      5. On RHEL 8.10 BYOS system, ensure that no RHEL release lock is set.

         # subscription-manager release --unset

         Copy to Clipboard Toggle word wrap

   2. Prepare PAYG cloud systems on AWS, Google Cloud, or Microsoft Azure:

      If you upgrade from RHEL 8.10, remove the version lock by removing a file /etc/yum/vars/releasever:

      # rm /etc/yum/vars/releasever

      Copy to Clipboard Toggle word wrap

2. After completing the above steps, perform the remaining steps on all systems, no matter if your system is a non-cloud, BYOS cloud, or PAYG cloud system on AWS, Google Cloud or Microsoft Azure.
   

   1. Stop the SAP HANA systems and stop all SAP processes.

      Important

      Do not unmount the SAP HANA file systems, as these are required for detecting if SAP HANA is installed and the version of the installed system.

   2. If your system is configured to start SAP processes automatically at boot time, turn off the automatic start of SAP processes.
      

   3. Verify that the RHEL settings for SAP HANA are in place by checking the following:
      

      1. As per SAP note 2772999, the following parameter is required for SAP applications, including SAP HANA and is typically set in file /etc/sysctl.d/sap.conf:

         vm.max_map_count = 2147483647

         Copy to Clipboard Toggle word wrap

         The same setting is required for SAP applications, including SAP HANA on RHEL 9.
         The file /etc/sysctl.d/sap.conf might also contain:

         kernel.pid_max = 4194304

         Copy to Clipboard Toggle word wrap
      2. All other settings for SAP HANA (in file /etc/sysctl.conf and /etc/sysctl.d/sap_hana.conf) are identical for RHEL 8 and RHEL 9 and must be left in place. For details, refer to SAP Notes 2382421.
         

   4. Update your RHEL 8.* system to the required source OS version package levels:

      # dnf update

      Copy to Clipboard Toggle word wrap

   5. Reboot the system:

      # reboot

      Copy to Clipboard Toggle word wrap
   6. After the system is up and running, check and confirm that no SAP HANA systems and no SAP processes are running on the system.
      
   7. Make sure the SAP HANA file systems are available.
      

   8. Install the leapp utility:

      # dnf install leapp-upgrade

      Copy to Clipboard Toggle word wrap

      1. Prepare PAYG cloud instances on AWS by installing the leapp-rhui-aws-sap-e4s package:

         # dnf install leapp-rhui-aws-sap-e4s

         Copy to Clipboard Toggle word wrap
      2. Prepare PAYG cloud instances on Google Cloud by downloading and installing the leapp-rhui-google-v4-rhel8-sap package as instructed in the Leapp RHUI packages for Google Cloud Platform (GCP) document.

      3. Prepare PAYG cloud instances on Microsoft Azure by installing the leapp-rhui-azure-sap package:

         # dnf install leapp-rhui-azure-sap

         Copy to Clipboard Toggle word wrap

9. Temporarily turn off any antivirus software.
   
10. Ensure there is no configuration management system (such as Salt, Chef, Puppet, Ansible) enabled or configured to attempt to restore the original RHEL 8 system.
    
11. Ensure your system does not use any Network Interface Card (NIC) with a name based on the prefix 'eth'. Refer to this KB article for more information.
    
12. If your NSS (Network Security Services) database was created in RHEL 7 or earlier, verify that the database has been converted from the DBM database format to SQLite. For more information, see Updating NSS databases from DBM to SQLite.
    
13. RHEL 9 does not support the legacy network-scripts package that was deprecated in RHEL 8. Before you upgrade, move your custom network scripts and write a NetworkManager dispatcher script that executes your existing custom scripts. For more information, see Migrating custom network scripts to NetworkManager dispatcher scripts.
    
14. Make sure that you have a full backup or a virtual machine snapshot of your system.
    
15. If not done already, perform a restore test of the backup to another system, to make sure that the backup can be used for a successful restore. A restore test is also useful for getting used to the required restore activities so that you can get a working system back as quickly as possible if necessary.

Procedure

1. Perform the pre-upgrade assessment:

   • On a non-cloud or BYOS cloud system, run:

     # leapp preupgrade --channel e4s --target <target_os_version>

     Copy to Clipboard Toggle word wrap

   • On a PAYG cloud instance on AWS, Google Cloud or Microsoft Azure, run:

     # leapp preupgrade --no-rhsm --channel e4s --target <target_os_version>

     Copy to Clipboard Toggle word wrap

     Replace <target_os_version> with the target OS version, for example, 9.4 or 9.6.

2. If any inhibitors are reported, the output file /var/log/leapp/leapp-report.txt contains all necessary information, including remediation steps, to avoid these inhibitors.
3. Manually resolve all the reported problems before proceeding with the in-place upgrade. You can repeat this step until no more inhibitors are reported.

Procedure

1. Before performing the upgrade, back up all of your data to avoid potential data loss if you have not done so already.
   
2. Perform a restore test to verify that the last backup was successful.
   
3. Verify that no SAP HANA system and no SAP processes are running on the system.
   
4. Confirm that the SAP HANA file systems are mounted, as a certain file located below this path is used by Leapp to detect the SAP HANA version when upgrading to RHEL 9.
   
5. Verify that your SAP HANA system does not start automatically at boot time. For more information, see the SAP note 2315907 - Starting HANA automatically after the host has been started.
   

6. Start the upgrade process:

   • On a non-cloud or BYOS cloud system, enter:

     # leapp upgrade --channel e4s --target <target_os_version>

     Copy to Clipboard Toggle word wrap

   • On a PAYG cloud instance on AWS, Google Cloud or Microsoft Azure, enter:

     # leapp upgrade --no-rhsm --channel e4s --target _<target_os_version>_

     Copy to Clipboard Toggle word wrap

     Replace <target_os_version> with the target OS version, for example, 9.4 or 9.6.

7. After the completion of this command, restart the system to finish the upgrade:
   

   # reboot

   Copy to Clipboard Toggle word wrap
8. The system boots into a RHEL 9-based initial RAM disk image (initramfs), upgrades all packages, and restarts again. After all packages are upgraded, the system automatically starts into the RHEL 9 system.

Procedure

1. Verify that the current OS version is Red Hat Enterprise Linux 9. For example, for the upgrade from RHEL 8.10 to RHEL 9.6:

   # cat /etc/redhat-release
   Red Hat Enterprise Linux release 9.6 (Plow)

   Copy to Clipboard Toggle word wrap

2. Verify that the RHEL release lock is set to the required target OS version. For example, when you upgrade from RHEL 8.10 to RHEL 9.6:

   • On a non-cloud or BYOS cloud system:

     Make sure that the RHEL release lock is set to 9.6 and that all lines in /etc/yum.repos.d/redhat.repo starting with baseurl contain the string rhel9/9.6(and not, for example, rhel9/8.10), in the URL field. Enter:

     # subscription-manager release --set=9.6
     Release set to: 9.6

     Copy to Clipboard Toggle word wrap

   • On a PAYG cloud instance on AWS, Google Cloud or Azure, enter:

     # cat /etc/dnf/vars/releasever
     9.6

     Copy to Clipboard Toggle word wrap

3. Verify that the system has all necessary repositories enabled:

   # dnf repolist

   Copy to Clipboard Toggle word wrap

   • On a non-cloud or BYOS cloud system, the output should contain:

     rhel-9-for-x86_64-appstream-e4s-rpms
     rhel-9-for-x86_64-baseos-e4s-rpms
     rhel-9-for-x86_64-sap-netweaver-e4s-rpms
     rhel-9-for-x86_64-sap-solutions-e4s-rpms

     Copy to Clipboard Toggle word wrap

   • Turn off all normal (=non-e4s) repositories:

     # subscription-manager repos \
     --disable="*" \
     --enable="rhel-9-for-x86_64-baseos-e4s-rpms" \
     --enable="rhel-9-for-x86_64-appstream-e4s-rpms" \
     --enable="rhel-9-for-x86_64-sap-solutions-e4s-rpms" \
     --enable="rhel-9-for-x86_64-sap-netweaver-e4s-rpms"+*

     Copy to Clipboard Toggle word wrap

   • On a PAYG cloud instance on AWS, the output should contain:

     rhel-9-for-x86_64-appstream-e4s-rhui-rpms
     rhel-9-for-x86_64-baseos-e4s-rhui-rpms
     rhel-9-for-x86_64-highavailability-e4s-rhui-rpms
     rhel-9-for-x86_64-sap-netweaver-e4s-rhui-rpms
     rhel-9-for-x86_64-sap-solutions-e4s-rhui-rpms
     rhui-client-config-server-9-sap-bundle

     Copy to Clipboard Toggle word wrap

   • On a PAYG cloud instance on Google Cloud, the output should contain:

     google-cloud-sdk
     google-compute-engine
     rhui-rhel-9-for-x86_64-appstream-e4s-rhui-rpms
     rhui-rhel-9-for-x86_64-baseos-e4s-rhui-rpms
     rhui-rhel-9-for-x86_64-highavailability-e4s-rhui-rpms
     rhui-rhel-9-for-x86_64-sap-netweaver-e4s-rhui-rpms
     rhui-rhel-9-for-x86_64-sap-solutions-e4s-rhui-rpms

     Copy to Clipboard Toggle word wrap

   • On a PAYG cloud instance on Microsoft Azure, the output should contain:

     rhel-9-for-x86_64-appstream-e4s-rhui-rpms
     rhel-9-for-x86_64-baseos-e4s-rhui-rpms
     rhel-9-for-x86_64-highavailability-e4s-rhui-rpms
     rhel-9-for-x86_64-sap-netweaver-e4s-rhui-rpms
     rhel-9-for-x86_64-sap-solutions-e4s-rhui-rpms
     rhui-microsoft-azure-rhel9-sap-ha

     Copy to Clipboard Toggle word wrap
4. Verify that network services are operational. For example, try to connect to the system using SSH.

Procedure

1. If you had configured your RHEL 8.* system for SAP HANA using the RHEL System Roles for SAP (package rhel-system-roles-sap, roles sap_general_preconfigure and sap_hana_preconfigure) and if you have not done any additional modifications to your system configuration, you can configure your system with the RHEL System Roles for SAP whenever required.

2. In case you want or need to configure your system manually, the following steps will be required:

   1. Confirm that the Server environment group is installed:

      # dnf group list installed server+*+
      [...]
      Installed Environment Groups:
         Server

      Copy to Clipboard Toggle word wrap

   2. Verify that the packages chkconfig and compat-openssl11 are installed:

      # dnf list installed chkconfig compat-openssl11
      [...]
      Installed Packages
      chkconfig.x86_64          1.20-2.el9         @System
      compat-openssl11.x86_64   1:1.1.1k-4.el9_0   @rhel-9-for-x86_64-appstream-e4s-rpms

      Copy to Clipboard Toggle word wrap

      Install any of the previously mentioned packages if necessary.

      Note

      The compat-openssl11 package is only required for SAP HANA scale-out installations.

   3. Verify that the service abrt-ccpp is nonexistent or disabled:

      # systemctl status abrt-ccpp
      Unit abrt-ccpp.service could not be found.

      Copy to Clipboard Toggle word wrap

      If it exists and is not disabled, disable it:

      # systemctl disable abrt-ccpp --now

      Copy to Clipboard Toggle word wrap

      After modifying your system configuration as described, restart your system.

      Note

      For verifying that your system is configured according to the applicable SAP notes, you can run RHEL system roles sap_general_preconfigure and sap_hana_preconfigure in assert mode.

3. Verify that your system is running with the RHEL kernel version certified for the desired OS target version, as required in SAP note 3108302.

   # uname -r
   5.14.0-570.12.1.el9_6.x86_64

   Copy to Clipboard Toggle word wrap