SAPHanaSR-upgrade-to-angi-demo(8)

📦 version 1.3.4, in opensuse-leap 16.0

🌸 SAPHanaSR-upgrade-to-angi-demo(8)

okay bestie, so this one lives in the SAPHanaSR manual, section 8, and it's the glow-up guide: how to move your cluster from the old SAPHanaSR to the shiny new SAPHanaSR-angi. ✨

💖 NAME 💖

SAPHanaSR-upgrade-to-angi-demo — literally the whole vibe: how to upgrade from SAPHanaSR to SAPHanaSR-angi.

🎀 SYNOPSIS 🎀

SAPHanaSR-upgrade-to-angi-demo [ --help | --version | --list | --check |
--erase | --upgrade ]
SAPHanaSR-upgrade-to-angi-demo --run FUNCTION [ FUNCTION [ ...  ]]

🦋 DESCRIPTION 🦋

So SAPHanaSR-upgrade-to-angi-demo is a demo of how you'd upgrade from SAPHanaSR to SAPHanaSR-angi. It goes and collects info from a Linux HA cluster running SAPHanaSR, and based on that data it suggests, step by step, the exact commands to upgrade the cluster. 💅

Important, no cap: the running configuration is not changed. It's a vibe check, not a makeover. Also peep manual page SAPHanaSR_upgrade_to_angi(7).

Real talk: SAPHanaSR-upgrade-to-angi-demo is shipped as technology preview. It's giving "we're still cooking", not "production ready". 🙈

✨ OPTIONS ✨

  • --help — show help.
  • --version — show version.
  • --check — do some basic checks on configuration and status of Linux cluster.
  • --erase — show demo for removing SAPHanaSR.
  • --list — list SAPHanaSR-upgrade-to-angi-demo functions.
  • --run FUNCTION [ FUNCTION [ ... ]] — run given function(s). Heads up bestie: not all functions will work, once CIB attributes have been deleted. 😭
  • --upgrade — show demo for upgrading from SAPHanaSR to SAPHanaSR-angi.

🔥 RETURN CODES 🔥

  • 0 — successful program execution. slay. 👑
  • >0 — usage, syntax or execution errors. 💀

🌈 EXAMPLES 🌈

⭐ Copying the script to outside the package.

The script needs to be still available on both cluster nodes after the SAPHanaSR RPM has been removed. Needs to be done on all cluster nodes. (Both. All. Every single one. 🫶)

# cp -a /usr/share/SAPHanaSR/samples/SAPHanaSR-upgrade-to-angi-demo
/root/bin/
# chmod 755 /root/bin/SAPHanaSR-upgrade-to-angi-demo
# SAPHanaSR-upgrade-to-angi-demo --help

⭐ Example for finding the HANA primary node.

# SAPHanaSR-showAttr --format=script |\
  awk -F/ '$3=="clone_state=\"PROMOTED\"" {print $2}'
# crm_mon -1r | grep "* Masters: \["

⭐ Checking sane state of cluster.

This steps should be performed before doing anything with the cluster, and after something has been done. See also SAPHanaSR_upgrade_to_angi(7) and SAPHanaSR_maintenance_examples(7).

# cs_clusterstate -i
# crm_mon -1r
# crm configure show type:location | grep cli-
# SAPHanaSR-showAttr

⭐ Checking pre-requisites for the upgrade.

The scripts should be run on the HANA primary node before the upgrade. It also could be run on the HANA secondary. Any error message should be investigated. The check covers several requirements for the upgrade, but not all. On the other hand, some of the pre-requisites are caused by limitations of the script SAPHanaSR-upgrade-to-angi-demo itself — those might not be needed for doing the real upgrade manually. See also SAPHanaSR_upgrade_to_angi(7), cs_show_error_patterns(8) and cs_show_cluster_patterns(8).

# SAPHanaSR-upgrade-to-angi-demo --check

⭐ Demonstrating an upgrade.

HANA´s SID and instance number will be detected, as well as the names of both cluster nodes. The names of cluster resources and constraints will be derived from the CIB. Based on that information, command sequences will be proposed for performing an upgrade:

  • Collecting needed data.
  • Backing up old CIB, sudoers file and global.ini.
  • Setting HANA resource into maintenance mode.
  • Removing old rules from sudoers file on both nodes.
  • Removing old hook scripts from global.ini on both nodes.
  • Removing old cluster resources and constraints from CIB.
  • Removing old node attributes and SAPHanaSR properties from CIB.
  • Removing old SAPHanaSR package.
  • Adding new SAPHanaSR-angi package.
  • Adding new rules to sudoers file on both nodes.
  • Adding new hook scripts to global.ini on both nodes.
  • Adding new cluster resources and constraints to CIB.
  • Probing HANA resource status.
  • Setting HANA resource back to managed.

The script needs to be copied to all cluster nodes upfront. It should be called on the HANA primary node. Before doing this, you should check and prepare pre-requisites, see example above. The proposed commands need to be checked. Sometimes adaptions are necessary. See also SAPHanaSR_upgrade_to_angi(7).

