In this chapter, you will learn how to prepare your SAP BTP Provider Subaccount for the deployment of the sample SaaS solution by assigning the required entitlements and setting up the foundational components. This includes a SAP HANA Cloud instance which you need to share with your Cloud Foundry environment or your Kyma Cluster before deployment.
As already mentioned, you can set up the Basic Version of the sample application in any SAP BTP environment using Free (Tier) service plans of your own Pay-as-you-Go (PAYG) or CPEA account. A tutorial how to setup a PAYG account (allowing you to use all Free Tier service plans) can be found in the Tutorial Navigator.
Hint - While a setup in Trial accounts is possible, we strongly recommend the usage of free tier services plans in a PAYG or CPEA account. This will allow you to change to a paid service plan in the future. If you decide to with the Trial landscape, please make sure to choose the us10 region to use SAP HANA Cloud.
Please make sure to cater the following prerequisites:
Cloud Foundry (only)
- In Free Tier scenarios, please create your SAP BTP Cloud Foundry environment using the free service plan (! assign in Entitlements if not visible !).
Important - Make sure to create your SAP BTP Cloud Foundry Runtime using the free plan and not the Standard plan.
Important - Please make sure to your Organization and Space name do not contain any spaces, special characters (except "-") or capital letters! Hint - In Trial environments, the correct entitlement (MEMORY service plan) is auto-assigned to your default subaccount.
Kyma (only)
- In Free Tier scenarios, please set up the SAP BTP Kyma Runtime using the free service plan (! assign in Entitlements if not visible !).
Hint - Follow the official documentation in SAP Tutorial navigator (click here) if required. Hint - In Trial environments, you have to assign the trial service plan to your subaccount.
General (Kyma & Cloud Foundry)
- Set up a SAP HANA Cloud instance (hana-free service plan) using the SAP HANA Cloud Tools (tools service plan).
Hint - In Trial environments, you have to assign the hana service plan to your subaccount.
Hint - Check the following blog post to find more details about how to setup your SAP HANA Cloud instance using the HANA Tools (click here.
Important - Please make sure to select the correct free service plans in PAYG or CPEA scenarios, as paid service plans will generate costs in your account!
Please check the limitations mentioned below when it comes to the usage of some SAP BTP service plans like e.g., hana-free. Furthermore, please note that the hana-free service plan is not available in all SAP BTP regions. You can check the availability in SAP Discovery Center (click here).
The application requires the following set of SAP BTP entitlements in the Provider Subaccount:
Kyma
| Service / Subscription | Free Tier / (Trial) Plans |
|---|---|
| Destination Service | Lite |
| SAP Alert Notification service for SAP BTP | Free / (Trial: Lite) |
| SAP Application Logging Service | Lite |
| SAP Authorization and Trust Management Service | Broker Application |
| SAP BTP, Kyma Runtime | Free / (Trial: Trial) |
| SAP Cloud Management Service for SAP BTP | Central |
| SAP HTML5 Application Repository Service for SAP BTP | App-host App-runtime |
| SAP Software-as-a-Service Provisioning service | Application |
| SAP HANA Cloud | hana-free (Trial: hana) tools |
| SAP HANA Schemas & HDI Containers | hdi-shared |
| SAP Service Manager | Container Subaccount-Admin |
Cloud Foundry
Hint - 1GB of Cloud Foundry Runtime is sufficient for this use-case.
| Service / Subscription | Free (Tier) / (Trial) Plans |
|---|---|
| Application Autoscaler | Standard |
| Destination Service | Lite |
| SAP Alert Notification service for SAP BTP | Free / (Trial: Lite) |
| SAP Application Logging Service | Lite |
| SAP Authorization and Trust Management Service | Broker Application |
| SAP BTP, Cloud Foundry Runtime | Free / (Trial: MEMORY) |
| SAP Cloud Management Service for SAP BTP | Central |
| SAP Credential Store | Free / (Trial: Trial) |
| SAP HTML5 Application Repository Service for SAP BTP | App-host App-runtime |
| SAP SaaS Provisioning Service | Application |
| SAP HANA Cloud | hana-free / (Trial: hana) tools |
| SAP HANA Schemas & HDI Containers | hdi-shared |
| SAP Service Manager | Container Subaccount-Admin |
If you need assistance assigning entitlements to your Provider Subaccount, you might find information here.
Hint - To learn more about SAP HANA Cloud in general, please check the following Learning Journey (https://learning.sap.com/learning-journey/provision-and-administer-databases-in-sap-hana-cloud).
If not available yet, please create a SAP HANA Cloud instance in your Provider subaccount or share an existing SAP HANA Cloud from any other subaccount within the same SAP BTP region (e.g., eu10). Any SAP HANA Cloud instance in the same region as your Cloud Foundry environment or Kyma Cluster, can be enabled for usage within your Provider subaccount.
Once you created the SAP HANA Cloud instance, please map it with your Cloud Foundry environment or Kyma Cluster using the Instance Mapping feature. You can either map the SAP HANA Cloud instance with all namespaces in the Kyma Cluster or provide a dedicated namespace name. Same applies for Cloud Foundry, where you can map the SAP HANA Cloud instance to a whole Organization or a specific Space.
Kyma (only)
More information on how to share your SAP HANA Cloud instance with your Kyma Cluster can be found in the following blog post (click here).
Important - Please make sure to use the new SAP HANA Cloud Tools service (service plan tools) for this purpose! The instance mapping feature for Kyma is not available in the SAP HANA Cloud Central UI.
Cloud Foundry (only)
More information on how to share your SAP HANA Cloud instance with your Cloud Foundry environment can be found in the following SAP Help document (click here). Similar features are also offered by the SAP HANA Cloud Tools, which can also be used to map an existing SAP HANA Cloud instance to your Cloud Foundry landscape.
Kyma (only)
For the Kyma environment, this step is not required as no lifecycle events are send by the sample application using the Alert Notification Service.
Cloud Foundry (only)
If you are using the Cloud Foundry Runtime, please add a dedicated Technical User as a Space Auditor to the Cloud Foundry Space of your Provider Subaccount. This user is required by SAP Alert Notification to inform you about lifecycle events of your SaaS application. You can find a list of users per region in the official SAP Help documentaton (click here).
For us10 region, please add for example [email protected] as a Space Auditor.
When using free SAP BTP services plans like trial for Kyma or hana-free for SAP HANA Cloud, please be aware of the following limitations:
Kyma (only)
- Your Free Kyma Clusters in trial, PAYG and CPEA accounts have a restrictive resource limitation. Make sure you have enough resources left before deploying the sample application. Check out the details provided in Discovery Center to learn more.
- SAP BTP Kyma trial service plan is usable for 14 days only (click here). After this period, you need to setup a new SAP BTP Kyma Cluster. This limitation does not exist in CPEA or PAYG accounts using the free tier service plans. Therefore, we highly recommend to use a PAYG or CPEA account combined with free tier service plans.
Cloud Foundry (only)
- All Cloud Foundry workloads in trial environments, will be stopped on a daily basis, to reduce resource consumption. Check (and if necessary restart) your applications before using your SaaS scenarios.
General (Kyma & Cloud Foundry)
- Free SAP HANA Cloud instances will be stopped on a daily basis, to reduce resource consumption. Check (and if necessary restart) your SAP HANA Cloud instance before using your SaaS scenarios. Furthermore, you have 30 days to restart your instances or they will be deleted.
Please use the following links to find further information on the topics above: