Skip to Content
Technical Articles
Author's profile photo Jocelyn Dart

Connecting a CAL S/4HANA Instance to SAP Cloud Platform Web IDE

Latest Update: October 2020 – With SAP Cloud Platform SAP Web IDE trial account being closed and the shift to SAP Business Application Studio, this blog should now be considered to be retired. If you wish to connect your instance to SAP Business Application Studio please follow the tutorials on, e.g. Set Up Business Application Studio for Development

Latest Update: 9th May 2018 – clarified Internal and External IP Address usage – if it’s Intranet (i.e. you are a SAP Employee) use the Internal IP Address, otherwise use the External IP Address. 

Latest Update: 6th March 2018 – For those using the latest S/4HANA 1709 Trial Instance, the configuration approach is the same as 1610.  Details on the S/4HANA 1709 Trial Instance can be found on the SAP S/4HANA Trial page

Latest Update: 30th November 2017 –  Troubleshooting section added.

When I first set up my own trials, working out how to connect all these components together so you can get started required quite a bit of effort.  This blog aims to save you effort by clarifying how these components connect together.

Cloud Platform Destination connects succesfully!

Finding somewhere to practice your S/4HANA and Fiori 2.0 skills can sometimes be a challenge. Fortunately SAP provides a suite of trial options that you can use to get up to speed. To try out the latest techniques in the ABAP Programming Model for Fiori, in Fiori Extensions, and in Fiori element applications, you will need to connect these components so that they work together.

One note of caution: This blog was written using the following versions.  Of course you should always check the official documentation for whatever version you are using if you come across any differences.

Examples below are based on:

  • Cloud Appliance Library instance created based on the solution “S/4HANA 1610 Fully Activated Appliance” as at April 2017
  • SAP Cloud Platform HANA Trial account as at April 2017
  • SAP Cloud Connector version 2.9.1
  • SAP Web IDE version 170330

Make sure you read through the entire blog before you start! This will save you time as some information you may need to configure or capture when you first set up these instances.


Your laptop or desktop

We do not yet provide access to the Web IDE on devices.

SAP Cloud Appliance Instance for S/4HANA 

A S/4HANA 1610 Trial instance is sufficient

S/4HANA Trial solution in the Cloud Appliance Library

NOTE: SAP Employees should use the internal version of the Cloud Appliance Library at  that permits charging to internal account assignment objects.  They should use the solution marked as “Golden”.

SAP Cloud Platform account 

A free trial account is sufficient

SAP Cloud Platform Cloud Connector

The Portable version is sufficient. Make sure you have the latest version! (Older versions may not work)

CAL Instance Specifics

Set up the CAL instance as usual:

  • Make sure you have checked the option Open all TCP Ports – this is on by default
  • Take note of the IP address assigned to the S/4HANA system (this may be internal or external depending on whether you have created an Intranet or Internet instance respectively)  – you can see this in your instance details
  • Take note of the client, user, and password needed to access your S/4HANA system as a Developer

CAL Instance account details showing Internal IP Address in Info section

Once your CAL instance is active, make sure you can Connect to it via:

  • Remote Desktop
  • SAPLogon shortcut

SAP Cloud Platform Specifics

Check you can access the following areas of your account:

  • Connectivity > Cloud Connectors
  • Connectivity > Destinations
  • Services > SAP Web IDE service

Make sure the SAP Web IDE service is enabled. If you are using a trial account this should already be on.  In the examples we will use the normal SAP Web IDE service – ignore the innovation version

You will also need:

  • Your account id
  • Your account user

You find those in the Overview page of your SAP Cloud Platform Cockpit.

Cloud Platform Account Overview showing Account ID in the header and Account User ID in the User details

You will also need:

  • Your account user’s password, i.e. the password you use to login to the Cloud Platform. If you are using the Trial account this will be your SAP Identity password

SAP Cloud Connector Specifics

Install your SAP Cloud Connector as usual.

NOTE: If you are using the Portable edition, make sure you uninstall any old Cloud Connectors before installing the new version, as otherwise the old version may conflict with the new version.

Start your Cloud Connector.  If using the Portable version, just run the go.bat file

Launch your Cloud Connector as usual. For example, using your Web Browser and URL https://localhost:8443

Cloud Connector login screen

Logon as Administrator

Create an entry for your Cloud Platform account as usual.

Cloud Connector showing Cloud Platform account configuration

Check that your account connects successfully to your Cloud Platform.

You can find more information on configuring the Cloud Connector in the Cloud Platform documentation

SAP Cloud Connector Configuration

For the Cloud Platform account you are using, you need to configure Access Control. This defines which resources of your S/4HANA system can be used by your Cloud Platform account.

NOTE: You may configure multiple resources for the same S/4HANA system if needed.

To use the SAP Web IDE, you primarily need to access OData Services in your S/4HANA system.  For this you will need to create a Cloud to On-Premise tunnel definition as follows.

Create a mapping for your CAL appliance

Make sure you use the system type ABAP system (do not use SAP Gateway), especially if you are using a S/4HANA trial.

Use the Internal or External IP address and Port number of your CAL instance, depending on whether you have created an Intranet or Internet instance respectively.

