Technical Articles
SAP Cloud Platform Backend service: Tutorial [0.1]: Preparation
You’ve reached a blog that contains nothing than appendixes…
If you’ve reached it coincidentally, make sure to leave and reach any other more meaningful blog
I’ve you want to prepare yourself for using the SAP Cloud Platform Backend service, then you’ve reached the perfectly wonderful place
You can learn how to sign up for a free cloud account
You can learn how to enable “Beta” features, required for using Backend service (currently)
You can learn how to start using Backend service
APPENDIX 1: Reach the cloud
This chapter is required for those of you who don’t have a Trial account in the SAP Cloud Platform yet.
Go to http://cloudplatform.sap.com
Click on “Free Trial” in the upper right corner
Enter the required information, an (existing) email address, a name, a password, etc
Press “Submit”
Then go to that email account to confirm the registration
You’ve received a friendly email from SAP, click the confirmation link, then you receive a friendly welcome dialog
Take a note of your new User ID, it should look like “P1234567890”
Then click on the button to start your new trial
Congratulations, you’re in the cloud !
Now you might ask: “which cloud”?
You’re right, in our case we need to describe one more step:
The SAP Cloud Platform Backend service is available in the Cloud Foundry environment
So you can go ahead and make sure to strongly click on “Cloud Foundry Trial”
But don’t be disappointed if the next screen is not as friendly as you’re used to:
You need to explicitly “start” the Cloud Foundry Trial
This means that the cloud foundry container is deployed for your user and mapped to the cloud platform artifacts, meaning that in your subaccount you can access the “Organization” and “Space”, which are generated for you.
You can safely click on “ok” and watch the generation process which should take only short while.
After all generation steps are done, you can click on “Go to Space”
A “Space” in Cloud Foundry is the place where you deploy your applications and where you consume cloud services.
These services are offered by the SAP Cloud Platform, for example database as a service, destination service, and others
OK, but for our tutorial, we don’t need any of these services, so you might wish to look around, then come back and continue our tutorial.
APPENDIX 2: Reach the beta features
This chapter is due to the current situation:
SAP Cloud Platform Backend service is only available as “beta” feature, currently.
As such, it is not available as per default, “beta” features need to be explicitly enabled.
You can check if this chapter is relevant for you, as follows:
Go to the cloud (e.g. your Trial account: https://account.hanatrial.ondemand.com)
Go to your Subaccount and click on “Subscriptions” in the navigation pane.
On the right side, among the list of tiles, you should see the SAP Cloud Platform Backend service
If you can see it like in the screenshot, no matter if it is “not Subscribed), then you can skip this chapter:
If you’re now reading these lines, you need to enable beta features.
Beta features are maintained on S.ubaccount level.
But since an existing Subaccount cannot be modified, we have to create a new one.
Proceed as follows:
Login to SAP Cloud Platform and go to “Cloud Foundry Trial”
You’re taken to your global trial account where you can see the existing 1 Subaccount.
Press “New Subaccount”
Enter a name of your choice, e.g. BetaSubaccount, and make sure to tick the “Enable beta features” checkbox.
Before pressing the “Ceate” button, you should read the warning which is given when clicking the “information” icon.
For your own safety, I repeat the text here:
“Enables the use of beta features, services, and applications in this subaccount. You cannot disable this setting once you have enabled it. You should avoid using beta functionality in subaccounts used in a production environment. SAP shall not be liable for any errors or damage arising from the use of such features.”
OK, now you’re prepared to press “Create”.
After creation, you can see that it is not only named BetaSubaccount, but in fact it realls is a BETA enabled Subaccount:
Now go into the new Subaccount and click “Subscriptions” on the navigation pane.
Now you can see the entry SAP Cloud Platform Backend service in the list of subscriptions
APPENDIX 2b: Reach the Subscription
If you don’t see the tile in the “subscriptions” list:
Probably you have to configure the “Entitlements”
- Go to your global account, e.g. P123456789trial
- Click on Entitlements in the left menu pane
- Click on Entity Assignments
- Select in SubAccounts in the DropDownbox e.g. ‘Trial’
- Click on ‘Go’
- Click on ‘Configure’
- Afterwards one click on “Add Service Plans”
- In the dialog you can search for “Backend Service”
- Enable checkbox (Available service plans)
If the allowed service plan is grayed-out, then you might need to remove quota from other subaccount.
In productive environment: purchase more quota - Click on Button ‘Add 1 ServicePlan’
- Don’t forget to click on ‘save’
- Go back to the “Subscriptions”: now you should see the Tile
APPENDIX 3: Reach the Backend service
This chapter takes you by the hand and accompanies you to your SAP Cloud Platform Backend service
In order to use the Backend service, you need to subscribe to it.
Subscribe to SAP Cloud Platform Backend service
If you’re not already in the cloud, enter the following URL in your preferred browser:
https://account.hanatrial.ondemand.com
enter your preferred credentials to log on to your preferred trial account.
Navigate to your BetaSubaccount.
In the navigation pane, click on “Subscriptions”
In the list of subscriptions, find the SAP Cloud Platform Backend service
It looks like this:
You need to “Subscribe” in order to use it.
So take a breath and click on the tile.
In the overview screen, click on Subscribe, it doesn’t hurt.
After a while, the subscription should be successfully processed.
Note:
Currently, there might be an issue with refresh of the processing state, so if you think anything is wrong, you might try to go back to the list of “Subscriptions” and check the status there. Also, there you find a link “Go to Application”
After clicking on “Go to Application” a new browser tab is opened and welcomes you friendly to enter your user credentials.
Note:
You have to enter your user MAIL, not the user ID
Now the SAP Cloud Platform Backend service cockpit is loading and displays…..
….an error message…;-(
This is the first welcome page that doesn’t sound as friendly as we’re used to…;-(
But don’t be disappointed: there’s a solution.
You user needs the required authorization, that’s all
Configure roles for your user
This is done as follows:
Backend service provides a few specific roles.
These need to be assigned to your user.
There’s a separate blog that explains about the Backend service specific roles:
https://blogs.sap.com/2019/01/25/sap-cloud-platform-backend-service-tutorial-0.2-roles-configuration/
That’s it.
Now you can access the Backend service.
Go back to your “beta”-enabled Subaccount -> Subscriptions->Backend service->Go to Application
Note:
If you still get the unfriendly youdonothavesufficientauthorization screen…
Don’t panic !
Don’t click on the “Help”-link (it won’t help)
Don’t continue hitting refresh
You can try to log off and log in
Or reload the browser, I mean REALLY reload
E.g. by closing and reopening
Then navigate to the Backend service
You should get the logon screen
Afterwards you should be really able to log on
If you’re still unable…then …. You can at least look at my screenshot…
It looks like this:
Finally we’ve reached the end of the journey of preparing to use the SAP Cloudplatform Backend service
Now you may go ahead and start playing with it.
And now it would be a good moment to take a break and afterwards continue reading and following my blogs
Note:
If you want to call your APIs from external application, you need to do some more preparation steps in order to realize OAuth 2.0 authorization flow
Hi Carlos Roggan,
After creating a subaccount with Beta features, I don't find SAP Backend Service in the subscription list. Can you please help me with this
Thanks in advance.
Seema
Hi Seema Diwakar Nimje ,
you're right, this has changed, you now have to configure entitlements.
How to do that?
I've described it in another blog:
https://blogs.sap.com/2019/11/25/using-job-scheduler-in-sap-cloud-platform-0-intro-and-prep/#entitlements
Kind Regards,
Carlos
Thanks Carlos Roggan. I will look into the blog.
Hello
I registered a new subaccount with the BETA version, but I cannot find either SAP Cloud Backend Service or Job Scheduler in the subscriptions / marketplace
Didn't find it in the marketplace
Hello Sergei Belyakov ,
sorry for the outdated information. You're right, both services are not available on Trial anymore.
My apologies for inconvenience and the frustrating search!
How then can you go through this tutorial? Our organization has a paid Neo cloud
Oh, NEO is a different environment. The Backend Service is a service in Cloud Foundry (as mentioned above)
Okay
Tell me then please, is it possible to go through your tutorials somehow through the trial version? Or do you need to pay for cloud foundry?
Please note that BackendService is not released (GA) yet.
Hi Carlos
Can we achieve the versioning via mta.yaml or package.json.
I have a sample application deployed to cf. Can you please let me know how do i achieve api versioning concept from program point, without using any cloud services.
Hi
Can we achieve this via mta.yml or package.json.
i have deployed a sample application in cf and want to have 2 different version for same api running parallely.
Hi Avijit,
different versions of API are expressed in the URL, with param, as far as I remember, e.g. /;v=2/
so it shouldn't be a problem to address those 2 versions from same application or from 2 different apps.
Please refer as well to PN message exchange.
Kind Regards,
Carlos
Hello @Carlos Roggan
I have registered a new subaccount with the BETA version, but I cannot find either SAP Cloud BackendService or Job Scheduler in the subscriptions / marketplace
Using CPI Cloud Foundry Environment trail account May you please help how to proceed further, Thank You!
Regards,
Uday.
@Carlos Roggan Thank You for the blog , but unable to find SAP Cloud Backend Service or Job Scheduler in the subscriptions / marketplace May you please help how to proceed further in trail cloud foundry environment .
Regards,
Uday.