installing and configuring the hana cloud connector … · installing and configuring the hana...

SAP Cloud Connector How-To Guide

Provided by SAP’s 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

2

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

3

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


4

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-to-point 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:


5

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:


6

4. STEP-BY-STEP PROCEDURE

This is the overall sequence of steps:

1) Download and Install the HANA Cloud Connector(Linux or Windows) 2) Log onto the HANA Cloud Connector and configure it to talk to HANA Cloud Platform 3) Configuring the HANA Cloud Connector Connect to remote systems 4) Connecting Hana Cloud Platform to remote backend systems

4.1 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 Choose 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

https://tools.hana.ondemand.com/#cloud


7

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

Choose 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.

https://tools.hana.ondemand.com/#cloud


8

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


9

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 don’t have yet any valid certificate for this localhost server

3. Click on Proceed to localhost (unsafe)

https://localhost:8443/


10

4. Enter these credentials and click on Login

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

User Name Password

Administrator manage


11

SCN Use-id)

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”)

4.3 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


12

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


13

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 for executing SAPUI5 applications from the SAPUI5 ABAP Repository

dev_abap /sap/bc/adt 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


14

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 it’s 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: Choose the menu option Fil e -> New -> Pr ojec t

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


15

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


16

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

That concludes the setup and configuration of the Hana Cloud Connector

© 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.

www.sap.com

installing and configuring the hana cloud connector … · installing and configuring the hana...

Documents