A couple of months ago I started to work with Hana Cloud Integration. I followed the SAP e-learning OHAC10 (Hana Cloud Integration), attended a HCI developers day and viewed some webinars. When trying to learn all the possibilities of HCI I encountered some ‘problems’. With this first blog I hope I can  help you get a fresh start with HCI.

  • Check out the SAP ‘Starting with HCI’ page. It contains a lot of useful information about the technique, blogs, webinars and other events.
  • You can enter a trial program, to see what HCI can do. Check the details here!
  • Download Eclipse. This program will help you to develop adapters and integration Flows. To avoid weird errors, make sure you download the Kepler version. This is the version SAP supports.
    Eclipse is used for more than HCI only, therefor you need to download some additional plug-ins. See this page for more information about installing plug-ins in Eclipse.
  • So you got your (trial) HCI account, and you got the Eclipse with all the plug-ins, what’s next? You need to set up your Eclipse with your HCI tenant.

Starting with HCI - Tenant in Eclipse.png

Enter your credentials in Eclipse. You should either received an email containing the URL, or use the trial environment.

  • Your Eclipse is now linked to your HCI (trial) account. You created a simple iFlow and try to deploy this: error! Before you can start using your HCI tenant you need to create a keystore. (In the trial version, this is already performed by SAP)

        In the PDF ‘Create a keystore.pdf’, which you can download here, the creating of a new keystore is explained.

  • Now that your iFlow can be deployed on your HCI tenant, you want create an iFlow. In my next blog I will show how to call a web service, transform some data and send it via email. If you want to call a web service, or SuccessFactors for example, you need to add certificates to your keystore

        In the ‘Creating a JAVA Keystore.pdf’ there’s this chapter called ‘Importing Signed certification into keystore’. But how do you get your    

        SuccessFactors certificate?

Starting with HCI - Certificate export.png
Use Firefox or Chrome and browse to your SuccessFactors login page. Click on the lock, and go to the ‘Connection’ tab. Choose ‘Certificate information’.

Starting with HCI - Certificate export2.png

Choose Details and go for ‘Copy to file’.


Starting with HCI - Certificate export3.png

Take the Base64-encoded X.509 (*.CER) and save it.

And there you got your SuccessFactors certificate which you can import in your keystore. This works the same for other certificates.

  • So now you are able to create your iFlow, reach to different applications and deploy it to your tenant. But the iFlow is not working and you want to trace the header and the body of your message. For this, you have to make a request to SAP and ask for tracing rights.
    You create a ticket here, and put your request in category LOD-HCI. Make sure you provide all the needed information (like tenant name and S-user).

        After you have been granted the rights, you need to enable tracing in your iFlow.

Starting with HCI - Tracing.png

In the properties of your iFlow, go to Trace Configurations and choose the trace level you want.

Starting with HCI - Tracing2.png

In the message monitoring (double click on your tenant, in the node explorer, to get here) select the iFlow you deployed after setting the trace settings and choose for ‘View Trace’. Your iFlow will now be decorated with the selected trace level.

I hope that after reading this blog you are able to set up your HCI tenant with your Eclipse. If you have any questions please do not hesitate to contact me, or leave a comment below.

Bob van Rooij

Blog 1: Starting with Hana Cloud Integration? Keep this in mind!
Blog 2: Starting with Hana Cloud Integration? Create a simple integration flow (iFlow)!

Blog 3: Deep dive in Hana Cloud Integration

Blog 4: Hana Cloud Integration and SuccessFactors Integration Center

Blog 5: Hana Cloud Integration in comparison to Dell’s Boomi.

To report this post you need to login first.

29 Comments

You must be Logged on to comment or reply to a post.

  1. Sandeep Maurya

    HI Bob,

    I am able to open “Integration Designer” perspective and able to do development, but I am getting below error when I am saving my development using save button.

    An internal error occurred during: “ChecksJob”.

    java.util.ConcurrentModificationException

    I am getting same error when I  “Deploy Integration Content”. It seems eclipse problem.

    I am using below eclipse.

    Eclipse Standard/SDK

    Version: Kepler Service Release 2

    Build id: 20140224-0627

    Any idea how to fix this issue.

    Thanks

    Sandeep

    (0) 
    1. B. Van Rooij Post author

      Just as Avinash says; please share your plugin version. And after that please check if there are any updates available for your plugins.

      (0) 
  2. Swapnil Borkar

    Hi Van

    I got Eclipse connection to HCI working, but I don’t have all the HCI tools in Eclipse preferences..

    See connection to HCI is working –  but in Preferences I do not have Hana cloud Integration to access iflows, etc..

    eclipse no HCI.png

    HCI Addon was also successfully installed

    eclipse install.png

    I am using Luna Service Release 2 (4.4.2) 20150219 0708 as per the instruction on link , I tried Kepler as per your instructions but got same issue.

    Let me know your thoughts on why this might be happening.

    Swapnil

    (0) 
    1. B. Van Rooij Post author

      Hi Swapnil,

      how unfortunate that not everything is working for you. At first: Luna is the way to go, my advice for Kepler is outdated now.

      I see you have the right add-ons in Eclipse, you have connection to the tenant but it’s not showing up in your preferences. Are you able to access the Integration or Operation perspective (Windows –> Open perspective)? From there out you should be able to make/update iFlows.

      If you do not have access to that perspectives my guess is the problem is in Eclipse. Try removing all old instances and re-install Eclipse (IDE for Java EE developpers, Luna).

      I hope this will work for you, otherwise, please let me know!

      (0) 
  3. Nagesh Caparthy

    Hi B. Van Rooij,

    I am getting an error while connecting tho HCI from Eclipse. I have Luna with the following version of HCI Tools

    I have HCI account with the URL Format : https://hcids.us1.hana.ondemand.com/DSoD/session/logon/XXXXX where XXXX our ID to login.

    When I use the same URL eclipse give an error:

    If I remove the /DSoD and enter the ID and password I get error 404.

    Please suggest what will be the work around for this? Posted a query on this: Error while connecting – Eclipse to HCI

    Regards,

    Nagesh

    (0) 
  4. Sanjaya Kumar Bihari

    Hi B Van Rooji,

    I read in another blog that if there is already an system.jks  (java key store ) deployed in a tenant, deploying a new one would overwrite it.

    So how do I ensure that the old ones are there and I should add only the SF certificate key store into the existing one).

    Please help.

    Thanks

    Sanjaya

    (0) 
    1. B. Van Rooij Post author

      Hi Sanjaya,

      you should download the original system,jks (and find out the password for it, the one who uploaded it in the first place might help you with that). After that you open the system.js with keystore exlporer or a similar program and you add the SF certificate. Then save the system.jks and upload it again to you HCI tenant.

      Good luck!

      Best regards,

      Bob

      (0) 
      1. Sanjaya Kumar Bihari

        Hi B. Van Rooji,

        Thanks a lot. I have some other questions and hope you would be able to help me. Sorry if I am bothering you.

        When I open the WEB UI URL of my HCI tenant, I do not see Projects, Data Stores, Agents etc tabs. Is that something to do with the authorizations ?

        Also in the menu option I can only see, Discover,Design and monitor option. I think we have the Run option as well?

        Thanks

        Sanjaya

        (0) 
        1. B. Van Rooij Post author

          Hi Sanjaya,

          no problem, happy to help.

          The Projects, Data Stores, Agents etc, are tabs in the HCI DS(data services), but if they are not showing with you I’m guessing it has to do with authorisations like you mentioned.

          The other options you are mentioning are options in the HCI web UI, and that are also the only options I have. Is it possible you are mixing up the HCI DS and HCI (process Integration)?

          Regards,

          Bob

          (0) 
          1. Sanjaya Kumar Bihari

            Thanks a lot Bob for your help and clarification. It was really informative for me.

            I was trying to build one simple iflow, wherein I am reading the weather data and sending those data to gmail account. However when I deploy the project, the run time status shows as ERROR in component status view as shown below. Would you be able to help in this?

            Is it mandatory to upload the gmail server certfictaes into JKS?



            Could you please suggest/help in building an Iflow where in I do do not need to change/deploy the system.jks. Components Status view.png


            And in one more case I am getting the below error when I do the execute checks. Any idea what could be the reason.

            Execute Checks error.png

            (0) 
            1. avinash M

              Post this as question in the PI space.

              I would suggest, update your HCI plugins in the Eclipse then try again. I guess there is bug in the current version of your eclipse.

              reg, avinash

              (0) 
  5. Hari Sonnenahalli

    Van-

    Hope all is well. This is a very useful blog to get started with HCI tenant. I have performed following tasks to set up my HCI but I think something is not correct. Please review my comments below and if you can provide me your inputs it would be much appreciated.

    1) Received an email from SAP containing WEB UI, Eclipse, and Runtime URL

    2) Setup my account with admin and integration developer previllages and also have assigned ESB. MessageSend role to my IFLMAP account type so that can send SOAP UI message.
    3) Downloaded Mars 2.0 and installed integration plug in
    4) Connected HCI tenant to eclipse using eclipse URL
    5) Created a simple SOAP to GROOVY SCRIPT scenario in eclipse and try to deploy and it was error and my endpoints were not configured and received following error

    “Error 1:
    [CAMEL][IFLOW][ERROR] : Integration flow failed.
    [CAMEL][IFLOW][EXCEPTION] : java.util.concurrent.TimeoutException
    [CAMEL][IFLOW][UNRESOLVED] : Unresolved dependency: (&(keystore=default)(objectClass=com.sap.esb.security.KeyCertificateAccessor))”

    5) Referred to your document to create a key store and have imported all my email and s user certificate into key store.

    My concerns and questions are as follows:

    1) If am trying to just demo the system and try to see if setup is correct what kind of certificates are needed. I have downloaded and imported following certs into my key store.

    • cer
    • cer
    • cer
    • cer
    • cer

    2) Once have created keystore and imported certs. I am not sure how to deploy it to my tenant. I have Admin and Integration developer roles.

     

    3) When tried to deploy my scenario no end points are created under integrations operations for worker node. I am confused and unable to figure out what I have missed.

     

    Please let me know.

     

    Regards

     

    HS

    (0) 
  6. Hari Sonnenahalli

    Van-

    Hope all is well. This is a very useful blog to get started with HCI tenant. I have performed following tasks to set up my HCI but I think something is not correct. Please review my comments below and if you can provide me your inputs it would be much appreciated.

    1) Received an email from SAP containing WEB UI, Eclipse, and Runtime URL

    2) Setup my account with admin and integration developer previllages and also have assigned ESB. MessageSend role to my IFLMAP account type so that can send SOAP UI message.
    3) Downloaded Mars 2.0 and installed integration plug in
    4) Connected HCI tenant to eclipse using eclipse URL
    5) Created a simple SOAP to GROOVY SCRIPT scenario in eclipse and try to deploy and it was error and my endpoints were not configured and received following error

    “Error 1:
    [CAMEL][IFLOW][ERROR] : Integration flow failed.
    [CAMEL][IFLOW][EXCEPTION] : java.util.concurrent.TimeoutException
    [CAMEL][IFLOW][UNRESOLVED] : Unresolved dependency: (&(keystore=default)(objectClass=com.sap.esb.security.KeyCertificateAccessor))”

    5) Referred to your document to create a key store and have imported all my email and s user certificate into key store.

    My concerns and questions are as follows:

    1) If am trying to just demo the system and try to see if setup is correct what kind of certificates are needed. I have downloaded and imported following certs into my key store.

    SAPPassportCA.cer

    mySAPTestCA.cer

    SAPSUser.cer

    Hcicertificate.cer

    EmailHari.cer

    2) Once have created keystore and imported certs. I am not sure how to deploy it to my tenant. I have Admin and Integration developer roles.

     

    3) When tried to deploy my scenario no end points are created under integrations operations for worker node. I am confused and unable to figure out what I have missed.

     

    Please let me know.

     

    Regards

     

    HS

     

    (0) 

Leave a Reply