Upload
vancong
View
274
Download
5
Embed Size (px)
Citation preview
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
Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web IDE on HANA Cloud
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:
Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web IDE on HANA Cloud
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:
Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web IDE on HANA Cloud
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
Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web IDE on HANA 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.
Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web IDE on HANA 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
Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web IDE on HANA Cloud
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)
Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web IDE on HANA Cloud
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
Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web IDE on HANA Cloud
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
Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web IDE on HANA Cloud
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
Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web IDE on HANA Cloud
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
Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web IDE on HANA Cloud
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
Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web IDE on HANA Cloud
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
Installing and Configuring the HANA Cloud Connector for On-premise OData Access Set up your SAP Web IDE on HANA Cloud
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