XS Deployment Process

Guide for XS Deployment Process (start here):

Node.js Prerequisite

Before starting either deployment scenario below, confirm that Node.js ≥22.14.0 is installed on the XSA host. The new approuter no longer supports Node 18 or Node 20.
See Section: Runtimes Handling → Pre-Deployment Runtime Check for the install/update procedure.

• Regular deployment on machine with possible outside connection
  

  Guide for Non-Isolated Environment

• Deployment in an isolated environment
  

  Guide for Isolated Environment

 

Further Deployment Help for Both Isolated and Non-Isolated Environments:

AI Connector Link

SAP XS Advanced got 2 options to provide connections to deployed applications:

• Link with the application name + default domain
• Ports

In both cases, it happens that during the update, the application port/link can change/be missing and can cause problems.

Go to the section of Routes in the selected space in the XS cockpit.

In case a link is missing, recreate it and bind to the app

In case a new port is assigned, the old one should be available, so just create one and bind to the app as well.

Ollama Server Link

Skybuffer AI solution requires a link to Ollama server with the installed language model.

 

Customers can host such server on their own and should know its IP Address/link:PORT

In case Skybuffer resources should be used, please contact us to get the connection details.

Official documentation regarding handling runtimes provided by SAP can be found at:

SAP HANA Administration Guide for SAP HANA Platform

Runtime Verification

Check the available runtimes by using the command: xs runtimes

Before proceeding with the deployment or upgrading an existing Skybuffer AI release, verify that your SAP HANA XS Advanced environment provides an active Node.js runtime version not lower than 22.14.0.

1. Check Available XSA Runtimes
Log in to your XSA environment via the CLI and execute:
xs runtimes

Look for the installed Node.js versions in the output. Confirm that a Node.js 22 LTS runtime (version ≥ 22.14.0) is registered and active.

2. Update the Runtime (if required)
If the Node.js 22 runtime is missing or older than 22.14.0, update or register the compatible Node.js buildpack prior to deploying the MTAR archive. Detailed installation and update instructions are provided in SAP Note 2955324.

⚠️ CRITICAL NOTICE / PREREQUISITE
The application package includes dependencies such as @sap/approuter v23, which strictly requires even-numbered LTS runtimes (“node”: “^22.0.0 || ^24.0.0”).
Deploying the application archive on an XSA system with a Node.js runtime lower than 22.14.0 or using odd-numbered releases (e.g., Node.js 23) will cause container staging and deployment to fail.
Verifying, maintaining, and updating the runtime environment in SAP HANA XS Advanced is the customer’s sole responsibility prior to initiating the deployment process.

Upload Runtime

Make sure that you are on the same location where you placed the Python zip file. Otherwise, provide the full path.

Use the following command: xs create-runtime -p <file name> “Python 3.11.0”
See the example of such command in the following screenshot:

Create Python Runtime (Optional)

You can download Python environment in version 3.11.0 from official https://www.python.org/

Then configure and install it on XSA manually.
For more details on manual installation, please contact your OS administrator.

Alternatively, you can download an unofficial script from select_python.sh (This applies only for servers that have external Internet connection)

Edit the script configuration and adjust the path:

Save the file and run the script as a root

./build_python 3.11.0
Remove the existing runtime with the command xs delete-runtime -i <ID> (check phyton ‘id’ by xs runtime command)
Use the command ./<build_python> that is the name of the saved script 3.11.0 to create the runtime.
In case of any questions, contact your OS administrator.

Missing Libraries on Operating System

Potentially, there can be a scenario in which even if you generate a runtime, or use the one already prepared in the new machine, Python app will still crash during stage or run stage. In this case, please contact your OS admin and ensure that the following libraries are installed:

• libffi-devel
• sqlite-devel
• bzip2-devel
  Depending on your system, you can use the command: yum install <name-devel>
  For more details, contact your OS administrator.

Text recognition – OCR Setup 

Skybuffer AI can turn on text recognition. To prepare this feature, we need to have 2 prerequisites :

1. Installed OS library
2. Change Parameter for py_parsing_file application

To turn it on, we need to go to User-Provided Variables of py_file_parsing app and find PY_FILE_PARSING_PDF_OCR, next click Modify (pencil icon) and change from False to True.

Under OS, search for following packages:

• poppler.x86_64
• poppler-devel.x86_64
• poppler-utils.x86_64
• tesseract.x86_64
• tesseract-devel.x86_64

Useful Links:

1. 2711421 – Installing SAP HANA Extended Application Services, advanced model using the XS Advanced installation media:
   SAP Note 2711421
2. 3129918 – How to install the latest patch on SAP HANA XSA:
   SAP Note 3129918
3. Getting Started with Application Development in XS Advanced:
   SAP Help: Application Development
4. Maintaining XS Advanced Application Runtimes:
   SAP Help: Maintaining Runtimes
5. Python environment:
   Python Official Website
6. Script of Python selecting:
   Python Script
   
7. The SAP HANA XS Command-Line Interface Reference:
   SAP HANA XS Command-Line Interface Reference
8. XSA binding error with Job Scheduler service:
   https://me.sap.com/notes/3633080