This tutorial guides you through the steps to deploy and configure the sample application in a dedicated BTP subaccount, representing an end-to-end provisioning process of a single-tenant partner application in a customer BTP account.
You can use the sample application author-readings provided in this Github repository, or your own version of the sample application that you created following the tutorial "Build a full-stack BTP Application with One-off Deployment in a Customer BTP Account".
In this chapter we start the tutorial by setting up a BTP provider subaccount.
We use this subaccount to host the SAP Business Application Studio (BAS), which we are using to clone and deploy the sample app (in real life you may have a development subaccount for this purpose, but we are using the same subaccount for simplicity), and to host the sample application runtime.
-
Open the BTP Cockpit and create a new Multi-Environment-Subaccount with name "AuthorReadings" and provider Amazon Web Services (AWS).
-
BTP Cockpit (global account level): Assign the following entities to the subaccount:
- SAP Business Application Studio (BAS), service plan standard-edition (Application)
- Cloud Foundry Runtime (3 units)
- SAP HANA Cloud
- SAP HANA Schemas & HDI Containers
- SAP Build Work Zone, standard edition, service plan standard
- SAP Event Mesh, service plan Default
- SAP Event Mesh, service plan Standard (Application)
- Auditlog Service, service plan standard
- Audit Log Viewer Service, service plan default (Application)
-
BTP Cockpit (subaccount level): Enable Cloud Foundry using the proposed standard settings and:
Property Value Environment: Cloud Foundry Runtime Plan: standard Landscape: choose an appropiate AWS landscape Instance Name: authorreadings Org Name: authorreadings -
BTP Cockpit (subaccount level): Create a Cloud Foundry space with name
runtime. Keep standard roles and add the development user as CF org member and as CF space member. -
BTP Cockpit (subaccount level): Open the CF space and create a HANA database:
- Choose CF Organization + Space
- Instance Name:
authorreadings-db
-
BTP Cockpit (subaccount level): Navigate to the Service Marketplace and subscribe/create instances of the following entities:
- SAP Business Application Studio, service plan standard-edition (Application)
- Event Mesh, service plan Standard (Application).
- SAP Build Work Zone, standard edition, service plan standard
-
BTP Cockpit (subaccount level): Navigate to the Security > Users and assign the following role collections to the development user:
- All 3 roles of SAP Business Application Studio
- All role collections refering to the Event Mesh and Enterprise Messaging respectively
- Role collection Launchpad_Admin
- Role collection AuditLog
BTP Cockpit (subaccount level): Navigate to Instances and Subscriptions, open the SAP Business Application Studio and create a new Dev Space with kind Full Stack Cloud Application.
Start and open the BAS dev space and use the tile "Clone from Git" on the Welcome-view to clone this GitHub repository (https://github.com/SAP-samples/sme-partner-reference-application).
Build and deploy your application:
-
Open a new terminal and login to cloud foundry: Run command
cf login, enter your development user/password and select the BTP provider subaccount for the application. -
Navigate to the sub-folder with the sample application using command
cd Applications/author-readings. -
Run command
npm installto install the messaging npm packages. -
Build the project by selecting
Build MTA Projectin the context menu of filemta.yaml. -
Deploy the application by selecting
Deploy MTA Archivein the context menu of file./mta_archives/author-readings_1.0.0.mtar.
Observe, that the message client authorreadings is now available in the event mesh application.
Note: The first deployment of the application with the event mesh creates event mesh artifacts (message client, queue and service instance) and may take some time (very likely more than 10 minutes).
Create and configure the message client for outbound messages of the BTP app as described in chapter Configure the message client for outbound messages.
Create and configure the message client for ByD as described in chapter Create the message client for ByD.
Configure ByD to emit event notifications for projects as described in chapter Configure ByD to emit event notifications for projects.
Create and configure a launchpad site as described in chapter Configure the Launchpad.
Note: SAP Build Work Zone has already been subscribed in chapter "Setup BTP Subaccount".
Setup trust between the BTP subaccount and the SAP Identity Authentication Service and setup end user authorizations following the steps in chapter Configure Authentication and Authorization.
BTP subaccount: Open menu item Role Collections and add the user group Author_Reading_Admin additionally to the role collections:
- Enterprise Messaging Administrator
- Enterprise Messaging Developer (required to test event notifications and to review the data payload of event notifications)
- AuditLog
- Launchpad_Admin
Configure single sign-on in ByD using the SAP Identity Authentication Service as identity provider as decribed in chapter Configure Single Sign-on for ByD.
Expose ByD projects as OData services by following the steps in chapter Configure ByD OData Services.
Setup destinations in the BTP subaccount to connect the BTP app with the ByD tenant. Follow the steps in chapter Setup Destinations to connect to ByD.
Add relevant BTP applications to the ByD launchpad as described in chapter Add BTP Applications to the ByD Launchpad.