You are on page 1of 26

SAP HANA CLOUD

INTEGRATION (HCI)
A Walkthrough with Demo (SOAP to SOAP Scenario)

NEHA VERMA
NOVEMBER 2015
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)

Author: Neha Verma

Designation: SAP PI Consultant

Declaration: I hereby declare that this document is based on my personal experiences. To the
best of my knowledge, this document does not contain any material that infringes the copyrights
of any other individual or organization including the customers of the org.

Project Details: PeroxyChem LLC

Target Readers: SAP XI/PI Developers, Consultants and SAP HCI Beginners.

Assumptions: It is assumed that the reader has a basic idea of PI development processes
including designing, configuration and monitoring. It is also assumed that the reader knows a
little bit about SAP HANA.

Objectives: The objective of this document is to provide the details of:

 SAP Hana Cloud Integration.


 How HCI is a different integration approach than PI.
 How to configure a simple SOAP to SOAP scenario in HCI using free trial option from
SAP.

Downloads Required: Please install below mentioned softwares before starting with the
walkthrough.

1. JDK - Install the latest version of JDK or look for JDK 7 from
www.oracle.com/technetwork/java/javase/downloads/index.html
2. Eclipse - Install Eclipse Luna from link. Choose 32 bit when asked. Then follow the
Installation Instructions from the same link.

3. SOAP - Install SOAP UI 4.0.1 or later version from


http://sourceforge.net/projects/soapui/files/soapui/4.0.1/

1
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)

Table of Contents
S.No Topic Page No.
1. Author Details & Pre-requisites 1
2. Introduction 3
3. HCI – Step Wise Walkthrough 5
4. Testing the scenario 24
5. Points to Remember 25

2
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)

Introduction
Hana Cloud integration allows you to securely integrate your applications with SAP and non-SAP
systems with the promise of cloud computing benefits. The integration technology offers process
and data integration features on a multitenant cloud infrastructure.

SAP Hana Cloud integration is a relatively new product of SAP and provide pre delivered
integration content to integrate SuccessFactors, Ariba, SAP Financial Services and SAP Cloud for
Customer with on-premise systems such as SAP ECC and SAP CRM. HCI now also provides
integration development platforms and allow customers to develop their own integration
scenarios. This is similar to what we have been doing in SAP Process orchestration to achieve our
integration needs but with a client supported integration server.

For HCI however, not only standard content but also the management and monitoring of this
integration content is offered by SAP. SAP is therefore responsible for the hosting, configuration
and monitoring of integration scenarios. This involves a new service offering for which
interaction with SAP customers is very important. It relieves the customer of hosting,
configuration and monitoring of the integration environment.

SAP Cloud
Applications

SAP HANA Cloud Integration

Real Time Data Prepacked Community


Process Integration Integration and Market
Integration flows Place

SAP 3rd Party 3rd Party Cloud


On- On- Solution
Premise Premise

3
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)
Below are the key benefits and features of SAP HCI:

 Cloud-based technology
 Real-time, bi-directional process integration
 Data integration
 Graphical flows & mappings
 Centralized monitoring and administration
 Pre-built adapters
 Compatible with SAP NetWeaver PI content (e.g. mappings) and SAP Data Services
(planned)
 Lower cost of change over time

SAP HANA Cloud Integration and how it compares with SAP NetWeaver PO

HANA Cloud Integration SAP NetWeaver Process


(HCI-PI) Integration & Orchestration
Deployment Cloud based service offering On-premise installation in customer
hosted by SAP Landscape
Responsibility of configuration & Responsibility of configuration &
operations: SAP operations: Customer
Supported Application Edition, FSN “Unlimited” (any-to-any)
scenarios Platform edition: integration scenarios
Planned for A2A, B2B, ...
2014
License model Subscription fee Product license & annual fees
Architecture Virtualization, multi Single tenant solution, no built-in
tenancy, data isolation virtualization capabilities
Automated failover Failover to be configured by
Rolling software update Customer nZDM for SP / EHP
updates
Prepackaged Prepackaged content available Prepackaged content available for a
content for selected SAP Cloud solutions wide variety of on premise SAP/non
SAP applications
Operations Operations by SAP Cloud Operations by customer
Managed Services Integration with SAP Solution
Integrated with Service Provider Manager
Cockpit Local monitors
Local monitors

