How to Upgrade SAP HANA XSA (Step-by-Step Guide with Commands)

Table of Contents

How to Upgrade SAP HANA XSA (Step-by-Step Guide with Commands)

This guide shows you how to upgrade SAP HANA XS Advanced (XSA) safely and efficiently, including exact commands, validation tips, and what to do when HANA System Replication is enabled.

SAP HANA XSA upgrade step-by-step flowchart — High-level flow of the SAP HANA XSA upgrade process.

Click to Read SAP HANA Multi Target Replication Setup

Prerequisites

XSA_ADMIN password is available.
You can run these commands as <sid>adm:
```
xs lc
xs version
```

Note: If both commands return results successfully, you are ready to proceed with the upgrade.

Check Current XSA Versions

First verify the XS Advanced Runtime and component versions.

xs version

Example output:

XS Advanced Runtime version: 1.13.14
XS Advanced Controller version: 1.13.14

If your versions are older than those in the latest XS Advanced media, update using the media before continuing.

Download the Latest XSA Runtime Patch

From the SAP Support Portal → Support Packages and Patches, navigate:

By Category
  > SAP In-Memory (SAP HANA)
  > HANA PLATFORM EDITION
  > SAP HANA PLATFORM EDITION 2.0
  > SAP EXTENDED APP SERVICES 1

Download the file (pattern):

EXTAPPSER00P_XXX-XXXXXXXX.SAR

Upload & Extract the Patch (hdblcm)

Upload the .SAR to your XSA server, e.g. /tmp/packages/EXTAPP.
As <sid>adm, run:

cd hdblcm
./hdblcm --action=extract_components

This extracts the software archive for installation.

Run the Installer

Point hdblcm to the component root directory you extracted:

./hdblcm --component_root=/tmp/packages/EXTAPP

When prompted, choose:

update_components

Validate the Upgrade

Confirm the new version after the update:

xs version

Example after upgrade:

XS Advanced Runtime version: 1.14.21
XS Advanced Controller version: 1.14.21

If versions reflect the expected patch level, the SAP HANA XSA upgrade is complete.

Upgrading XSA with HANA System Replication

Important: You cannot upgrade XSA while HANA System Replication is active.

To upgrade on the Secondary / DR node

Break the system replication.
Start the HANA DB on the secondary node in standalone mode.
Perform the XSA upgrade steps above (download → extract → install → validate).
Reconfigure replication with the primary node.

If you later switch primary/secondary roles, repeat the same process on the new secondary node.

Best Practices & Tips

Always test the upgrade in non‑production before production.
Ensure adequate free disk space where you place the .SAR and extracted components.
Capture pre/post checks: keep xs version output for audit.
Coordinate a maintenance window, especially when breaking replication.

Prerequisites

Check Current XSA Versions

Download the Latest XSA Runtime Patch

Upload & Extract the Patch (hdblcm)

Run the Installer

Validate the Upgrade

Upgrading XSA with HANA System Replication

To upgrade on the Secondary / DR node

Best Practices & Tips

Related Posts

SAP HANA DBA Calculations: Sizing, Backup, Memory & Performance

How to upgrade SAP HANA XSA

ECC to SAP S/4HANA Conversion – A Complete Roadmap for Success

Leave a Reply Cancel reply