How to setup HANA XS application

For delivery of HANA XS application standard delivery unit (DU) is used.

Prerequisites for installation

• access to an SAP HANA system
• assigned the SAP HANA sap.hana.xs.lm.roles::Administrator user role

1. Open HANA Application Lifecycle Management
   1. using link: http://<host_address>:80<instance_number>/sap/hana/xs/lm
      
      
2. Import Delivery Unit
   1. Navigate to Products → Delivery units
      
   2. Click Import and find delivery unit package in your file system
      
      
      
   3. Click Import and then confirm with import button
      
      
   4. Application is successfully imported
      

Create database users

For successful configuration two kind of users needs to be created. First user will be dedicated to connection from SAPUI5 application, second from indexing agent to SAP HANA XS server.

User roles

How to add destination to SAP Cloud 

1. Log in into your SAP Cloud platform account.
2. Create database user that will be used in destination and assign role 'dvd.filesearch.roles::user'
   1. Navigate to SAP HANA / SAP ASE → Databases & Schemas and chose dedicated database
   2. Click on SAP HANA Web-based Development Workbench
   3. Login with user with administrator rights
   4. Click on Security tile
   5. Right click on Users and chose New user
   6. Assign role 'dvd.filesearch.roles::user' to created user
   7. Set initial password
   8. Save user
   9. Log in with user and initial password and set production password
   10. User is ready to use for destination
3. Create new Destination to HANA XS server
   
   
4. Fill in all necessary connection details
   1. As authentication chose BasicAuthentication
      1. Use user and password that you created at beginning of this step list 

   2. add additional parameters:

      Parameter	Value
      odata_xs	/dvd/filesearch/

5. Check created Destination
   
   
   

How to import and setup SAPUI5 application to SAP Cloud platform

1. Log in into your SAP Cloud platform account.
2. Open SAP Web IDE
   Services → SAP Web IDE
   
3. Import file into SAP Web IDE
   
   1. Chose File → Import → From File System
      
   2. Find zip file with application and chose path where application should be imported
      
      
      
   3. After successful import new directory should be added into your SAP Web IDE
       
4. Deploy application
   1. Right click on root directory of imported application → Deploy → Deploy to SAP Cloud Platform
      
      
      
   2. Now you have to options:
      1. Deploy a new application (if you are doing initial setup)
         
         
         
      2. Update an existing application (if you are doing update of already deployed application)
         
         
         
   3. After successful deployment you will obtain link to application
      
5. Change default location of oData service for deployed application
   1. Return back to SAP Cloud platform Cockpit and navigate to HTML5 Applications
      Applications → HTML5 Applications
       
   2. Click on deployed application name and in application details change mapped Subaccount Destination to destination to HANA XS server setup-ed before and save
      
   3. Now your application should be fully working from link that you gather in this step list