*Please check the referenced links at the end of the document for more information on HCI.

4
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)

HCI – Step Wise Walkthrough

SAP is providing webinar series and hands-on sessions free of cost to advertise their product. We
can also take the advantage of these trainings and learn how HCI works.

I have already contacted SAP for hands-on trial session and successfully completed it. To make it
more simple and quick for all of you, I have documented the necessary steps required to configure
a scenario in HCI.

Besides some downloads mentioned earlier in this document, you need to know/setup few
other things as well before you start working on HCI:

1. You must have an s-user id. Kindly check with Basis team and get your s-user created for
your IBM email address if you don’t have one.

2. Then you need to drop a mail to hci.trial@sap.com requesting participation in SAP HCI trial
phase.

3. Once you get reply from SAP, they will ask for your s-user id and based on that they will
proceed further. Next steps include access to IBM jam folder, tenant* details and access
(Node to configure in Eclipse), and documentation.

4. To avoid repeat logon to SAP sites, it is suggested that you add the SAP passport* in your
browser which will also help to generate the SSL certificates. To install the SAP passport
for single sign on, follow the steps here: https://websmp107.sap-
ag.de/~sapidp/011000358700002939642002E

Generating SSL certificates from Firefox:

You use this procedure to create SSL key pair - a public certificate and a private key for SSL
communication in HCI.

 Open the Firefox browser.


 Go to Tools > Options > Advanced > Certificates > View Certificates > Select the SAP
Passport CA and Via the Backup button save the key.

Next open the certificate via View button and go to the Details tab and copy the file.
The certificate with .cer extension is the Public certificate and the certificate with .p12 extension
is the private key.

 Open the jam folder.


 Create a new folder with your s-user id and save the public certificate.
 Keep the private key with you. It would be needed in SOAP UI to trigger a message.

5
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)

Steps in Snapshots

6
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)

7
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)

Public Certificate

Private Key

8
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)

Installing JDK: Install the latest version and Set below Environment Variables.

1 Set the following proxy properties (Start >


Control Panel > System > Advanced Variable Name Value
System Settings >Environment HTTP_PROXY_HOST Proxy
Variables): HTTP_PROXY_PORT 8080
HTTPS_PROXY_HOST Proxy
HTTPS_PROXY_PORT 8080

2 Make sure that you have defined the Variable


following system variables on your Name Value
computer (under Start > Control Panel > <your local installation
System > Advanced System Settings > directory, for example
Environment Variables): C:\Program
JAVA_HOME Files\Java\jdk1.6.0_21>
PATH %Path%;%JAVA_HOME%\bin

9
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)

Setting up SOAP UI: Install the desired version and then do the following settings.

1 Set the HTTP, SSL and Proxy


settings: Below you find the
settings procedure:

>In the SOAP client, go to File


-> Preferences> HTTP Settings
– uncheck the “Accept
compressed responses from
hosts”

2 Proxy settings are required if


you are working in a secure
network or firewall. Provide the
host and port of the proxy used
to access internet inside the
corporate network.

3 In SSL settings, browse and


select private key and enter the
corresponding password.

10
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)

Setting up Eclipse: Once you install Eclipse on your system, it will be blank. To start working with HCI
you need to install the plugins as below.

1. Go to: Help> Install new software. Provide the below URL for Luna version to download plugins:
https://tools.hana.ondemand.com/luna . Once you select the SAP Hana Cloud Integration, you will
see Designer component and Operations component. Press next and install the plugins.

Below is my Installation detail

11
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)

2. After the installation you need to restart eclipse and it will be ready to start with HCI.
Now go to Windows> open perspective. You can see two new perspectives have been added after
installation, open the integration Designer perspective and integration operations perspective.
Integration designer perspective will be used to develop I-Flows and operations perspective will be
used to monitor the deployed content and message processing.

12
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)

3. Now, Go to Windows> Preferences> SAP Hana Cloud Integration > Operations server.
Here you enter the URL of tenant management node to connect to the runtime. Tenant management
node URL created for IBM is: https://tmtr103h0109avtaiot-h0109.hana.ondemand.com

Enter your s-user and password and do test connection. After you test the connection successfully you
can find the tenant management and worker nodes in your node explorer, which means, you are
connected to the runtime and ready to deploy your iflow on cloud.

13
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)

