SAP HANA Cloud provisioning in Kyma Runtime Environment

[vishnu_vijayakrishnan]

In the earlier releases of SAP HANA Cloud, it was exclusively associated with Cloud Foundry runtime. Currently, SAP HANA Cloud currently supports Cloud Foundry, Kyma and also Runtime Independent provisioning of instances in SAP Business Technology Platform(BTP). In this blog we will be looking at the steps involved in provisioning and maintaining a SAP HANA Cloud instance in Kyma Runtime Environment.

Kyma is a Kubernetes based application runtime offered by BTP. It is based on modular building blocks, which contains the capabilities to run cloud-native applications. Every Kyma environment runs on a single Kubernetes cluster created specifically for your subaccount. Its environment consists of Kubernetes cluster based on project Gardener which sits on top of a cloud provider and data center of your choice. With the help of available modules, you can install the required modules to run your applications on the provisioned cluster.

Here, we will be focusing on the following areas: Prerequisites: Installing BTP Service Operator, Creating a SAP HANA Cloud Instance and Managing Instance in SAP HANA Cloud Central.

Note: 
Here I am considering that you already have an SAP BTP global account with a subaccount(Subaccount Administrator Role Collection should be present for your user in the subaccount) that has entitlements and quota for SAP HANA Cloud, including "hana" plan. If not, refer Getting a Global Account, View and Manage Services from the Service Marketplace, and Managing Entitlements and Quotas Using the Cockpit.

Prerequisites
Before we go ahead with HANA Cloud provisioning in Kyma, there are few prerequisite steps that needs to be addressed. Firstly, the Kyma runtime environment has to be enabled for your subaccount. Next, in order to access the Kyma dashboard and then to install modules, create service instances, service bindings etc., RBAC(roles-based access control) permissions are to be given to the user. Finally, the BTP Service Operator module needs to be installed in your cluster to create the Service Instances and Service Bindings.

Setup of Kyma environment:
To setup Kyma environment on your subaccount, follow the steps mentioned in Create the Kyma Environment Instance. Once the setup is done, you should be able to see the Kyma Environment in the Overview section of your Subaccount.

You can access the Kyma dashboard using the Console URL link in the Kyma Environment section.

Configuring Kubernetes RBAC:
In order to create Service Instances and Service Bindings, Role Based Access Control permissions should be configured for your user in the Kubernetes cluster. Follow the steps mentioned in Assign Roles in the Kyma Environment to configure the permissions.

Installing BTP Service Operator(BTP SO):
BTP Service Operator is a free and open source software developed by SAP. It helps in provisioning, binding instances by communicating with the Service Manager that uses the service broker API to communicate with the Service brokers. In SAP BTP Kyma runtime, the btp-operator module is available as part of Kyma modules. You can follow the below steps to enable btp-operator module.

Launch the Kyma dashboard by opening the Console URL link. In the home page, Select Modify Modules.

Select Edit --> Under Modules section, check the btp-operator module --> Click Save.

Go back to Home page of the Kyma Dashboard by selecting Back to Cluster Details, then select Namespaces --> default. You should be seeing the item Service Management  in side navigation  as shown below.

Now you can go ahead and start creating a SAP HANA Cloud instance. 

Creating a SAP HANA Cloud instance
In this section, we will be creating a HANA Cloud instance using the Service Instances(under Service Management) and also using the Upload YAML option.

Service Instances option:
Select Service Instances(under Service Management) --> Create
In the Create Service Instance section, provide the form details. The mandatory fields to be provided are for:
Name - Name of your HANA Cloud instance
Offering Name- Name of the service offering. In this case "hana-cloud"
Plan Name - Name of the service plan. In this case "hana"
Instance Parameters - Parameters required to create the instance. This has to be given in JSON format.
An example of the basic parameters is given below:

{
	"data": {
		"edition": "cloud",
		"memory": 32,
		"systempassword": "<give your password>"
		}
}

After giving the required details, select the Create option. You can check the status of the instance creation in Service Instances page. Also you can check under YAML  in Edit section to check the ongoing progress of the instance creation.

Upload YAML option:
We can also create HANA Cloud instance similar to the approach that we use for creating Kubernetes resources through YAML. Go to the Namespace Overview for default namespace. Select the Upload YAML option and provide the YAML content to create the HANA Cloud instance. Here is an example of the YAML data:

apiVersion: services.cloud.sap.com/v1
kind: ServiceInstance
metadata:
  name: yaml-inst
  labels:
    app.kubernetes.io/name: yaml-inst
    annotations: {}
    namespace: default
spec:
  serviceOfferingName: hana-cloud
  servicePlanName: hana
  parameters:
    data:
      edition: cloud
      memory: 32
      systempassword: <give your password here>

After entering the YAML content, Select Upload.

The status of the instance creation can be checked in the Service Instances page. 

Managing the Instance in SAP HANA Cloud central

Now the HANA Cloud instance is created successfully, you can perform Monitoring and Administration from SAP HANA Cloud Central. 

This blog covers the high-level overview of SAP HANA Cloud instance creation in Kyma runtime environment.  You can find more details in help guide: Help Documentation. In case you have any questions, please comment below.