SAP Development Tools for Eclipse Installation: FAQ and Known Issues

It seems that you had a problem while trying to get and setup the tools.

We are sorry for that but maybe there is already a solution for your problem.

Where to start

• SAP Cloud Platform Tools
  • If you have never before installed SDK and Tools: SAP Cloud Platform Developer Center
  • SAP Cloud Platform Documenation: Installing Java Tools for Eclipse and SDK
• Other tools: installation instructions are linked on https://tools.hana.ondemand.com/ (see tool specific tab)
• Direct link to the Tools Update Site: https://tools.hana.ondemand.com/
  

FAQ

FAQ #2: When I try to install SAP Development Tools in Eclipse, I get an error message that Eclipse cannot connect with the update site https://tools.hana.ondemand.com/<EclipseReleaseName> e.g https://tools.hana.ondemand.com/oxygen.

Typical error messages are:

• No repository found at https://tools.hana.ondemand.com/<EclipseReleaseName>
• Could not find tools.hana.ondemand.com
• Unable to connect to repository at https://tools.hana.ondemand.com/<EclipseReleaseName>

Probably, you did not configure the proxy correctly in Window > Preferences > General > Network Connections so that Eclipse can not reach https://tools.hana.ondemand.com. The correct proxy configuration depends on your IT infrastructure. The following 3 typical configurations have been reported as working in the support forum:

1. You can connect directly to the internet, i.e. don't need any proxy.
   Please configure 'Direct' as Active Provider.
2. You connect to the internet via http proxy.
   Please configure 'Manual' as Active Provider and configure the proxy entries for the protocols HTTP and HTTPS. Do not configure anything for SOCKS.
3. You connect to the internet via SOCKS proxy.
   Please configure 'Manual' as Active Provider and configure the proxy entry for the protocol SOCKS.

To find the right setup, you could check the proxy settings in your browser.

After fixing the proxy configuration, please go to Windows > Preferences > Install/Update > Available Software Sites, select e.g. the software site "SAP Development Tools for Eclipse Oxygen" and press 'Reload' to verify that the connection works now. Repeat the check for software site 'Oxygen' (http://download.eclipse.org/releases/oxygen).

Additional hints:

• On Windows, users experienced problems with the 'Native' proxy provider. Therefore, we recommend to use the 'manual' proxy provider and to configure the proxy settings manually.
• On the update site, there is no file 'https://tools.hana.ondemand.com/<EclipseReleaseName>/content.xml' (even though Eclipse complains about it in the error message). If you want to test that you can download a file via browser, please test with https://tools.hana.ondemand.com/<EclipseReleaseName>/content.jar (e.g. https://tools.hana.ondemand.com/oxygen/content.jar)
• Please also test if you can install from the eclipse.org update site (https://download.eclipse.org/releases/<EclipseReleaseName> e.g. http://download.eclipse.org/releases/oxygen). If not, please check the proxy settings again.
• In case your connection to the update site is very slow, you may run into timeouts (check the error message details). The following article helps to workaround the timeouts:
  • http://stackoverflow.com/questions/1489149/how-to-change-value-of-read-timeout-of-eclipses-update-manager

If this does not solve your problems then please request support in the SAP Cloud Platform Community .

FAQ #4: Installation fails with message 'Cannot complete the install because one or more required items could not be found'.

Please ensure that the 'Contact all update sites during install to find required software' check box is selected in the installation wizard. See also http://scn.sap.com/thread/3199711.

Please also double check that the software site "SAP Development Tools for Eclipse" matches your Eclipse installation version.

• e.g for Eclipse Oxygen(4.7) you have to use: https://tools.hana.ondemand.com/oxygen

FAQ #6: Installation of tools starts but then suddenly hangs

Users have reported freezes during installations caused by anti-virus programs, e.g. Eclipse freeze when installing SAP HANA Tools

FAQ #7: Eclipse hangs and crashes or even doesn't start at all

You may use a JVM not supported by the Eclipse installation.
Eclipse picks up one JVM and it is not clear which unless you configure the JVM explicitly in the eclipse.ini file located in the root folder of the Eclipse installation (note: 2 lines in eclipse.ini):

-vm
<path to JVM>

See also Eclipse runtime options and Eclipse Launcher chapters in Eclipse Help.

FAQ #8: Which Java version is recommended for running Eclipse?

All SAP Development Tools require at least Java 8.

Some SAP Development Tools may support additional Java versions, see the tool specific documentation on https://tools.hana.ondemand.com/. General information about the recommended Java versions for Eclipse is available in the readme/readme_eclipse.html file of your Eclipse installation (online version e.g. Eclipse Project Release Notes 4.7 (Oxygen) ).

See FAQ #7 how to specify explicitly the Java version used by Eclipse.

FAQ #9: Installation fails with certificate error

The installation fails with a similar error message as in FAQ #2 (Unable to read repository ...). However, the detail message points to a certificate error like "SunCertPathBuilderException: unable to find a valid certification path".

This error message means that the JVM running Eclipse could not validate the certificate of https://tools.hana.ondemand.com/.

Typical reasons are:

• Outdated Java VM. Please install the latest Java VM patch level. See FAQ #8 for the recommended Java version.
• Although an up-to-date Java version is installed, Eclipse runs with an older version (which is also available on your PC). Check the Java version in "Help > About Eclipse > Installation Details > Configuration", search for java.runtime.version to see which Java version is actually used. Property eclipse.vm points to the Java binary that is used to run Eclipse. See FAQ #7 how to specify explicitly the Java version used by Eclipse.
• Users reported issues with corporate proxies that required a special configuration. Please check that you can access https://tools.hana.ondemand.com/ without certificate issue in a browser using the same proxy that you have configured in Eclipse.
• Check the certificate path of https://tools.hana.ondemand.com/ in your browser. Especially if your company name shows up in the chain, then your proxy seems to interfere the SLL communication. You might be able to fix this problem by importing your companies SSL certificate into the JVM that you use for running Eclipse. See this thread for more information.

Known Issues

There are currently no known issues.