Optionally you can set a virtual host name and port number that the Cloud Platform will use.  A virtual host name can be very useful – e.g. if you need to swap to a different CAL instance you can simply change the (internal or external) IP address in the Cloud Connector mapping and continue to use your existing Cloud Platform Destination without making any further changes.

Take care you are using the correct protocol for your S/4HANA system – HTTP or HTTPS – and take a note of this as you will  need to create a matching setting in the SAP Cloud Platform Destination later.  For the S/4HANA Trial CAL instance, HTTPS protocol is used.

Add the accessible resources as usual.

IMPORTANT: If you are using a trial or sandpit account it’s ok to allow all paths and sub-paths as in the example below. However, If you are using a productive account you must restrict the paths and sub-paths to the minimum that you need. Important paths include:

  • /sap/opu/odata & subpaths for OData Services
  • /sap/bc/ui5_ui5 & subpaths for executing Fiori(SAPUI5) applications from the SAPUI5 ABAP Repository
  • /sap/bc/adt & subpaths for extensibility scenarios, including deploying to the SAPUI5 ABAP Repository

Access Control configuration in Cloud Connector

Use the Check Availability icon to to check the S/4HANA system on your CAL instance is reachable.

NOTE: the CAL appliance must currently be ACTIVE for the check to be successful.

Finally go to your Account and check again that it is connected to the Cloud Platform account.

NOTE: If you are using the SAP Cloud Platform trial account and a Portable Cloud Connector, you can only have one system connected at a time – so disable any unwanted services in the Access Control section of your Cloud Connector if you receive an error.

SAP Cloud Platform Configuration

In your SAP Cloud Platform Cockpit, go to option Connectivity > Cloud Connectors

Check your Cloud Connector is shown and your S/4HANA virtual machine & port is Available.

Cloud Platform showing Cloud Connectors available (sub-option of Connectivity)

Then go to the option Connectivity > Destinations to create a destination that the Web IDE can use to call your S/4HANA system via the Cloud Connector.

There are a few very important settings:

  • The URL must use the Protocol (HTTP or HTTPS), virtual host and port ids exactly as specified in the Cloud Connector
  • Make sure you use the NoAuthentication option – this defers authentication until the Web IDE uses the destination explicitly
  • Set the proxy type to OnPremise – this indicates the Cloud Connector is used to reach the S/4HANA system

Cloud Platform Destination configuration details

Add the Additional Properties as follows:

  • Set sap-client to your S/4HANA client
  • Set WebIDEEnabled to true
  • Set WebIDESystem to your S/4HANA system id

Set WebIDEUsage to: odata_abap,dev_abap,ui5_execute_abap,bsp_execute_abap

IMPORTANT: Do *not* add odata_gen or smart_business_odata – conflicting odata settings can cause unexpected issues in the Web IDE, e.g. such as the annotation modeller may fail  to find odata services

Once you have saved your destination, use the Check Connection button (or Check Availability icon in the Destination list) to check the Destination successfully connects to your S/4HANA system via the Cloud Connector.

Cloud Platform Destination connects successfully

You are now ready to go to the Cloud Platform Cockpit Services option and find the SAP Web IDE service

Cloud Platform Services option

Enter the SAP Web IDE Service and use the Go to Service link to start the Web IDE

Cloud Platform Web IDE Service showing Go to Service link

Wait for the SAP Web IDE to load.

SAP Web IDE Loading...

Once loaded you can bookmark the SAP Web IDE URL – you do *not* need to enter through the SAP Cloud Platform Cockpit every time.

SAP Web IDE Home Page

Quick Test in SAP Web IDE to check everything is working correctly

You can quickly test if everything is working correctly by starting one of the wizards.

For example:

Use menu option File > New > Project from Template to start the List Report Application wizard.

Fill in the mandatory fields and move Next to get to the Data Connection step.

Select your SAP Cloud Platform Destination name, and check that the relevant catalog services are listed.

Data Connection tab showing successful service catalog testing

If the services are listed, everything is working and you are ok to continue working in the Web IDE.

Troubleshooting common issues

Catalog service is not available

If you receive an error that the Catalog service is not available, you need to fix this in your S/4HANA system itself.

Data Connection tab showing Catalog service not available error

Go to transaction /IWFND/MAINT_SERVICE and find the 2 services for /IWFND/CATALOGSERVICE (CATALOGSERVICE is the External name).

Remove the System Alias for version 1.  Make sure the system alias is empty for BOTH version 1 and version 2.  Refer to SAP Notes 2372333 and 2402505 for more information.

Annotation file is invalid

When creating Fiori elements you will need to use annotations.  If you see a “Annotation file is invalid” error, check that the protocol used in the SAP Cloud Platform Destination URL agrees with whatever was configured in the Cloud Connector.

OData metadata can’t be loaded

Annotation Modeler showing OData cannot be loaded error

When working with Fiori elements it’s very helpful to use the Annotation Modeller tool.  If you receive an error “OData metadata can’t be loaded”, check the WebIDEUsage parameter in your SAP Cloud Platform Destination. Only one type of OData usage should be listed.

