hana1_tutorial/TUTO_01.md

# 1. HANA - Getting started

This guide will describe how to create an account on HANA Trial website, install a working development environment and setup a minimal landscape to getting started smoothly.

## 1.1. SCP Trial

### 1.1.1. Account creation

Create an account on this website : [https://account.hanatrial.ondemand.com](https://account.hanatrial.ondemand.com) and choose Neo Trial to create an HANA 1 trial tenant.

![scp](pics/scp_01.png)

### 1.1.2. HANA tenant creation

Go to the "Databases & Schemas" area in the left menu.

![scp](pics/scp_02.png)

And create a new tenant (several minutes).

I suggest to :

- configure the SHINE User as it will install the SHINE Delivery Unit, which contains multiples examples of artifacts, views, and so on...
- activate the DP Servert

![tenant](pics/tenant_creation.png)

## 1.2. Development environment

Even if theoricaly it's possible to only use the Worbench editor, I highly suggest to install HANA Studio as it's clearly more reliable for modeling with Calculation views, ...

### 1.2.1. HANA Studio

#### 1.2.1.1. Download & Installation

You will need 2 files from SAP Download center (you must be logged on SAP website) :

- SAPCAR (SAR archive utility) to extract HANA Studio : [https://launchpad.support.sap.com/#/softwarecenter/search/sapcar](https://launchpad.support.sap.com/#/softwarecenter/search/sapcar)
- HANA Studio : [https://launchpad.support.sap.com/#/softwarecenter/search/IMC_STUDIO2_224](https://launchpad.support.sap.com/#/softwarecenter/search/IMC_STUDIO2_224)

Copy both file on your harddrive and use sapcar to extract HANA Studio

By example, on Windows :

`SAPCAR_1211-80000938.EXE -xvf IMC_STUDIO2_224_9-80000323.SAR`

Then, go inside the extracted directory `SAP_HANA_STUDIO` and the run the installer `hdbinst.exe`

Use the default settings (see below)

![hdbinst](pics/hdbinst_settings.png)

Then, run HANA Studio and update it to the latest version.

![hana_studio](pics/hana_studio_01.png)

#### 1.2.1.2. Install the SCP plugin

By default, HANA Studio can only connect to HANA on premise, so a plugin is required to connect.

First, you need to add additional repositories in HANA Studio.

Go in `Install new software...` and click on ADD button to add repositories.

Add the following list :

- Hana Neon : [https://tools.hana.ondemand.com/neon/](https://tools.hana.ondemand.com/neon/)
- Hana Oxygen : [https://tools.hana.ondemand.com/oxygen/](https://tools.hana.ondemand.com/oxygen/)
- Hana Mars : [https://tools.hana.ondemand.com/mars/](https://tools.hana.ondemand.com/mars/)

![hana_studio](pics/hana_studio_02.png)

And then, install the `SAP Cloud Platform Tools for Connecting to SAP HANA Systems` plugin.

![hana_studio](pics/hana_studio_03.png)

#### 1.2.1.3. HANA Studio connection to SCP

Now, we need to add the newly created tenant in HANA Studio.

Click on `Add Cloud System`

![hana_studio](pics/hana_studio_04.png)

Enter your Hana Trial Account credentials.

![hana_studio](pics/hana_studio_05.png)

Select the tenant newly created and enter the tenant credentials entered in a previsous step.

![hana_studio](pics/hana_studio_06.png)

The first time you will login, you will need to change the password.

![hana_studio](pics/hana_studio_07.png)

When all the steps are done, you should see the tenant online (green bullet) in the left panel list.

![hana_studio](pics/hana_studio_08.png)

You can repeat the same steps for the `SYSTEM` user, which is the only current user to have enough permissions to setup the initial landscape.

### 1.2.2. Workbench editor

HANA Studio is now installed, configured and connected, but we will also need the Workbench editor for many features, artifacts, and so on that are not supported in HANA Studio.

To access the Workbench editor, go back to the `Databases & Schemas area`

![scp](pics/scp_03.png)

Enter the tenant

![scp](pics/scp_04.png)

And then, you have access to the 4 tools :

- Editor : to edit all kind of artifacts (calculation views, replication tasks, XSJS, ....)
- Catalog : the SQL/Runtime tool, to query and browse Schemas, tables, remote sources, ...
- Security : to manage Users and Roles
- Trace : logs and traces

![workbench](pics/workbench_01.png)

## 1.3. Initial landscape

Like for any platform, we need to setup an initial landscape about roles and permissions (admin, dev, user, ...).

### 1.3.1. HANA Lifecyle Management

You need to access the HANA Lifecyle Management to install the initial roles landscape delivery unit.

In HANA Studio, with the user `SYSTEM`, go to the security area and give the role `sap.hana.xs.lm.roles::Administrator` to your SHINE User newly created.

![halm](pics/security_halm_perm_01.png)

Then, in SCP, go to the HANA Cockpit dashboard

![scp](pics/scp_04.png)

And then, go to the HANA Lifecycle Management

![cockpit](pics/cockpit_01.png)

And finaly, go to the Delivery Unit area

![halm](pics/HALM_01.png)

Click on Import and import the Delivery Unit : `MYHANA_ROLES_Francois-B-Makoto.tgz` available here : [MYHANA_ROLES_Francois-B-Makoto.tgz](download/MYHANA_ROLES_Francois-B-Makoto.tgz)

![halm](pics/HALM_02.png)

It should look like this after the import :

![halm](pics/HALM_03.png)

The roles are now activated in HANA, so you can add the newly imported Admin Role `MyHANA.00Security.MyHANA_roles.roles.admin::MyHANA_roles_admin` to your SHINE User.

To proceed, go to HANA Studio with the `SYSTEM` user in the security area

![halm](pics/security_halm_perm_02.png)

You are now with the minimal landscape to begin any development on HANA :)