Guide for Non-Isolated Environment

1. Before Start

To avoid issues during the deployment process, please check the following prerequisites before starting:

1.1.Verify XSA version

You can check the current version XSA runtime and XSA components with xs version and xs lc commands executed with <sid>adm user.

For more details, please check the following SAP notes:

https://me.sap.com/notes/2711421

https://me.sap.com/notes/0003129918

1.2 Verify Python runtime availability

See Section: Runtimes Handling.

2. Regular deployment on machine with possible outside connection

2.1. XS Environment Preparation

If necessary, create a new organization and a separate space for installation (other than SAP space) in the XSA Cockpit. For more details on that, see the instructions for SAP HANA and XSA Configuration described in the guide of Installing SAP HANA System Including XS Advanced Runtime, Section Configure SAP HANA and XSA, Steps 1 and 4.

Additionally, you can check a list of available spaces from xs cli (i.e. xs command line).

To log in XSA, use the command: xs login

List of available spaces can be found with running the command: xs spaces

If necessary, it is possible to switch between spaces: xs target -s <space name>

List of available organizations can be found via: xs orgs
If necessary, it is possible to switch between spaces: xs target -o <org name>

Upload mtar files into the machine. It is recommended to use the home folder of sidadm user.

Example:

2.2. Deployment Process

Once your environment is prepared and the files are uploaded, you can start deploying the files.

The recommended order for deploying Skybuffer AI components is the following:

skybfrxts
skybfryai
skybfryai_py_ai_core
skybfryai_rag_m
botclientconnector

The command to deploy is xs deploy <filename.mtar>

Before you start, please make sure that you are in the right space. You can do so by using the command of xs apps:

This command makes it possible to see the list of the applications installed. If you see No apps found, that means that the new space is empty and you are on the good path to start deploying (all mtar files available).

If you are updating the space which already has the apps installed, you can check if you are on the right place with the command of xs spaces

Now run the command of xs deploy <filename.mtar>.

If everything is OK, run this command with all the components to install all Skybuffer archives in the sequence described at the beginning of Deployment Process.

2.3 Common Problems during Deployment

Optional service warnings

Warnings 404 regarding optional services can be ignored. During the first attempt to deploy the Python application, it may fail. The reason is missing Python 3.9.0 runtime as per log.

Doublecheck if the Python runtime exists in the proper version 3.9.0.

For more details, see Section: Runtimes Handling.

Once the runtime is available, you can retry deployment.