|
| 1 | +--- |
| 2 | +title: Prepare for Deployment |
| 3 | +description: Learn how to set up the SAP BTP, Kyma runtime for deploying the application. |
| 4 | +parser: v2 |
| 5 | +auto_validation: true |
| 6 | +time: 30 |
| 7 | +tags: [ tutorial>beginner, software-product>sap-cap-operator--kubernetes-environment, topic>cloud-operations, software-product-function>sap-cloud-application-programming-model, programming-tool>node-js, software-product>sap-business-technology-platform, software-product>sap-btp--kyma-runtime] |
| 8 | +primary_tag: software-product>sap-cap-operator--kubernetes-environment |
| 9 | +author_name: Anirudh Prasad |
| 10 | +author_profile: https://github.com/anirudhprasad-sap |
| 11 | +--- |
| 12 | + |
| 13 | +## You will learn |
| 14 | + |
| 15 | +- How to configure entitlements. |
| 16 | +- How to enable the SAP BTP Kyma runtime in your subaccount in SAP BTP. |
| 17 | +- How to create an SAP HANA Cloud service instance in the SAP BTP cockpit. |
| 18 | +- How to enable the CAP Operator community module in your Kyma cluster. |
| 19 | + |
| 20 | +## Prerequisites |
| 21 | + |
| 22 | +- You have an [enterprise global account](https://help.sap.com/docs/btp/sap-business-technology-platform/getting-global-account#loiod61c2819034b48e68145c45c36acba6e) in SAP BTP. To use services for free, you can sign up for an SAP BTPEA (SAP BTP Enterprise Agreement) or a Pay-As-You-Go for SAP BTP global account and use the free tier services only. See [Using Free Service Plans](https://help.sap.com/docs/btp/sap-business-technology-platform/using-free-service-plans?version=Cloud). |
| 23 | +- You have a platform user. See [User and Member Management](https://help.sap.com/docs/btp/sap-business-technology-platform/user-and-member-management). |
| 24 | +- You're an administrator of the global account in SAP BTP. |
| 25 | +- You have a subaccount in SAP BTP to deploy the services and applications. |
| 26 | + |
| 27 | +> This tutorial follows the guidance provided in the [SAP BTP Developer's Guide](https://help.sap.com/docs/btp/btp-developers-guide/what-is-btp-developers-guide). |
| 28 | +
|
| 29 | +### Configure the entitlements |
| 30 | + |
| 31 | +To deploy the Incident Management sample application, you need the following entitlements: |
| 32 | + |
| 33 | +| Service | Plan | Quota required | |
| 34 | +| ------------- | :-----------: | ----: | |
| 35 | +| Kyma runtime | free (Environment) | 1 | |
| 36 | +| SAP HANA Cloud | hana-free | 1 | |
| 37 | +| SAP HANA Cloud | tools (Application) | 1 | |
| 38 | +| SAP HANA Schemas & HDI Containers | hdi-shared | 1 | |
| 39 | +| HTML5 Application Repository Service | app-host | 1 | |
| 40 | +| HTML5 Application Repository Service | app-runtime | 1 | |
| 41 | +| Destination Service | lite | 1 | |
| 42 | +| SaaS Provisioning Service | application | 1 | |
| 43 | +| Service Manager | container | 1 | |
| 44 | +| Authorization and Trust Management Service | broker | 1 | |
| 45 | + |
| 46 | +> You can find more information about entitlements in [Configure Entitlements and Quotas](https://help.sap.com/docs/btp/sap-business-technology-platform/configure-entitlements-and-quotas-for-subaccounts). |
| 47 | +
|
| 48 | +### Enable SAP BTP, Kyma runtime |
| 49 | + |
| 50 | +Let's enable your subaccount to use the SAP BTP, Kyma runtime. |
| 51 | + |
| 52 | +1. Navigate to your subaccount and choose **Enable Kyma** under the **Kyma Environment** tab. |
| 53 | + |
| 54 | + <!-- border; size:540px -->  |
| 55 | + |
| 56 | +2. In the **Enable Kyma** popup, change the values for **Instance Name** and **Cluster Name** as needed and choose **Create**. |
| 57 | + |
| 58 | + <!-- border; size:540px -->  |
| 59 | + |
| 60 | + > 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. |
| 61 | + > |
| 62 | + > 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. |
| 63 | + > |
| 64 | + > 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. |
| 65 | +
|
| 66 | + |
| 67 | +### Subscribe to SAP HANA Cloud Administration Tools |
| 68 | + |
| 69 | +1. Navigate to your subaccount and choose **Services** → **Service Marketplace** on the left. |
| 70 | + |
| 71 | +2. Type **SAP HANA Cloud** in the search box and choose **Create**. |
| 72 | + |
| 73 | + <!-- border; size:540px -->  |
| 74 | + |
| 75 | +3. In the **New Instance or Subscription** popup, select **tools** from the dropdown in the **Plan** field and choose **Create**. |
| 76 | + |
| 77 | + <!-- border; size:540px -->  |
| 78 | + |
| 79 | +4. Choose **View Subscription** and wait until the status changes to **Subscribed**. |
| 80 | + |
| 81 | + <!-- border; size:540px -->  |
| 82 | + |
| 83 | + <!-- border; size:540px -->  |
| 84 | + |
| 85 | +5. In your SAP BTP subaccount, choose **Security** → **Role Collections** in the left-hand pane. |
| 86 | + |
| 87 | +6. Choose role collection **SAP HANA Cloud Administrator**. |
| 88 | + |
| 89 | +7. Choose **Edit**. |
| 90 | + |
| 91 | + <!-- border; size:540px -->  |
| 92 | + |
| 93 | +8. In the **Users** section, enter your user and select the icon to add the user. |
| 94 | + |
| 95 | + <!-- border; size:540px -->  |
| 96 | + |
| 97 | + > Keep the `Default Identity Provider` setting unless you have a custom identity provider configured. |
| 98 | +
|
| 99 | +9. Choose **Save**. |
| 100 | + |
| 101 | + You've assigned the **SAP HANA Cloud Administrator** role collection to your user. |
| 102 | + |
| 103 | +> Log out and log back in to make sure your new role collection is considered. |
| 104 | +
|
| 105 | +### Create an SAP HANA Cloud service instance |
| 106 | + |
| 107 | +SAP HANA Cloud is used as a persistence layer. |
| 108 | + |
| 109 | +Follow these steps to create an SAP HANA Cloud service instance in the SAP BTP cockpit: |
| 110 | + |
| 111 | +1. In your SAP BTP subaccount, navigate to **Services** → **Instances and Subscriptions** in the left-hand pane. |
| 112 | + |
| 113 | +2. Choose **SAP HANA Cloud**. You're redirected to SAP HANA Cloud multi-environment administration tools. Sign in with your SAP BTP cockpit username/email if necessary. |
| 114 | + |
| 115 | + <!-- border; size:540px -->  |
| 116 | + |
| 117 | +3. In SAP HANA Cloud Central, choose **Create Instance**. |
| 118 | + |
| 119 | + <!-- border; size:540px -->  |
| 120 | + |
| 121 | +4. Choose *Confiure manually* as **Instance Configuration** and *SAP HANA Database* as **Instance Type**. Then, choose **Next Step**. |
| 122 | + |
| 123 | + <!-- border; size:540px -->  |
| 124 | + |
| 125 | +5. In the **Instance Name** field, enter *application-hana-instance*. |
| 126 | + |
| 127 | +6. In the **Administrator Password** and **Confirm Administrator Password** fields, enter a password for DBADMIN. Choose **Next Step**. |
| 128 | + |
| 129 | + <!-- border; size:540px -->  |
| 130 | + |
| 131 | +7. At **SAP HANA Database: Size and Availability**, choose **Next Step**. |
| 132 | + |
| 133 | +8. In **SAP HANA Database: Connections**, select the **All IP addresses** radio button, and choose **Next Step**. |
| 134 | + |
| 135 | + <!-- border; size:540px -->  |
| 136 | + |
| 137 | +9. At **SAP HANA Database: Advanced Settings**, choose **Next Step**. |
| 138 | + |
| 139 | +10. At **Data Lake: General**, choose **Review and Create**. |
| 140 | + |
| 141 | +11. Choose **Create Instance**. |
| 142 | + |
| 143 | +The creation of the database instance can take some minutes to complete. |
| 144 | + |
| 145 | +> Your SAP HANA Cloud service instance automatically stops overnight, according to the time zone of the region where the server is located. This means you need to restart your instance every day before you start working with it. |
| 146 | +
|
| 147 | +### Map your SAP HANA Cloud service instance to your Kyma cluster |
| 148 | + |
| 149 | +1. Go to SAP HANA Cloud Central. If you've closed it, open it again by following these steps: |
| 150 | + |
| 151 | + - In your SAP BTP subaccount, navigate to **Services** → **Instances and Subscriptions**. |
| 152 | + - Choose **SAP HANA Cloud**. You're redirected to SAP HANA Cloud multi-environment administration tools. Sign in with your SAP BTP cockpit username/email if necessary. |
| 153 | + |
| 154 | +2. For the **application-hana-instance** instance, choose **Manage Configuration**. |
| 155 | + |
| 156 | + <!-- border; size:540px -->  |
| 157 | + |
| 158 | +3. Select the **Instance Mapping** tab and choose **Add Mapping**. |
| 159 | + |
| 160 | + <!-- border; size:540px -->  |
| 161 | + |
| 162 | +4. Select **Kyma** from the dropdown under **Environment Type**. |
| 163 | + |
| 164 | +5. Under **Environment Instance ID**, paste the GUID of your Kyma cluster. Here's how to find it: |
| 165 | + |
| 166 | + - Open your Kyma dashboard. |
| 167 | + - Choose **Namespaces** on the left and choose **kyma-system**. |
| 168 | + - Navigate to **Configuration** → **Config Maps** and choose **sap-btp-operator-config**. |
| 169 | + - You can see the GUID of your Kyma cluster in the **CLUSTER_ID** section. |
| 170 | + |
| 171 | + <!-- border; size:540px -->  |
| 172 | + |
| 173 | + > If no namespace is provided, the instance is mapped to all namespaces in the cluster. |
| 174 | +
|
| 175 | +6. Choose **Review and Save**. In the popup, choose **Save Changes**. |
| 176 | + |
| 177 | + <!-- border; size:540px -->  |
| 178 | + |
| 179 | + You've mapped your SAP HANA Cloud service instance to your Kyma cluster. |
| 180 | + |
| 181 | + > For more information, see [Map an SAP HANA Database to another Environment Context](https://help.sap.com/docs/HANA_CLOUD/9ae9104a46f74a6583ce5182e7fb20cb/1683421d02474567a54a81615e8e2c48.html) to add a new Cloud foundry or Kyma mapping. |
| 182 | +
|
0 commit comments