--- parser: v2 auto_validation: true time: 20 tags: [tutorial>beginner, software-product>sap-business-technology-platform, software-product>sap-btp--cloud-foundry-environment] primary_tag: software-product>sap-integration-suite author_name: Melanie Cueppers author_profile: https://github.com/MelanieCueppers slug: cp-starter-isuite-onboard-subscribe canonical_url: https://developers.sap.com/tutorials/cp-starter-isuite-onboard-subscribe --- # Set Up SAP Integration Suite Trial Get onboarded to SAP Integration Suite trial account. ## Prerequisites You've created a **trial account on SAP Business Technology Platform:** [Get a Free Trial Account on SAP BTP](hcp-create-trial-account) ## You will learn - How to start your SAP Integration Suite trial - How to subscribe to the service and assign user roles - How to provision and activate the capabilities ## SAP Integration Suite SAP Integration Suite combines the integration capabilities such as Cloud Integration (Process Integration), API Management, Integration Advisor, Trading Partner Management, Integration Assessment, and Open Connectors into a cohesive and simplified toolkit for enterprise integrations. To provide a comprehensive integration experience, these services are not available separately, but only as part of SAP Integration Suite. SAP Integration Suite includes all integration capabilities in simple service plans. To learn more on these plans, see [Integration Suite](https://discovery-center.cloud.sap/#/serviceCatalog/integration-suite/?region=all&tab=service_plan) service catalog. This part of the mission lets you experience few capabilities offered by SAP Integration Suite. For the complete mission, see [Request Product Details with an Integration Scenario](mission.cp-starter-integration-cpi). > **IMPORTANT**: Trial accounts are not intended for productive usage or team development. If you're using SAP Integration Suite from a production account for your proof of concepts or real-time business cases, refer to the [product documentation](https://help.sap.com/docs/integration-suite) on SAP Help Portal for step-by-step explanation of the initial set up and further information. > **Remember** This tutorial is applicable only if you want to set up SAP Integration Suite for the use case covered in the mission [Request Product Details with an Integration Scenario](https://developers.sap.com/mission.cp-starter-integration-cpi.html). If you like to do a general set up of SAP Integration Suite or cover other use cases, then the steps mentioned here might not be exactly applicable. For general set up, refer to [Subscribing and Configuring Initial Access to SAP Integration Suite](https://help.sap.com/docs/integration-suite/sap-integration-suite/subscribing-to-integration-suite) and [Activating and Managing Capabilities](https://help.sap.com/docs/integration-suite/sap-integration-suite/activating-and-managing-capabilities). ## The Use Case Using this scenario, you design and execute an integration flow that reads product details from a public product catalog (`WebShop`) for a given product identifier. Product details include data such as the product name and price, for example. To accomplish the scenario, you use the SAP Integration Suite capabilities *Cloud Integration* and *API Management*. You use *Cloud Integration* to design and deploy an integration flow. Then, you use *API Management* to expose the integration flow endpoint as an API. - You define how to access the API in terms of authentication by assigning a dedicated predefined policy template. - Using this policy template, you define API access based on the OAuth client credentials grant method. - Finally, you invoke the API and get the product details in a response. ![Use case](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/cp-starter-isuite-onboard-subscribe/1-Set-up-integration-trial.png) ### Enter your trial account >**WHERE TO START**: > - **Are you new to SAP BTP Trial?** - skip the rest of the note and continue with this tutorial. > - You already have a SAP BTP trial account but new to SAP Integration Suite: > - If you have already activated Cloud Integration (Process Integration) or API Management services in a subaccount: - **Option 1**: Create a **`New Subaccount`** and then proceed to **Step 2** of this tutorial. For a new subaccount, you must assign entitlements by adding service plans and the quotas. For more information, see [Configure Entitlements and Quotas for Subaccounts](https://help.sap.com/viewer/ea72206b834e4ace9cd834feed6c0e09/Cloud/en-US/c90f3d522ee04e65bd87cdec8808e5ce.html). - **Option 2**: To continue with an existing subaccount, unsubscribe from Cloud Integration and API Management services, and then proceed to **Step 2**. > - If you've already subscribed to SAP Integration Suite in your existing trial account, proceed to **Step 3**. You can consume only oneSAP Integration Suite tenant per trial account. 1. In your web browser, open the [SAP BTP trial cockpit](https://cockpit.hanatrial.ondemand.com/). Select the **Singapore - Azure** region. ![Trial Region selection](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/cp-starter-isuite-onboard-subscribe/2-3-Screenshot_AP21.png) 2. Navigate to the trial global account by choosing **Go To Your Trial Account**. ![Trial global account](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/cp-starter-isuite-onboard-subscribe/2-2-FoundationsCockpit_trial page.png) 3. From your global account page, choose the appropriate subaccount's tile to navigate. ![Access Trial account](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/cp-starter-isuite-onboard-subscribe/2-5-access_trial_account.png) ### Subscribe to the service 1. Select **Services** > **Instances and Subscriptions**. 2. Choose **Create**. ![Instances & Subscriptions](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/cp-starter-isuite-onboard-subscribe/3-2-Instances&Subscriptions.png) 3. In the **New Instance or Subscription** dialog, choose **Integration Suite** from the list of services. >If SAP Integration Suite is not visible in the **Services** list, you need to assign SAP Integration Suite Trial entitlements. To assign entitlements, see [Manage Entitlements on SAP BTP Trial](cp-trial-entitlements). >- In the tutorial referred above, after **Step 3.5**, there is a list of available services on the left pane. >- Filter for SAP Integration Suite service and select the service. >- Select the service plan, add it to your subaccount, and continue with this tutorial. 4. Choose the default plan, **trial**, and then choose **Create**. You're now subscribed to the service. ![Create Subscription](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/cp-starter-isuite-onboard-subscribe/3-4-Create_Subscription.png) 5. Select **Security** > **Users**. Choose the entry against your name. In the **Role Collections** section, select the Three-Dot-Icon and choose **Assign Role Collection**. ![Assign Roles](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/cp-starter-isuite-onboard-subscribe/3-6-Assign-Roles.png) 6. In the dialog that appears, select **Integration_Provisioner**. Choose **Assign Role Collection**. ![Assign Role Collection](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/cp-starter-isuite-onboard-subscribe/3-7-Assign-Role-Collection.png) 7. Go back to **Instances and Subscriptions**. Select **Integration Suite**. Click **Go to Application** in the **Integration Suite** overview page. Now you are directed to the SAP Integration Suite home page. >If you don't have access to the page, log out of SAP Integration Suite, then log in again. ![Assign Role Collection](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/cp-starter-isuite-onboard-subscribe/3-8-Go-to-Application.png) ### Activate the capabilities >**IMPORTANT**: Ensure that you unsubscribe from the standalone services (like Cloud Integration, or API Management) if you've already subscribed to them in the same subaccount. If a standalone subscription exists, you'll be unable to activate the respective capability using SAP Integration Suite. >**Navigational Steps**: Go to **Instances and Subscriptions** and delete the subscriptions. 1. On the SAP Integration Suite home page, choose **Add Capabilities** to activate the capabilities offered by SAP Integration Suite. ![Integration suite launchpad](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/cp-starter-isuite-onboard-subscribe/4-1-isuitenewlaunchpage.png) For this tutorial, you must select the **Build Integration Scenarios** and **Manage APIs** capabilities. Choose **Next**. ![Add Capabilities](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/cp-starter-isuite-onboard-subscribe/4-1-Addcapapbilities.png) You do not have to select anything here. Choose **Next**. ![Intermediate Step](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/cp-starter-isuite-onboard-subscribe/4-1-CPI_step.png) Select the **Developer Hub** checkbox. Choose **Next**. ![API management](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/cp-starter-isuite-onboard-subscribe/4-1-API_step_2.png) 2. Choose **Activate** to provision the selected capabilities. >For some capabilities, you can select additional functionalities that you need to choose based on your business requirement. ![Activate capabilities](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/cp-starter-isuite-onboard-subscribe/4-2-Activate_capabilities.png) The activation takes a while to complete. >**IMPORTANT**: Before you proceed, please wait for the capabilities to be activated. They're activated once you can see the respective capability tiles on your home screen. You might need to refresh the browser. ![Activation dialog](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/cp-starter-isuite-onboard-subscribe/4-2-Activation.png) >To access the features of each capability, you must first assign capability-specific roles, which is explained in the next step. ### Automatically assign roles and create service instances using booster >**NOTE**: Due to technical limitations, boosters currently only work for subaccounts located in the **Singapore region**. Using subaccounts located in other regions can lead to errors when using Boosters. **See also step 1 of this tutorial**. In this step, you execute a booster that will assign you the necessary roles to access and use the activated capabilities, and create service instance of SAP Process Integration Runtime. A **booster** is a set of guided and interactive steps that enable you to select, configure, and consume services on SAP BTP to achieve a specific technical goal. In this case, the Integration Suite booster will help you with assigning roles and creating service instances. A **service instance** defines how a service of SAP BTP (in our case, **SAP Process Integration Runtime** service) can be called from a remote component. In the context of SAP Integration Suite, a service instance is the definition of an OAuth client. The service key generated out of the service instance contains credentials and other information that is required at a later step to call the integration flow. 1. Navigate to the overview page of your SAP BTP global account. 2. Choose **Boosters** on the left navigation pane. 3. From the list of boosters, look out for the tile **Enable Integration Suite** under the **Integration** section. You can start the booster execution by choosing **Start** on the tile. ![Booster Tile](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/cp-starter-isuite-onboard-subscribe/5-3-Booster-Tile.png) Alternatively, you can open the tile, read the information, and choose **Start** in the booster page. ![Booster Tile](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/cp-starter-isuite-onboard-subscribe/5-3-Booster-Overview.png) 4. In the **Configure Subaccount** tab, select your subaccount, organization, and space in which you have subscribed to SAP Integration Suite. Choose **Next**. ![Configure Subaccount](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/cp-starter-isuite-onboard-subscribe/5-4-Conf-subaccount.png) 5. In the **Select Activated Capabilities** tab, select **Design, Develop, and Operate Integration Scenarios** and **Design, Develop, and Manage APIs**. Choose **Next**. ![Select Capabilities](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/cp-starter-isuite-onboard-subscribe/5-5-Select-Capabilities.png) >**IMPORTANT**: Make sure that you select only the capabilities that you activated in step 3. 6. In the **Review** tab, check your selections and choose **Finish**. You can see that the booster is being processed. ![Booster Progress](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/cp-starter-isuite-onboard-subscribe/5-6-Booster-Progress.png) 7. Upon successful execution of the booster, choose **Go to Application**. Also, choose **Access Service Instance(s)** to view the service instance and service key. ![Booster Success](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/cp-starter-isuite-onboard-subscribe/5-7-Booster-Success.png) You can also manually do the role assignment and service instance creation without using the booster. For more information, see [Configure User Access](https://help.sap.com/docs/cloud-integration/sap-cloud-integration/configuring-user-access-to-application) and [Create Service Instances](https://help.sap.com/viewer/368c481cd6954bdfa5d0435479fd4eaf/Cloud/en-US/883f025c30a64373b4e4102238a39fd4.html). ### Verify the activated capabilities Refresh the SAP Integration Suite home page to see that capability-specific menu items were added to the left navigation. ![Activated Capabilities](https://raw.githubusercontent.com/sap-tutorials/btp-adai/main/tutorials/cp-starter-isuite-onboard-subscribe/6-2-Verifycapabilities.png) ---