SAP Cloud Connector

How-To Guide

Provided by SAPs Technology RIG

Installing and Configuring the HANA Cloud

Connector for On-premise OData Access

Applicable Releases:
HANA Cloud Connector 2.x
Version 1.0 - March 2015

Installing and Configuring the HANA Cloud Connector for On-premise OData Access

Document History
Document Version

Authored By

Description

1.0

Technology RIG

First release of this guide

Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web
IDE on HANA Cloud

TABLE OF CONTENTS
1.

Business Scenario ............................................................................................................................ 4

2.

Background Information .................................................................................................................. 4

3.

Prerequisites ................................................................................................................................... 5

4.

Step-by-Step Procedure ................................................................................................................... 6

4.1 Installing the HANA Cloud Connector ................................................................................................. 6
4.1.1
Linux Installation .......................................................................................................................... 6
4.1.2
Windows Installation ................................................................................................................... 7
4.2 Initial configuration of the HANA Cloud Connector ............................................................................ 9
4.3 Configure backend connections in the HANA Cloud Connector ........................................................ 11
4.4 Connecting remote systems in the Hana Cloud Platform ................................................................. 14

Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web
IDE on HANA Cloud

1.

BUSINESS SCENARIO

SAP HANA Cloud connector is an on premise agent that runs in the customer network and takes care of
securely connecting cloud applications, running on SAP HANA Cloud Platform, with services and systems of
the customer network. It is used to implement hybrid scenarios, in which cloud applications require point-topoint integration with existing services or applications in the customer network.

2.

BACKGROUND INFORMATION

In this How-To Guide we will see how to install and configure the SAP Hana Cloud Connector to connect
your Hana Cloud Platform account to the backend systems that provide the data for your applications. The
SAP HANA Cloud Platform is the in-memory Platform-as-a-Service offering from SAP, which enables
customers and developers to build, extend, and run applications on SAP HANA in the cloud. With flexible
subscription models and optional services for apps, database, and infrastructure, it provides instant access
to the full power of SAP HANA.
This is the landscape model for the HCP connecting to your backend systems:

Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web
IDE on HANA Cloud

3.

PREREQUISITES

You need a valid account on the https://account.hanatrial.ondemand.com portal in order to follow

the steps shown in this guide:

Be sure to have your Internet browser up to date.

Hardware prerequisites, physical or virtual machine:

Memory: minimum 1 GB RAM, 4 GB recommended
Hard disk space: minimum 1 GB, recommended 20 GB
CPU: minimum single core 3 GHz, dual core 2 GHz recommended\
Operating System requirements:

Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web
IDE on HANA Cloud

4.

STEP-BY-STEP PROCEDURE

This is the overall sequence of steps:

1)
2)
3)
4)

4.1

Download and Install the HANA Cloud Connector(Linux or Windows)

Log onto the HANA Cloud Connector and configure it to talk to HANA Cloud Platform
Configuring the HANA Cloud Connector Connect to remote systems
Connecting Hana Cloud Platform to remote backend systems

Installing the HANA Cloud Connector

...

The cloud connector can run on Linux, Windows or the Mac OS operating systems. Below are the steps
needed to install on the Linux and Windows OS. The configuration steps below that are the same no matter
which platform you decide to install the Cloud Connector.

4.1.1

Linux Installation

Choos e the menu option Fil e -> New -> Pr ojec t

1. Download the Linux .zip HANA Cloud connector file from the link
https://tools.hana.ondemand.com/#cloud

2. Once downloaded, unzip the connector and move the resulting folder in a suitable place on your local
machine
3. Go inside the extracted connector directory

4. Run the file go.sh

Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web
IDE on HANA Cloud

5. When the Connector is installed and started you should see the osgi> prompt

When the installation is completed, continue to the Initial Configuration section of this document
Should you need to close the connector, you can simply type close in this console and the connector
will be closed
4.1.2

Windows Installation

Choos e the menu option Fil e -> New -> Pr ojec t

1. Download the Windows .msi HANA Cloud connector file from the link
https://tools.hana.ondemand.com/#cloud

2. Put the installation file on the server were it is to be installed and execute the .msi file to start the
installer wizard
3. Once the wizard starts, click the Next button to start the installation process.

Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web
IDE on HANA Cloud

4. Specify the path where you want the software installed.

5. Specify the secure port to use for the Cloud Connector.

6. Choose whether or not you want to the system to automatically start the cloud connector

Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web
IDE on HANA Cloud

7. Confirm the start of the installation by clicking the Next button

When the installation is completed, continue to the Initial Configuration section of this document
4.2

Initial configuration of the HANA Cloud Connector

1. Open browser and go to the link https:// <server name>:<secure port> (e.g. https://localhost:8443)
2. If you get the following error, click on Advanced. This error comes because you dont have yet any
valid certificate for this localhost server

3. Click on Proceed to localhost (unsafe)

Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web
IDE on HANA Cloud

4. Enter these credentials and click on Login

User Name

Password

Administrator

manage

5. Choose Master as the installation type since this is your first time you are installing the product and
this is the only SAP HANA Cloud Connector in your system. Click on Apply

6. The first time you log in, you need to change the password. Do it and click on Save

7. Connect to your Hana Cloud Platform account. Provide the following initial configuration and click on
Apply. Proxy information is only needed if you are in a network that requires a proxy to communicate
to the internet, like for example the inside your corporate network.
Parameter

Value

Landscape Host

hanatrial.ondemand.com

Account Name

