Technical Articles
SapMachine and SAP HANA Studio
last changed: 12th of April 2023
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
- JavaFX
- 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-18.0/bin
macOS: /Applications/sap/SAPGUI/SAPGUI.app/Contents/PlugIns/jre/Contents/MacOS/libjli.dylib
-startup
../Eclipse/plugins/org.eclipse.equinox.launcher_1.6.400.v20210924-0641.jar
--launcher.library
../Eclipse/plugins/org.eclipse.equinox.launcher.cocoa.macosx.x86_64_1.2.700.v20221108-1024
--launcher.XXMaxPermSize
512m
--launcher.defaultAction
openFile
--launcher.appendVmargs
-vm
#../Eclipse/plugins/com.sap.ide.sapjvm.jre.macosx.x86_64_110.17.0/jre/Contents/Home/lib/jli/libjli.dylib
/Applications/sap/SAPGUI/SAPGUI.app/Contents/PlugIns/jre/Contents/MacOS/libjli.dylib
--add-modules=ALL-MODULE-PATH
--module-path=/Applications/sap/javafx-sdk-20/lib
--add-exports=javafx.web/com.sun.webkit.dom=ALL-UNNAMED
-vmargs
-Xms512m
-Xmx2048m
-XX:MaxPermSize=1024m
-Dfile.encoding=UTF-8
-Duser.language=EN
-XX:+HeapDumpOnOutOfMemoryError
-Djdk.http.auth.tunneling.disabledSchemes=
-XstartOnFirstThread
-Dorg.eclipse.swt.internal.carbon.smallFonts
-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
with macOS, you can use the homebrew package manager to apply sapmachine18-jdk
Troubleshooting related to SAP HANA Studio
the current Versions of the SAP HANA Studio are not working on the new Apple Silicon (M) Devices. It is related to the latest Update of the macOS Version 13 (Ventura) – https://github.com/eclipse-platform/eclipse.platform.swt/issues/256
For Eclipse 2023-03 (4.27), use https://tools.hana.ondemand.com/2023-03
For SAP for Eclipse 2022-06 (4.24), use https://tools.hana.ondemand.com/2022-09
The SAP HANA Client for macOS, use https://tools.hana.ondemand.com/#hanatools
Note 3198962 – SAP HANA 2 SPS06 Revision 063.00 => Version 2.3.70
Note 3259825 – SAP HANA 2 SPS06 Revision 066.00 => Version 2.3.71
Note 3312617 – SAP HANA 2 SPS07 Revision 070.00 => Version 2.3.73
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 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
Note 3204095 – SAP GUI for Java: Requirements for Release 7.80
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 2971147 – Using JavaFX with Java 11 for embedded GUI in ABAP Development Tools (MacOS / Linux)
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
Note 3031743 – WebGUI Health Check feature
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
SAP HANA Studio and SAP GUI for Java 7.80
beginning with SAP GUI for Java 7.80 the native support of Apple ARM Chips (aka. M1/M2) is available. However, the SAP HANA Studio for macOS is still INTEL based. You have to decide, wether you want to work with the native Eclipse Application for macOS ARM, or the SAP HANA Studio with the SAP GUI for Java 7.80 for X86_64
SAP HANA Studio and SAP GUI for Java 7.80 (x86_64 based)
Note 2487028 – How to open /UI2/FLP to run it on default browser
Note 2616249 – How to achieve SSO while opening Fiori Launchpad using t-code /UI2/FLP
Note 3129284 – FLP start with / without SSO and default browser (new FLP setting)
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 3226606 – RTC of ABAP development tools 3.28
Note 3236198 – Unable to start ADT debugger from BW Projects
Note 3203171 – Modeling Tools for SAP BW/4HANA and SAP BWoH : Release 1.24 Patch 04
Always check with the online resources at – https://tools.hana.ondemand.com/#
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.”
Can I ask you to add a tag for ABAP Development, since it's relevant to ADT as well.
https://blogs.sap.com/2019/06/07/installing-lean-eclipse-with-adt/
Done 🙂
Hi Roland Kramer,
thanks for the good post. One question (on Eclipse/ADT, however could be interesting for HANA studio as well). Is there any way to check, which version of java is really used - after firing up Eclipse (besides set java)?
best regards, Daniel
Hello Daniel Purucker
beside what is defined in the studio.ini and the check of the command line "java -version", you can check the Studio Preferences for "Java JDK"
Best Regards Roland
Hi Roland Kramer,
Nice blog!
Now we can use sapmachine17 and ZGC to speed up Eclipse , just change file(hana.ini or eclipse.ini) ,like this :