# SAPHanaSR-upgrade-to-angi-demo --upgrade

⭐ Drafting a runbook for the manual upgrade.

The script should be used on the HANA primary node. Before doing this, you should check and prepare pre-requisites, see example above. The runbook draft is stored as file "SAPHanaSR-upgrade-draft.txt". This draft can be used for preparing details for the upgrade procedure. The proposed commands need to be checked. Sometimes adaptions are necessary. Of course the result needs to be checked finally as well. See also SAPHanaSR_upgrade_to_angi(7) and tee(1).

# SAPHanaSR-upgrade-to-angi-demo --upgrade | tee SAPHanaSR-upgrade-
draft.txt
# less SAPHanaSR-upgrade-draft.txt

⭐ Demonstrating removal of package SAPHanaSR and its configuration.

Removing the old SAPHanaSR without performing the complete upgrade manually might be useful, if installation and configuration of the new SAPHanaSR-angi should be done by deploymant automation tools.

HANA´s SID and instance number will be detected, as well as the names of both cluster nodes. The names of cluster resources and constraints will be derived from the CIB. Based on that information, command sequences will be proposed for performing the removal of SAPHanaSR:

  • Collecting needed data.
  • Backing up old CIB, sudoers file and global.ini.
  • Setting HANA resource into maintenance mode.
  • Removing old rules from sudoers file on both nodes.
  • Removing old hook scripts from global.ini on both nodes.
  • Removing old cluster resources and constraints from CIB.
  • Removing old node attributes and SAPHanaSR properties from CIB.
  • Removing old SAPHanaSR package.

The script needs to be copied to all cluster nodes beforehand. It should be called on the HANA primary node. Before doing this, you should check and prepare pre-requisites, see example above. The proposed commands need to be checked. Sometimes adaptions are necessary. Of course the result needs to be checked finally as well. See also SAPHanaSR_upgrade_to_angi(7).

# SAPHanaSR-upgrade-to-angi-demo --erase

🍓 FILES 🍓

  • /usr/share/SAPHanaSR-angi/samples/SAPHanaSR-upgrade-to-angi-demo — unsupported script for demonstrating the procedure on a test cluster. (unsupported is the key word here bestie 🙈)
  • /etc/sudoers.d/SAPHanaSR — recommended place for sudo permissions of HADR provider hook scripts
  • /hana/shared/$SID/global/hdb/custom/config/global.ini — on-disk representation of HANA global system configuration
  • SAPHanaSR-upgrade-to-angi-demo.<timestamp> — directory with backup of old configuration

💜 REQUIREMENTS 💜

  • The initial configuration matches SUSE´s documented setup of the SAPHanaSR scale-up performance-optimised scenario.
  • Linux cluster, HANA and system replication are in sane state before the upgrade. All cluster nodes are online.
  • Package libxml2-tools is installed on both cluster nodes. Package ClusterTools2 is recommended.
  • SAPHanaSR-upgrade-to-angi-demo is copied into /root/bin/ and made executable on both cluster nodes.
  • SAPHanaSR-upgrade-to-angi-demo is executed on the HANA primary node.
  • SAPHanaSR-upgrade-to-angi-demo should be run on test systems.
  • A backup has been made for the cluster nodes.
  • The commands suggested by SAPHanaSR-upgrade-to-angi-demo have been checked before they will be applied.
  • For further requirements see manual page SAPHanaSR_upgrade_to_angi(7).
fr fr, read that list again. A backup. On the cluster nodes. Do it. 😭

💀 BUGS 💀

In case of any problem, please use your favourite SAP support process to open a request for the component BC-OP-LNX-SUSE. Please report any other feedback and suggestions to feedback@suse.com.

🌟 SEE ALSO 🌟

SAPHanaSR-angi(7) , SAPHanaSR(7) , ocf_suse_SAPHana(7) , ocf_suse_SAPHanaController(7) , SAPHanaSR.py(7) , susHanaSR.py(7) , SAPHanaSR_upgrade_to_angi(7) , SAPHanaSR_maintenance_examples(7) , SAPHanaSR-showAttr(8) , crm(8) , crm_mon(8) , crm_attribute(8) , cibadmin(8) , cs_wait_for_idle(8) , https://documentation.suse.com/sbp/sap/ , https://www.suse.com/c/tag/towardszerodowntime/ https://documentation.suse.com/sles-sap/trento/

👑 AUTHORS 👑

A.Briel, F.Herschel, L.Pinne.

(c) 2024-2026 SUSE LLC

SAPHanaSR-upgrade-to-angi-demo comes with ABSOLUTELY NO WARRANTY. For details see the GNU General Public License at http://www.gnu.org/licenses/gpl.html

okay that's the whole page, mwah 💋 this little beauty is from SAPHanaSR, dated 25 Mar 2025, and it's the SAPHanaSR-upgrade-to-angi-demo(8) page — go forth and upgrade responsibly, bestie. 🎀💖

📦 where this page comes from