<your account name on the landscape host>. It can be found on the top
left corner of your SAP HANA Cloud Cockpit

User Name

<your user name on the landscape host> (for the trial account it is your

10

Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web
IDE on HANA Cloud

SCN Use-id)

4.3

Password

<your password> (for the trial account it is your SCN password)

HTTPS Proxy Host

only if required (for SAP users is proxy)

HTTPS Proxy Port

only if required (for SAP users is 8080)

Configure backend connections in the HANA Cloud Connector

1. The connector is configured and connected to the Hana Cloud Platform. Now we need to add some
connections with the backend systems. Click on Access Control

11

Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web
IDE on HANA Cloud

2. Click on Add in the Mapping Virtual to Internal System section

3. Enter the following information and click on Save. What you are doing in this step is to assign to a real
backend system a virtual name. In this way you can decouple the cloud based application from the
backend infrastructure. You can also create a virtual port, which of course can be different from the
real one
Parameter

Description

Virtual Host

Host name you will reference in your Hana Cloud application

Virtual Port

Port number you will reference in your Hana Cloud application

(It does not have to be the same as the actual port.)

Internal Host

The actual back end system host you will be connecting to

Internal Port

The actual back end port number host you will be connecting to

Protocol

Connection protocol (e.g. http, https)

Back-end Type

Type of backend system ( e.g. ABAP System, Gateway, etc.)

Example settings:

4. Now you need to add all the resources related to the usages you want to have available to your
application. These resources are the paths to be concatenated with the server URL in order to have

12

Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web
IDE on HANA Cloud

the complete paths to the resources. You just need to add the common part (the server name and the
port) in the system mapping and all the different paths in the table of the accessible resources
This is the list of some of the available resources that you can add:
Usage

Path

Description

odata_abap

/sap/opu/odata

for the OData functionality of Gateway

odata_gen

for generic OData functionality (service

URL must be provided manually in the
New Project wizard)

ui5_execute_abap

/sap/bc/ui5_ui5

dev_abap

/sap/bc/adt

for executing SAPUI5 applications from

the SAPUI5 ABAP Repository
for extensibility scenarios and
developing or deploying to SAPUI5
ABAP Repository

bsp_execute_abap

/sap/bc/bsp

For fact sheets

odata_xs

/sap/hba

For HANA XS Odata services

plugin_repository

/plugins/pluginrepository

for exposing external plugin repositories

5. Example of adding a resource: /sap/opu/odata

So click on Add in the Resources section

6. Add the resource and click on Save

Parameter

Value

URL Path

/sap/opu/odata

Access Policy

Path and all sub-paths

13

Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web
IDE on HANA Cloud

7. At the end you should have something that looks like this configuration

8. Completing the back end configuration your SAP HANA Cloud connector has been properly configured
if the status is green and its connected

9. You have successfully installed and configured your SAP HANA Cloud Connector.
4.4

Connecting remote systems in the Hana Cloud Platform

...

Now that your SAP HANA Cloud Connector is configured with a virtual server pointing to a given real server.
You now have to point to the virtual server you have created and its mappings to it all the related resources
on the Hana Cloud Platform. You are going to setup, in the SAP HANA Cloud Cockpit, a new destination:
this destination will give you access to the backend systems through the Cloud Connector.
These are the actions to perform in order to configure this destination:
Choos e the menu option Fil e -> New -> Pr ojec t

1. From the HANA Cloud cockpit click on the left side on the link Destinations

14

Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web
IDE on HANA Cloud

2. Click on New Destination

3. Enter the following parameters and click on Save

Parameter

Value

Name

Connection name

Type

Type of connection (e.g. http, rfc)

Description

A description of the connections

URL

The virtual URL you defined in the cloud connector (e.g.

https://gm6.virtual:44333)

ProxyType

Type of proxy to use (e.g. OnPremise)

Authentication

Authentication type ( e.g. NoAuthentication

4. When finished click on Save

15

Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web
IDE on HANA Cloud

5. At the end you should have the following configuration:

That concludes the setup and configuration of the Hana Cloud Connector

16

www.sap.com

2015 SAP SE. All rights reserved.

SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP
BusinessObjects Explorer, StreamWork, SAP HANA, and other SAP
products and services mentioned herein as well as their respective
logos are trademarks or registered trademarks of SAP AG in Germany
and other countries.
Business Objects and the Business Objects logo, BusinessObjects,
Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, and
other Business Objects products and services mentioned herein as
well as their respective logos are trademarks or registered trademarks
of Business Objects Software Ltd. Business Objects is an SAP
company.
Sybase and Adaptive Server, iAnywhere, Sybase 365, SQL
Anywhere, and other Sybase products and services mentioned herein
as well as their respective logos are trademarks or registered
trademarks of Sybase Inc. Sybase is an SAP company.
Crossgate, m@gic EDDY, B2B 360, and B2B 360 Services are
registered trademarks of Crossgate AG in Germany and other
countries. Crossgate is an SAP company.
All other product and service names mentioned are the trademarks of
their respective companies. Data contained in this document serves
informational purposes only. National product specifications may vary.
These materials are subject to change without notice. These materials
are provided by SAP AG and its affiliated companies ("SAP Group")
for informational purposes only, without representation or warranty of
any kind, and SAP Group shall not be liable for errors or omissions
with respect to the materials. The only warranties for SAP Group
products and services are those that are set forth in the express
warranty statements accompanying such products and services, if
any. Nothing herein should be construed as constituting an additional
warranty.