francois/hana1_tutorial
francois/hana1_tutorial
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

minor changes

Browse source
This commit is contained in:
Francois Beckers 2019-07-26 14:59:43 +02:00
parent d5a3137aa4
commit d56b305e80
2 changed files with 47 additions and 48 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

59
TUTO_01.md
View file

@ -6,15 +6,15 @@ This guide will describe how to create an account on HANA Trial website, install
### 1.1.1. Account creation ### 1.1.1. Account creation
Create an account on this website : https://account.hanatrial.ondemand.com and choose Neo Trial to create an HANA 1 trial tenant. 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.
![](pics/scp_01.png) ![scp](pics/scp_01.png)
### 1.1.2. HANA tenant creation ### 1.1.2. HANA tenant creation
Go to the "Databases & Schemas" area in the left menu. Go to the "Databases & Schemas" area in the left menu.
![](pics/scp_02.png) ![scp](pics/scp_02.png)
And create a new tenant (several minutes). And create a new tenant (several minutes).
@ -23,7 +23,7 @@ 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... - 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 - activate the DP Servert
![](pics/tenant_creation.png) ![tenant](pics/tenant_creation.png)
## 1.2. Development environment ## 1.2. Development environment
@ -35,8 +35,8 @@ Even if theoricaly it's possible to only use the Worbench editor, I highly sugge
You will need 2 files from SAP Download center (you must be logged on SAP website) : 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 - 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 - 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 Copy both file on your harddrive and use sapcar to extract HANA Studio
@ -48,11 +48,11 @@ Then, go inside the extracted directory `SAP_HANA_STUDIO` and the run the instal
Use the default settings (see below) Use the default settings (see below)
![](pics/hdbinst_settings.png) ![hdbinst](pics/hdbinst_settings.png)
Then, run HANA Studio and update it to the latest version. Then, run HANA Studio and update it to the latest version.
![](pics/hana_studio_01.png) ![hana_studio](pics/hana_studio_01.png)
#### 1.2.1.2. Install the SCP plugin #### 1.2.1.2. Install the SCP plugin
@ -64,15 +64,15 @@ Go in `Install new software...` and click on ADD button to add repositories.
Add the following list : Add the following list :
- Hana Neon : https://tools.hana.ondemand.com/neon/ - Hana Neon : [https://tools.hana.ondemand.com/neon/](https://tools.hana.ondemand.com/neon/)
- Hana Oxygen : https://tools.hana.ondemand.com/oxygen/ - Hana Oxygen : [https://tools.hana.ondemand.com/oxygen/](https://tools.hana.ondemand.com/oxygen/)
- Hana Mars : https://tools.hana.ondemand.com/mars/ - Hana Mars : [https://tools.hana.ondemand.com/mars/](https://tools.hana.ondemand.com/mars/)
![](pics/hana_studio_02.png) ![hana_studio](pics/hana_studio_02.png)
And then, install the `SAP Cloud Platform Tools for Connecting to SAP HANA Systems` plugin. And then, install the `SAP Cloud Platform Tools for Connecting to SAP HANA Systems` plugin.
![](pics/hana_studio_03.png) ![hana_studio](pics/hana_studio_03.png)
#### 1.2.1.3. HANA Studio connection to SCP #### 1.2.1.3. HANA Studio connection to SCP
@ -80,23 +80,23 @@ Now, we need to add the newly created tenant in HANA Studio.
Click on `Add Cloud System` Click on `Add Cloud System`
![](pics/hana_studio_04.png) ![hana_studio](pics/hana_studio_04.png)
Enter your Hana Trial Account credentials. Enter your Hana Trial Account credentials.
![](pics/hana_studio_05.png) ![hana_studio](pics/hana_studio_05.png)
Select the tenant newly created and enter the tenant credentials entered in a previsous step. Select the tenant newly created and enter the tenant credentials entered in a previsous step.
![](pics/hana_studio_06.png) ![hana_studio](pics/hana_studio_06.png)
The first time you will login, you will need to change the password. The first time you will login, you will need to change the password.
![](pics/hana_studio_07.png) ![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. When all the steps are done, you should see the tenant online (green bullet) in the left panel list.
![](pics/hana_studio_08.png) ![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. 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.
@ -106,20 +106,20 @@ HANA Studio is now installed, configured and connected, but we will also need th
To access the Workbench editor, go back to the `Databases & Schemas area` To access the Workbench editor, go back to the `Databases & Schemas area`
![](pics/scp_03.png) ![scp](pics/scp_03.png)
Enter the tenant Enter the tenant
![](pics/scp_04.png) ![scp](pics/scp_04.png)
And then, you have access to the 4 tools : And then, you have access to the 4 tools :
- Editor : to edit all kind of artifacts (calculation views, replication tasks, XSJS, ....) - Editor : to edit all kind of artifacts (calculation views, replication tasks, XSJS, ....)
- Catalog : the SQL/Runtime tool, to query and browser Schemas, tables, remote sources, ... - Catalog : the SQL/Runtime tool, to query and browse Schemas, tables, remote sources, ...
- Security : to manage Users and Roles - Security : to manage Users and Roles
- Trace : logs and traces - Trace : logs and traces
![](pics/workbench_01.png) ![workbench](pics/workbench_01.png)
## 1.3. Initial landscape ## 1.3. Initial landscape
@ -131,33 +131,32 @@ You need to access the HANA Lifecyle Management to install the initial roles lan
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. 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.
![](pics/security_halm_perm_01.png) ![halm](pics/security_halm_perm_01.png)
Then, in SCP, go to the HANA Cockpit dashboard Then, in SCP, go to the HANA Cockpit dashboard
![](pics/scp_04.png) ![scp](pics/scp_04.png)
And then, go to the HANA Lifecycle Management And then, go to the HANA Lifecycle Management
![](pics/cockpit_01.png) ![cockpit](pics/cockpit_01.png)
And finaly, go to the Delivery Unit area And finaly, go to the Delivery Unit area
![](pics/HALM_01.png) ![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) 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)
![](pics/HALM_02.png) ![halm](pics/HALM_02.png)
It should look like this after the import : It should look like this after the import :
![](pics/HALM_03.png) ![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. 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 To proceed, go to HANA Studio with the `SYSTEM` user in the security area
![](pics/security_halm_perm_02.png) ![halm](pics/security_halm_perm_02.png)
You are now with the minimal landscape to begin any development on HANA :) You are now with the minimal landscape to begin any development on HANA :)