Connection checks after Suspending and Reactivating your CAL Instance

This is the sequence of checks to run through to make sure everything is ready after you have suspended and reactivated your CAL instance:

CAL instance:

  1. Check you can login to your S/4HANA system using your Developer user & password

SAP Cloud Platform Cloud Connector:

  1. Make sure you SAP Cloud Platform Cloud Connector is running.
  2. Check the S/4HANA system is Reachable
  3. Check your SAP Cloud Platform Cloud Connector account is connected to the SAP Cloud Platform

SAP Cloud Platform Cockpit:

  1. Check your Cloud Connector is connected via option Connectivity > Cloud Connector
  2. Check your Destination connects successfully via your Cloud Connector to your S/4HANA system
  3. Start the Web IDE service


Common problems:

2433274 – Backend is not available in the list of defined system mappings in Cloud connector

2569471 – Error occurs when checking the connection of a destination

2258549 – SAP Cloud Connector fails to connect to the backend

2447136 – Failure reason: “Backend status could not be determined” when checking Destination connection

Otherwise search on the SAP Support launchpad with component BC-NEO-CON

Get Going!

Wishing you all the best in trying the new Fiori 2.0 and S/4HANA techniques!

Need some suggestions? Try these blogs…

Fiori elements – How to Develop a List Report Basic Approach

Fiori elements – How to Develop a List Report using Local Annotations

Developing a Simple List Reporting App (ABAP Programming Model for Fiori)

End to End Fiori In App Extensibility in S/4HANA On Premise

Brought to you by S/4HANA RIG

Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Former Member
      Former Member

      Hi Jocelyn,

      Thanks so much for these efforts; can't put a figure on the number of hours you have saved me.

      It will be very useful to me.

      Bakau Onafuwa





      Author's profile photo Jocelyn Dart
      Jocelyn Dart
      Blog Post Author

      Thanks Bakau - it took us about 4 weeks on & off of trying various combinations & dragging in various experts when we got stuck so saving you time is exactly what this blog is about!

      Author's profile photo Bakau Onafuwa
      Bakau Onafuwa


      Hi Jocelyn,

      We currently are faced with a number of issues with our post-activation activities viz:

      1.During the activation of our SAP CAL on Azure, we unchecked the Remote Desktop VM option hoping that we will be connecting locally from our corporate network (SAP GUI, Browsers, Cloud Connectors e.t.c) to the instance via the External IPs. This is a challenge right now. Do you know of any way to re-enable the RDP VM for our instance to provide the front-end services?

      2.Where did you install your Connector, locally or on the front-end server? We need clarifications because you suggested we connect the Cloud connector using the Internal IP. We currently have our Connector instances running locally.

      3.As part of troubleshooting, we found this blog: where it was mentioned that we use the DNS name of the virtual machine as the application server name in our local SAP GUI? This did not help our cause.
      We have relied principally on the following blog for the activation steps: and the help guide from SAP.
      Kind regards

      Author's profile photo Jocelyn Dart
      Jocelyn Dart
      Blog Post Author

      Hi Bakau
      Re 1. & 3. Unfortunately not something I can assist with. Suggest you ask it as a question on using the CAL topic tag and referencing blog
      Yes you do need the IP address
      2. I had my Cloud Connector installed locally on my laptop

      Author's profile photo DJ Adams
      DJ Adams

      Hey Jocelyn – great post, very useful, thanks. Just wanted to add some thoughts to Bakau’s question 2 on internal vs external IP addresses. I too did wonder, while reading this part of the post: “Use the Internal IP address and Port number of your CAL instance”, especially as the address range used for internal IP addresses (10.*) is not usually accessible on the open Internet. On my laptop here, I have to use the external IP address when configuring my SAP Cloud Connector to connect to the S/4HANA system on AWS.

      I can only suspect that there may be some internal routing at SAP that allows users within the SAP corporate network to use the 10.* ranges directly. This suspicion is also underlined by what I saw in the W1U3 exercise PDF, where it says, on page 3: “Find the IP address of your SAP S/4HANA 1610 instance. If you are a SAP Customer or Partner this will be an external IP address. If you are a SAP Employee this will be listed as an Internal IP address.”

      Of course, I may have not had enough coffee yet this morning, but I thought I’d offer an observation. For us mere mortals, the external IP address is required ?



      Author's profile photo Jocelyn Dart
      Jocelyn Dart
      Blog Post Author

      Hi DJ

      Thanks for picking that up ... thought I had fixed all of those references last time 🙁

      All references adjusted now



      Author's profile photo Himanshu Agrawal
      Himanshu Agrawal

      Hi Jocelyn,

      Thank you so much for putting everything all together. It's a very useful blog and it's definitely going to save the time of every individual who is connecting CAL S/4HANA Instance to SAP Cloud Platform Web IDE for the first time.

      Sharing it on LinkedIn with my network. 🙂


      Himanshu Agrawal

      Author's profile photo Michal Keidar
      Michal Keidar

      Great blog! Thank you

      Author's profile photo Gretchen Horn
      Gretchen Horn


      Very helpful blog...thank you so much Jocelyn!