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 Document History Document Version Authored By Description 1.0 Technology RIG First release of this guide 2
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 3
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: 4
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: 5
Choose the menu option Fil e -> New -> Pr oject Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web 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 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 6
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 oject 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. 7
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 8
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) 9
4. Enter these credentials and click on Login User Name Administrator Password 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 Landscape Host Account Name User Name Value hanatrial.ondemand.com <your account name on the landscape host>. It can be found on the top left corner of your SAP HANA Cloud Cockpit <your user name on the landscape host> (for the trial account it is your 10
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 11
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 Virtual Host Virtual Port Internal Host Internal Port Protocol Back-end Type Description Host name you will reference in your Hana Cloud application Port number you will reference in your Hana Cloud application (It does not have to be the same as the actual port.) The actual back end system host you will be connecting to The actual back end port number host you will be connecting to Connection protocol (e.g. http, https) 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
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 URL Path Access Policy Value /sap/opu/odata Path and all sub-paths 13
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 oject 1. From the HANA Cloud cockpit click on the left side on the link Destinations 14
2. Click on New Destination 3. Enter the following parameters and click on Save Parameter Name Type Description URL ProxyType Authentication Value Connection name Type of connection (e.g. http, rfc) A description of the connections The virtual URL you defined in the cloud connector (e.g. https://gm6.virtual:44333) Type of proxy to use (e.g. OnPremise) Authentication type ( e.g. NoAuthentication 4. When finished click on Save 15
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.