Prepare for Deployment in the SAP BTP, Cloud Foundry Runtime

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

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

If you don’t have the entitlements added already, do the following steps to add them.

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 Cloud Foundry Environment 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 the 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.

Enabling the Cloud Foundry (CF) runtime creates a CF organization (org.) in your subaccount. There’s always one Cloud Foundry org. per subaccount. Later on, when you log on to Cloud Foundry, it asks you which Cloud Foundry org. you want to log on to. For any development in your subaccount, you need to choose this org. for your subaccount. If you don’t have a CF org. created in your subaccount already, do the following steps to create it.

1. Navigate to your subaccount and choose Enable Cloud Foundry.

   

2. In the Enable Cloud Foundry popup, change the values for Instance Name and Org 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.

3. Navigate to Cloud Foundry → Spaces and choose Create Space.

   

4. Enter a space name (for example, dev) and choose Create.

   

If you don’t have a subscription to SAP HANA Cloud already, do the following steps to subscribe.

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 Central. Sign in with your SAP BTP cockpit username/e-mail if necessary.

   

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

   

4. Select the Configure manually radio button, then select the Free Tier tab and make sure that the SAP HANA Database tab is selected. 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.

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 Cloud Foundry from the dropdown under Environment Type.

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

   • Open a new terminal in SAP Business Application Studio and log in with cf login.
   • Run the command cf org <Your-Cloud-Foundry-Org> --guid. You get the GUID of your Cloud Foundry organization in response.

   

   If you only specify the organization GUID, the instance is mapped to all spaces in that organization.

6. Choose Review and Save and then choose Save Changes in the popup.

   

   You’ve mapped your SAP HANA Cloud service instance to your Cloud Foundry organization.

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