SapMachine and SAP HANA Studio

last changed: 18th of May 2022

SapMachine is an OpenJDK released maintained and supported by SAP.
You can replace the in-build JAVA Support from the SAP HANA Studio with SapMachine.

You can use this to replace any existing JAVA (owned by Oracle) deliveries on you local Frontend or Terminal Server. Download the 64-Bit binaries either as

• zip archive (allows you own location)
• installation packages

Make sure that you adapt the Environment of your Frontend for SapMachine as well, like

• JAVA_HOME
• SAP_JRE8_64
• Path

Edit the File C:\Program Files\SAP\hdbstudio\hdbstudio.ini

And replace the -vm parameter with the SapMachine
Old:      plugins/com.sap.ide.sapjvm.jre.win32.x86_64_110.11.0/jre/bin
New:    c:/usr/sap/sapmachine-jdk-11.0/bin

--launcher.XXMaxPermSize
512m
--launcher.defaultAction
openFile
--launcher.appendVmargs
-vm
c://usr//sap//sapmachine-jdk-11.0//bin
-startup
plugins/org.eclipse.equinox.launcher_1.6.300.v20210813-1054.jar
--launcher.library
plugins/org.eclipse.equinox.launcher.win32.win32.x86_64_1.2.300.v20210828-0802
-vmargs
-Dfile.encoding=UTF-8
-Duser.language=EN
-Xms512m
-Xmx2048m
-XX:MaxPermSize=1024m
-XX:+HeapDumpOnOutOfMemoryError
-Djdk.http.auth.tunneling.disabledSchemes=
-Dcom.sap.adt.tools.cloud.authentication.ui.cloud.pilot.project=true
# in case of Problems with local SSL store
# -Djavax.net.ssl.trustStore=NUL
# -Djavax.net.ssl.trustStoreType=Windows-ROOT 

the latest SAP HANA Studio Version starting from 2.3.60 and onwards are now completely compiled with JAVA 11 due to a lot of incompatibilities between the Version JAVA (SDK) 8 and 11. As mentioned in the comments you can also use SapMachine 17 instead of 11.

Troubleshooting related to SAP HANA Studio

Note 3102609 – SAP HANA 2 SPS05 Revision 059.00  => Version 2.3.61
Note 3102470 – SAP HANA 2 SPS06 Revision 060.00  => Version 2.3.62
Note 3126756 – SAP HANA 2 SPS06 Revision 061.00  => Version 2.3.63
Note 3150702 – SAP HANA 2 SPS06 Revision 062.00  => Version 2.3.67
Note 2073112 – FAQ: SAP HANA Studio

If you encounter Problems with the SAP HANA Studio Version 2.3.60 and higher, e.g. 2.3.61 delivered with the latest SAP HANA Studio Versions, you can also check the Document

• SAP First Guidance – Implementing BW-MT as the new SAP BW Modeling Experience

In particular, a “new” error message arise which caused already problems in the past. This occurrence leads rather to the external JDK Support or mismatch of the used JDK Version. Sometimes only a new Installation solves this problem.

SAP Answers – ADT 3.18 stopped working on Eclipse 2021-06
SAP Answers – JavaFX 13 and Eclipse

mismatch between JAVA 8 and 11

optional: Delete Database and Cache will not solve the Problem

SAP HANA Studio and SAP GUI 7.70

Note 2600384 – New and changed features in SAP GUI for Windows 7.60
Note 2796898 – New and changed features in SAP GUI for Windows 7.70

If you are using SAP GUI 7.70 together with the SAP HANA Studio, you probably encountered that the Internet Explore 11 is not supported anymore. So you have to switch at both locations (GUI and Studio/Eclipse) to the Microsoft Edge (based on Chromium) Support.

Note 1672817 – Browser: Microsoft Legacy Edge and Internet Explorer Support Policy Note
Note 1716423 – SAPUI5 Browser Support
Note 3043532 – Web Dynpro app opens always in Internet Explorer (IE11) when called from SAPGUI
Note 3048479 – WDA: Execute Application According to Browser Mode Setting

Blog – Update: Future SAPUI5 versions will no longer support Microsoft’s legacy browsers
Blog – Installing lean Eclipse with ADT

check SAP HANA Studio 2.0 – Preferences

switch to the external Browser Support

check SAP Logon 7.70 GUI Settings

check Web Dynpro Settings in SE80

Note 3009338 – SOLDOC: SAP GUI office Integration

Online Edition with Edge and GUI 7.70, e.g. SolMan 7.2 SP13 and higher

Eclipse Add-On’s AiE and BW-MT

Note 3035242 – Remove bundled JRE from Eclipse packages
Note 3110480 – RTC of ABAP development tools 3.22
Note 3196011 – RTC of ABAP development tools 3.26
Note 3095235 – Modeling Tools for SAP BW/4HANA and SAP BWoH : Release 1.24 Patch 00
Note 3146024 – Modeling Tools for SAP BW/4HANA and SAP BWoH: Release 1.24 Patch 03

Always check with the online resources at – https://tools.hana.ondemand.com/# and

• SAP First Guidance – Implementing BW-MT as the new SAP BW Modeling Experience

check SAP HANA Studio 2.0 – Installed SAP Add-On’s

Roland Kramer, SAP Platform Architect for Intelligent Data & Analytics
@RolandKramer

“I have no special talent, I am only passionately curious.”