4. Now, connection is established and we can start with the development. We have to create an Integration
project. Go to> File> New> Integration project. Provide a name and click Finish.

14
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)

5. Now, create an integration flow under the integration project. Go to> File> New> Integration Flow.
Select point to point channel as per our requirement and click Finish, you can also choose other
work flows as per your need.

6. Our I-flow is created as given in the diagram here. Now, we have to configure the settings at each
step of the iflow. But before we do that, we have to add the input and output wsdl to the iflow and
update the wsdl with end point where we will deploy the iflow in cloud.

15
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)

7. Attaching the Accounts_IN and Accounts_OUT wsdl. You can also create your own wsdl with
the desired structure or can export wsdl from service interface of ESR and modify them accordingly
with the service and end point tags to use it in HCI iflow. Import these wsdl in the iflow.

Accounts_IN.wsdl Accounts_OUT.wsdl

Update the Accounts_IN wsdl with your endpoints details. Remember to create your iflow with the
following naming convention to avoid inconsistencies and confusion:
16
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)

/suserid_senderAdapterNameinput

Endpoint: <soap:address location="https://iflmaptr101aaio119avt aiot-aaio119.intaas.hana.


ondemand.com/cxf/S00********_SOAP_input" />

8. Configure sender system and channel: Click on sender. Go to > Properties> Certificate based
authentication> Add. Add the SSL public key here which you have created earlier.

17
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)

9. Double Click the sender channel and select following details in general tab.

10. Go to Adapter Specific tab> General: Provide deployed iflow address here. The iflow name should be
same as the end point in Accounts_IN wsdl. In URL: browse and choose your input wsdl here, service
and endpoint will populate automatically as defined in the wsdl.

11. Create a new mapping: Go to New> Other > Message Mapping. Select Message Mapping wizard:
Click Next. Provide a mapping name and select the location details of our iflow project. Click Finish.
Add the source and target wsdl in overview tab of the mapping.

18
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)

12. Go to Definition tab and map the nodes as per your requirements.

19
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)

13. In properties tab,you can manually map the fields and apply all the preloaded functions from the right
section of the properties pane.

Alternatively, you can also download the mapping from ESR or reuse other repository content in HCI
by connecting to ESR as below: Go to > reference> repository connection and provide your PI system
connection url and id password. In our case it is not required.

20
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)

14. Once you create a mapping successfully, go to your iflow and drag drop the mapping object in the
iflow as below and assign the mapping.

15. Go to the receiver channel and provide below details in the general tab.

21
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)

16. Now, Go to the Adapter specific tab, provide the details as below.

17. Save all the settings and click deploy.


18. Select the integration project which you want to deploy on the server and check logs.

19. Now, Go to the worker node h0109 for checking your deployed content.Check in Deployed
artifacts and you can find the latest entry of your deployed iflow.

22
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)

23
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)

Testing the scenario

1. To trigger a message from SOAP UI, you can export the Accounts_IN wsdl to the directory and load
this wsdl in SOAP UI to send the message to iflow on cloud.

2. Open SOAP UI and create a new project as below: Select the exported wsdl and click OK.

3. Update the request 1 with data content.Check the end point, it should be same as we defined in wsdl
and sender channel.Now send the message by clicking on green button.

4. You can see an asynchronous response in the Raw xml tab of the response window.

5. Go to worker node Message Monitoring tab and click on search after giving search parameters.You
can find your message which is successfully sent to our iflow on cloud.

6. Since our scenario is SOAP to SOAP, you can find the target xml being generated in SOAP UI tool
only. This message will confirm the successful execution of our scenrio.

P.S. – Due to some issues, Testing snapshots could not be captured.

24
SAP Hana Cloud Integration (HCI) – A Walkthrough with Demo (SOAP to SOAP)

Points to remember

a. Please maintain the proper naming convention of your iflow while deploying to the server.

b. If you change any settings of a deployed iflow, use the same name in the end point to update the iflow on
cloud, otherwise it will create another iflow and you might end up testing a different iflow.

c. Please use your s-user id in iflow and folder names to differentiate it from other users working in the
tenant provided for Cognizant.

d. The tenant is under trial period and the access can be revoked at any time.

e. If you have any query, please contact SAP. Liam (liam.dowling@sap.com) is our point of contact from
SAP for HCI trial in IBM.

References

http://help.sap.com/cloudintegration

25

You might also like