Prepare for SAP BTP Development

You need an SAP BTP account to deploy the services and applications.

In general, you have a choice of the following alternative options:

Trial: (recommended) Use a trial account if you just want to try out things
and don’t want to use any of the parts of this tutorial productively. The usage
is free of cost and all the services that you need for this tutorial get
automatically assigned to your trial account.

Create a Trial Account

Use a trial account if you just want to try out things and don’t want to use
any of the parts of this tutorial productively. Alternatively, if you’re planning
to use this tutorial productively, skip this step and proceed with Step 3:
Create a Live Account below.

You can register for a trial account or access your existing trial account.

When creating a trial account, a global account, a subaccount, a Cloud

Foundry org, and space with some entitlements are set up for you. This
setup is sufficient to do the tutorial.

Continue with Step 8: Check and assign entitlements below.

(Alternative) Create a Live Account

If you just want to try out things and don’t want to use any of the parts of
this tutorial productively, skip this step and go to Step 2: Create a Trial
Account above.There are multiple live landscapes available in different data
centers around the globe. Live landscapes are intended for productive usage
and development projects.

This file has been converted from its original format for security purposes. Please use C5F1F2D6D1A7C as a reference.
 If you choose to create an account on Live, you have to select a number of
services that you need to subscribe to, for example, an SAP HANA database.
For each service, there are so-called entitlements , which are basically the
service plans and the number of units that you want from each service.
When you create an account, you need to provide these also.

Create a subaccount

1. Enter your Global Account. If you are using a trial account, choose Go
To Your Trial Account.

2. Choose Account Explorer in the left navigation pane.

3. Choose Create → Subaccount.

4. To fill the New Subaccount dialog, enter a Display Name.

Use a short name for your project and add the prefix for the landscape,
for example: <project name>-cf-us10 . Don’t select the checkbox Neo!

5. Enter a subdomain.

Only valid HTTP domain characters are allowed.

6. Choose Create.

7. Wait for the completion of the subaccount creation.

8. Choose the tile with your new subaccount.

This file has been converted from its original format for security purposes. Please use C5F1F2D6D1A7C as a reference.
 Configure Cloud Foundry in your subaccount

This creates a Cloud Foundry (CF) 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.

1. Choose Enable Cloud Foundry.

2. Change the default value for Org Name as required and choose Create.

Create a Cloud Foundry space

Next to Cloud Foundry orgs there are also Spaces. Each Cloud Foundry org
can have 0 to n spaces, you create just one here.

1. Open the subaccount page in SAP BTP cockpit.

2. Choose Spaces in the left pane under the section Cloud Foundry.
3. Choose Create Space.
4. Enter a space name.

If different sub projects exist in the org, use <sub project name>-<stage
name> , otherwise use <stage name> ; where stage name is the release

stage, for example: dev , val , prod .

5. Choose Create.

(Optional) Check and assign users in the Cloud

Foundry space

This file has been converted from its original format for security purposes. Please use C5F1F2D6D1A7C as a reference.
 1. Open the Spaces overview in SAP BTP cockpit. You can just choose the
tile for the space that was created.
2. Choose Members in the left navigation pane. You’ll see your own user
that’s automatically assigned as Space Manager and Space Developer.
3. (Optional) Choose Add Members to add additional users as required.
Again, your own user should already be part of the list.
4. (Optional) Add a distribution list of your CFDeployment technical user as
Space Manager if you have one.

Check and assign entitlements

If you are using a trial account, the entitlements needed for this tutorial are
already assigned as part of the trial account creation process and you can
just double-check if everything is correct.

If you are using a live account, in this section you assign a portion of the
entitlements that you’ve bought for your global account to the individual
subaccounts. In this example, you have only one subaccount. However, if
you have 3 subaccounts, for example, and have bought 100 units of the
HTML5 service, you could assign 50 units to the first subaccount, 20 to the
second, and the remaining 30 to the third subaccount.

1. In your subaccount, choose Entitlements in the left-hand pane.

2. Choose Configure Entitlements.
3. Choose Add Service Plans.
4. Go through the Entitlements according to the table above and
check/add the required plans for each of them.
5. Choose the + or - symbol to change the quota for the services
according to the table.
6. Choose Save.

This file has been converted from its original format for security purposes. Please use C5F1F2D6D1A7C as a reference.
 Log on from the command line

Prepare for the next steps by logging on to Cloud Foundry and targeting your
space in the account.

If you don’t know whether you are logged on to Cloud Foundry or if you are
wondering to which Cloud Foundry org and space are you logged on, you can
always use cf target in a command line window to find out. If you aren’t
logged on already, go to your SAP BTP cockpit by using one of the following
links, depending on the landscape you want to deploy to:

https://cockpit.hanatrial.ondemand.com/

Make sure you’ve installed the Cloud Foundry CLI (as described in Step 6:
Install the Cloud Foundry command line interface) before proceeding with
the steps below.

1. Enter your Global Account. If you are using a trial account, choose Go
To Your Trial Account.

2. Choose Account Explorer.

3. In the Subaccounts tab, choose the subaccount to which you want to

deploy your service and application.

This file has been converted from its original format for security purposes. Please use C5F1F2D6D1A7C as a reference.
 4. On the subaccount page, gather all the data to log in to Cloud Foundry
(CF).

o API Endpoint

o Org Name

o Space Name

5. Open a command line window.

6. Set the Cloud Foundry API endpoint.

Shell/Bash

Copy

This file has been converted from its original format for security purposes. Please use C5F1F2D6D1A7C as a reference.
 cf api <API Endpoint of your landscape>

7. Log in to your Cloud Foundry account, using your SAP BTP credentials.

Shell/Bash

Copy
cf login

Create a Service Instance in SAP BTP

These three types of entities relate to the three types of SAP BTP offerings:

 If you want to consume a service, you create a service instance.

 If you want to use an environment, you create an environment

instance.

 If you want to consume an application, you create a subscription to

that application.

The creation process involves a wizard which you start from the Service
Marketplace page in the SAP BTP cockpit.

The location from which you access the marketplace is always a subaccount
for environment instances and subscriptions and a subaccount or Cloud
Foundry space for service instances.

In this tutorial, we’ll demonstrate how to create an instance from a

subaccount.

The main difference between the subaccount and the Cloud Foundry space is
that on the subaccount level, the services offered to you aren’t those that
are only available for the Cloud Foundry environment.

This file has been converted from its original format for security purposes. Please use C5F1F2D6D1A7C as a reference.
 For more information about these SAP BTP entities, see:

 Creating Service Instances

 Working with Environment Instances

 Subscribe to Multitenant Applications Using the Cockpit

Navigate to Service Marketplace

1. Starting from your global account, go to the subaccount in which you
want to create a service instance.

2. Select Services > Service Marketplace from the left-hand navigation

bar.

Find the service you want to consume

This file has been converted from its original format for security purposes. Please use C5F1F2D6D1A7C as a reference.
 All offerings that are available for consumption in your subaccount are shown
as tiles.

Select Services from the filter to get only the service tiles and find the
service you want to consume:

Create a service instance

1. You can get information about the selected service and the available
plans. Click on the tile. The page expands to show instance details,
such as its overview, available documentation, and service plans.

2. Click on Create in the upper-right corner.

This file has been converted from its original format for security purposes. Please use C5F1F2D6D1A7C as a reference.
 3. A wizard opens, offering you to configure your new instance.

Make sure to assign the correct plan to avoid creating (additional)

costs.

Enter the following information:

Parameter Description

Service This is where you select the name of the respective service with
which you want to work.

The Services list displays all three types of offerings: services,

environments, and applications from the service marketplace.

The technical name for each item is displayed on the right side of the
list. This is how services, environments, or applications are referred
to when using the supported APIs or commands for the SAP BTP
Command Line Interface (CLI). If an offering can be consumed
as both a service and an application, you’ll see two technical names
next to its commercial name.

This file has been converted from its original format for security purposes. Please use C5F1F2D6D1A7C as a reference.
 Parameter Description

Since you’ve already selected the service, this field is populated with
the desired value.

Select a service plan.

Every service has its own available plans. Aside from the information
about the plans you get from the service overview page in the SAP
BTP cockpit, you can also get more detailed information by
performing the following actions:

1. Go to SAP Discovery Center to obtain information on

which plans are available. To do so, search for the name of the
product you are interested in.
Plan
2. Select the tile of the product you are interested in.

3. From the available tabs, select Pricing. You can now see all
Service Plans available (such
as Free, Default / Standard or Trial service plans).

Important: If you want to experience SAP BTP without

generating cost, make sure to only enable services
with Free service plans.

As an example, see the screenshot below.

This file has been converted from its original format for security purposes. Please use C5F1F2D6D1A7C as a reference.
 4. Depending on the service and the plan you’ve selected, you will be
asked to add information on the runtime environment, spaces, and
the instance name.

5. You can either select Create or proceed to step 2 of the wizard.

Some services provide additional configuration parameters to define in

that step. Open the additional info next to Configure instance
parameters to get more information about the available parameters.
6. Select Create. If the creation was successful, the table will be updated
accordingly. Once the status bar has jumped
from Processing to Subscribed, you’ve successfully created a service
instance.

This process might take a moment or two.

Go to Instances and Subscriptions page

After you’ve successfully created your service instance, you can proceed by
clicking on Services > Instances and Subscriptions from the left-hand
navigation bar.

This file has been converted from its original format for security purposes. Please use C5F1F2D6D1A7C as a reference.
 This opens an overview page on which you can see all the existing instances
and subscriptions in your subaccount.

Clicking on the instance row opens an instance overview page to the right.

There, you can find more information about your instance.

This tutorial shows you how to create SAP BTP resources in a multi-
environment subaccount.

 True
 False

This file has been converted from its original format for security purposes. Please use C5F1F2D6D1A7C as a reference.