36
TUTO_02.md
View file

@ -16,7 +16,7 @@ Let's call it MyFirstPackage.
Create a package named `MyFirstPackage` inside `MyHANA` Create a package named `MyFirstPackage` inside `MyHANA`
![](pics/myfirstpackage_apercu_01.png) ![apercu](pics/myfirstpackage_apercu_01.png)
### 1.1.2. Roles ### 1.1.2. Roles
@ -28,7 +28,7 @@ In this guide, we will always segregate roles in 3 categories : `admin`, `develo
So let's create a specific package named `roles` inside `MyFirstPackage` So let's create a specific package named `roles` inside `MyFirstPackage`
![](pics/myfirstpackage_apercu_02.png) ![apercu](pics/myfirstpackage_apercu_02.png)
#### 1.1.2.2. Define the roles #### 1.1.2.2. Define the roles
@ -40,13 +40,13 @@ Create 3 files (in text mode) named inside the package `roles`:
- `dev.hdbrole` - `dev.hdbrole`
- `user.hdbrole` - `user.hdbrole`
![](pics/myfirstpackage_apercu_03.png) ![apercu](pics/myfirstpackage_apercu_03.png)
##### 1.1.2.2.1. Admin role ##### 1.1.2.2.1. Admin role
Copy/Paste this code to the file `admin.hdbrole` Copy/Paste this code to the file `admin.hdbrole`
``` ```js
role MyHANA.MyFirstPackage.roles::admin role MyHANA.MyFirstPackage.roles::admin
{ {
package MyHANA.MyFirstPackage: REPO.READ, REPO.ACTIVATE_NATIVE_OBJECTS, REPO.MAINTAIN_NATIVE_PACKAGES, REPO.ACTIVATE_IMPORTED_OBJECTS, REPO.MAINTAIN_IMPORTED_PACKAGES; package MyHANA.MyFirstPackage: REPO.READ, REPO.ACTIVATE_NATIVE_OBJECTS, REPO.MAINTAIN_NATIVE_PACKAGES, REPO.ACTIVATE_IMPORTED_OBJECTS, REPO.MAINTAIN_IMPORTED_PACKAGES;
@ -57,7 +57,7 @@ package MyHANA.MyFirstPackage: REPO.READ, REPO.ACTIVATE_NATIVE_OBJECTS, REPO.MAI
Copy/Paste this code to the file `dev.hdbrole` Copy/Paste this code to the file `dev.hdbrole`
``` ```js
role MyHANA.MyFirstPackage.roles::dev role MyHANA.MyFirstPackage.roles::dev
{ {
package MyHANA.MyFirstPackage: REPO.READ, REPO.EDIT_NATIVE_OBJECTS, REPO.ACTIVATE_NATIVE_OBJECTS, REPO.MAINTAIN_NATIVE_PACKAGES, REPO.EDIT_IMPORTED_OBJECTS, REPO.ACTIVATE_IMPORTED_OBJECTS, REPO.MAINTAIN_IMPORTED_PACKAGES; package MyHANA.MyFirstPackage: REPO.READ, REPO.EDIT_NATIVE_OBJECTS, REPO.ACTIVATE_NATIVE_OBJECTS, REPO.MAINTAIN_NATIVE_PACKAGES, REPO.EDIT_IMPORTED_OBJECTS, REPO.ACTIVATE_IMPORTED_OBJECTS, REPO.MAINTAIN_IMPORTED_PACKAGES;
@ -68,7 +68,7 @@ package MyHANA.MyFirstPackage: REPO.READ, REPO.EDIT_NATIVE_OBJECTS, REPO.ACTIVAT
Copy/Paste this code to the file `user.hdbrole` Copy/Paste this code to the file `user.hdbrole`
``` ```js
role MyHANA.MyFirstPackage.roles::user role MyHANA.MyFirstPackage.roles::user
{ {
package MyHANA.MyFirstPackage: REPO.READ; package MyHANA.MyFirstPackage: REPO.READ;
@ -81,7 +81,7 @@ The roles are now defined in HANA, but we still need to assign them to users.
In HANA Studio, with the `SYSTEM` user, assign the role `MyHANA.MyFirstPackage.roles::admin` to your SHINE User. In HANA Studio, with the `SYSTEM` user, assign the role `MyHANA.MyFirstPackage.roles::admin` to your SHINE User.
![](pics/myfirstpackage_roles_01.png) ![roles](pics/myfirstpackage_roles_01.png)
## 1.2. Create schema ## 1.2. Create schema
@ -93,7 +93,7 @@ First, we will create a specific package for all datasources related artifacts :
So let's create a package named `datasources` in `MyFirstPackage` So let's create a package named `datasources` in `MyFirstPackage`
![](pics/myfirstpackage_apercu_04.png) ![apercu](pics/myfirstpackage_apercu_04.png)
### 1.2.2. Schema creation ### 1.2.2. Schema creation
@ -101,11 +101,11 @@ We will now create a hdbschema artifact in order to create a schema in HANA.
Create a new file named `myfirstschema.hdbschema` in `datasources` packages Create a new file named `myfirstschema.hdbschema` in `datasources` packages
![](pics/myfirstpackage_apercu_05.png) ![apercu](pics/myfirstpackage_apercu_05.png)
And copy/paste this in this file And copy/paste this in this file
``` ```js
schema_name="myfirstschema"; schema_name="myfirstschema";
``` ```
@ -115,7 +115,7 @@ We now need to add roles for the schema too.
If you check on HANA Studio, you will notice you can't access the newly created schema. If you check on HANA Studio, you will notice you can't access the newly created schema.
![](pics/myfirstschema_schema_creation_01.png) ![schema](pics/myfirstschema_schema_creation_01.png)
Again, we will follow the same structure, with 3 kind of users : `admin`, `developer` and `user` Again, we will follow the same structure, with 3 kind of users : `admin`, `developer` and `user`
@ -131,7 +131,7 @@ Create 3 files (in text mode) named inside the package `datasources`:
Copy/Paste this code to the file `admin.hdbrole` Copy/Paste this code to the file `admin.hdbrole`
``` ```js
role MyHANA.MyFirstPackage.datasources::admin role MyHANA.MyFirstPackage.datasources::admin
{ {
catalog schema "myfirstschema": SELECT, CREATE ANY, CREATE TEMPORARY TABLE, ALTER, DROP, EXECUTE, INSERT, UPDATE, DELETE, INDEX, TRIGGER, DEBUG, REFERENCES, SELECT METADATA, SELECT CDS METADATA; catalog schema "myfirstschema": SELECT, CREATE ANY, CREATE TEMPORARY TABLE, ALTER, DROP, EXECUTE, INSERT, UPDATE, DELETE, INDEX, TRIGGER, DEBUG, REFERENCES, SELECT METADATA, SELECT CDS METADATA;
@ -142,7 +142,7 @@ catalog schema "myfirstschema": SELECT, CREATE ANY, CREATE TEMPORARY TABLE, ALTE
Copy/Paste this code to the file `dev.hdbrole` Copy/Paste this code to the file `dev.hdbrole`
``` ```js
role MyHANA.MyFirstPackage.datasources::dev role MyHANA.MyFirstPackage.datasources::dev
{ {
catalog schema "myfirstschema": SELECT, CREATE ANY, CREATE TEMPORARY TABLE, ALTER, EXECUTE, INSERT, UPDATE, DELETE, INDEX, TRIGGER, DEBUG, REFERENCES, SELECT METADATA, SELECT CDS METADATA; catalog schema "myfirstschema": SELECT, CREATE ANY, CREATE TEMPORARY TABLE, ALTER, EXECUTE, INSERT, UPDATE, DELETE, INDEX, TRIGGER, DEBUG, REFERENCES, SELECT METADATA, SELECT CDS METADATA;
@ -153,7 +153,7 @@ catalog schema "myfirstschema": SELECT, CREATE ANY, CREATE TEMPORARY TABLE, ALTE
Copy/Paste this code to the file `user.hdbrole` Copy/Paste this code to the file `user.hdbrole`
``` ```js
role MyHANA.MyFirstPackage.datasources::user role MyHANA.MyFirstPackage.datasources::user
{ {
catalog schema "myfirstschema": SELECT, SELECT METADATA, SELECT CDS METADATA; catalog schema "myfirstschema": SELECT, SELECT METADATA, SELECT CDS METADATA;
@ -174,7 +174,7 @@ In the package MyFirstPackage.roles, open the file `admin.hdbrole`
And extend the role in the header like this : And extend the role in the header like this :
``` ```js
role MyHANA.MyFirstPackage.roles::admin extends role role MyHANA.MyFirstPackage.roles::admin extends role
MyHANA.MyFirstPackage.datasources::admin MyHANA.MyFirstPackage.datasources::admin
{ {
@ -188,7 +188,7 @@ In the package MyFirstPackage.roles, open the file `dev.hdbrole`
And extend the role in the header like this : And extend the role in the header like this :
``` ```js
role MyHANA.MyFirstPackage.roles::dev extends role role MyHANA.MyFirstPackage.roles::dev extends role
MyHANA.MyFirstPackage.datasources::dev MyHANA.MyFirstPackage.datasources::dev
{ {
@ -202,7 +202,7 @@ In the package MyFirstPackage.roles, open the file `user.hdbrole`
And extend the role in the header like this : And extend the role in the header like this :
``` ```js
role MyHANA.MyFirstPackage.roles::user extends role role MyHANA.MyFirstPackage.roles::user extends role
MyHANA.MyFirstPackage.datasources::user MyHANA.MyFirstPackage.datasources::user
{ {
@ -218,4 +218,4 @@ Go back in HANA Studio with you SHINE User and refresh the catalog area.
If everything is fine, you should see this : If everything is fine, you should see this :
![](pics/myfirstschema_schema_creation_02.png) ![schema](pics/myfirstschema_schema_creation_02.png)