Prepare for Deployment in the SAP BTP, Kyma Runtime

In this section, you set up the SAP BTP Kyma runtime for deploying CAP applications.

To deploy the Incident Management application, you need the following entitlements:

Do the following steps to add the entitlements.

1. Log in to the SAP BTP cockpit.

2. Navigate to your subaccount and choose Entitlements → Edit.

   

3. Choose Add Service Plans.

   

4. Search for Kyma Runtime and select the free (Environment) plan.

   

5. Search for SAP Build Work Zone, standard edition and select the free (Application) plan.

   

6. Search for SAP HANA Cloud and select the tools (Application) service plan and hana-free service plan.

   

7. Search for SAP HANA Schemas & HDI containers and select the hdi-shared service plan.

   

8. Search for Continuous Integration & Delivery, select the free (Application) plan, and choose Add 6 Service Plans.

   

9. Choose Save.

Let’s enable your subaccount to use the SAP BTP, Kyma runtime.

1. Navigate to your subaccount and choose Enable Kyma under the Kyma Environment tab.

   

2. In the Enable Kyma popup, change the values for Instance Name and Cluster Name as needed and choose Create.

   

   Make sure that the instance name is CLI-friendly. CLI-friendly names make it easier to manage your instances with the SAP BTP command-line interface as well.

   A CLI-friendly name is a short string (up to 32 characters) that contains only alphanumeric characters (A-Z, a-z, 0-9), periods, underscores, and hyphens. It can’t contain white spaces.

   When enabling the runtime, you notice that the instance name is generated automatically for you. You can use that name or replace it with the name of your choice.

1. Navigate to your subaccount and choose Services → Service Marketplace on the left.

2. Type SAP HANA Cloud in the search box and choose Create.

   

3. In the New Instance or Subscription popup, select tools from the dropdown in the Plan field and choose Create.

   

4. Choose View Subscription and wait until the status changes to Subscribed.

   

   

5. In your SAP BTP subaccount, choose Security → Role Collections in the left-hand pane.

6. Choose role collection SAP HANA Cloud Administrator.

7. Choose Edit.

   

8. In the Users section, enter your user and select the icon to add the user.

   

   Keep the setting Default Identity Provider unless you have a custom identity provider configured.

9. Choose Save.

   You’ve assigned the SAP HANA Cloud Administrator role collection to your user.

Log out and log back in to make sure your new role collection is considered.

SAP HANA Cloud is used as a persistence layer.

Follow these steps to create an SAP HANA Cloud service instance in the SAP BTP cockpit:

1. In your SAP BTP subaccount, navigate to Services → Instances and Subscriptions in the left-hand pane.

2. Choose SAP HANA Cloud. You’re redirected to SAP HANA Cloud multi-environment administration tools. Sign in with your SAP BTP cockpit username/e-mail if necessary.

   

3. In SAP HANA Cloud Central, choose Create Instance.

   

4. Choose SAP HANA Cloud, SAP HANA Database, and then choose Next Step.

   

5. In the Instance Name field, enter incident-management.

6. In the Administrator Password and Confirm Administrator Password fields, enter a password for DBADMIN. Choose Next Step.

   

7. The default settings are sufficient for the Incident Management application. Choose Next Step.

8. At SAP HANA Database Availability Zone and Replicas, choose again Next Step.

9. Select the Allow all IP addresses radio button, and choose Review and Create to review your SAP HANA Cloud instance configuration.

   

10. Choose Create Instance.

The creation of the database instance can take some minutes to complete.

Your SAP HANA Cloud service instance is automatically stopped overnight, according to the time zone of the region where the server is located. That means you need to restart your instance every day before you start working with it.

You need the SAP BTP Operator module to map your SAP HANA Cloud service instance to the Kyma cluster. The module is added by default when you enable the SAP BTP, Kyma runtime. Follow these steps to make sure it’s enabled:

1. Navigate to your subaccount and choose Dashboard URL under the Kyma Environment tab.

   

2. Choose Modify Modules.

3. Make sure that btp-operator is on the list. If not, choose Add. In the new window, check btp-operator, and choose Add.

You can find more info in Add and Delete a Kyma Module.

1. Go to SAP HANA Cloud Central. If you’ve closed it, open it again by following these steps:

   • In your SAP BTP subaccount, navigate to Services → Instances and Subscriptions.
   • Choose SAP HANA Cloud. You’re redirected to SAP HANA Cloud multi-environment administration tools. Sign in with your SAP BTP cockpit username/e-mail if necessary.

2. For the incident-management instance, choose Manage Configuration.

   

3. Select the Instance Mapping tab and choose Add Mapping.

   

4. Choose Kyma from the dropdown under Environment Type.

5. Under Environment Instance ID, paste the GUID of your Kyma cluster. Here’s how to find it:

   • Open your Kyma dashboard.
   • Choose Namespaces on the left and choose kyma-system.
   • Navigate to Configuration → Config Maps and choose sap-btp-operator-config.
   • You can see the GUID of your Kyma cluster in the CLUSTER_ID section.

   

   If no namespace is provided, the instance is mapped to all namespaces in the cluster.

6. Choose Review and Save. In the popup, mark Apply changes with a restart, and choose Save Changes.

   

   You’ve mapped your SAP HANA Cloud service instance to your Kyma cluster.

   For more information, see Map an SAP HANA Database to another Environment Context to add a new Cloud foundry or Kyma mapping.