A complementary installation guide to openSAP “Developing Java-Based Apps on SAP HANA Cloud Platform” MOOC (Week 1) – PART 1
Introduction : A lot of participants had trouble (including myself) doing the initial setup as the installation step was referred to another course and there were quite some points where troubleshooting was needed. This documents aims at smoothening out those rough edges for people who are not too savvy with the mentioned tools yet. Also a lot of screenshots make it much easy to understand.
Date created : 14.09.2016
Environment : 64 bit Windows 10 laptop. Take care of appropriate versions if you are using a Apple device or a 32 bit machine.
Note for the readers : This document is a work in progress. I will try to iteratively enhance it. Do let me know if you have any suggestions or find something that should be covered and the same will be accomodated in the document.
This is Part 1 of a 2 part series. You can find Part 2 here.
A complementary installation guide to openSAP “Developing Java-Based Apps on SAP HANA Cloud Platform” MOOC (Week 1) – PART 2
http://scn.sap.com/docs/DOC-75212
Create a free SAP Hana Cloud Platform Trial Account
Trial Account | Link |
---|---|
SAP Hana Cloud Platform Trial Account Registration | https://account.hanatrial.ondemand.com/ |
After registration your should get a user name which should be similar to “p123456” and your account name will be “p123456trial” where 123456 will be some other number.
Download JDK and set JAVA_HOME and PATH environment variables.
Download | Link |
---|---|
JDK 7 (64 bit) | http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads- |
Set Environment Variables JAVA_HOME and PATH
Test that the environment variables JAVA_HOME and PATH are set properly by echo command on CMD.
Please note:
JAVA_HOME = Java main folder
PATH = path till bin inside Java main folder
echo %JAVA_HOME%
echo %PATH%
Test that Java is available on CMD
Download Eclipse Mars/Neon
Download | Link |
---|---|
Eclipse IDE for Java EE Developers (64 bit) | https://eclipse.org/downloads/eclipse-packages/ |
In my case the latest Eclipse Neon was giving trouble so I just switched to older Eclipse Mars that I already had.
Run Eclipse, choose workspace location. In my case I kept my workspace within my Eclipse folder in case I use more than one Eclipse on my system.
Eclipse Plugins | Link |
---|---|
SAP Hana Cloud Paltform Tools & SAP HANA Tools |
For Eclipse Neon (4.6), use https://tools.hana.ondemand.com/neon For Eclipse Mars (4.5), use https://tools.hana.ondemand.com/mars |
Install the plugins. This takes a couple of minutes.
Eclipse Plugin | Link |
---|---|
EGit |
Information Page : http://www.eclipse.org/egit/download/ Plugin Link |
Same process as for the last two plugins. This takes a couple of minutes.
We need Maven too but we do not need to install the plugin as it comes preinstalled with Eclipse for J2EE.
GIT Configuration
Maven User Settings
The settings.xml file has to be created the first time under the .m2 directory.
Remove the comments when copying xml.
You can remove the proxies tag and its contents if you are not using a proxy.
Or you can write false in the <active> tag.
//Start of settings.xml
<settings xmlns=“http://maven.apache.org/SETTINGS/1.0.0“
xmlns:xsi=“http://www.w3.org/2001/XMLSchema-instance“
xsi:schemaLocation=“http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd“>
<localRepository>${user.home}/.m2/repository</localRepository>
<profiles>
<profile>
<id>development</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
</properties>
</profile>
</profiles>
<proxies>
<proxy>
<active>true</active>
<protocol>http</protocol>
<host>proxy</host>
<port>8080</port>
</proxy>
</proxies>
</settings>
//End of settings.xml
Set JDK in Eclipse. This steps avoids problem with Maven build process later.
NOTE : This step is important. If not done, your maven build will fail in later steps.
Tools | Link |
---|---|
HANA Cloud Paltform SDK | https://tools.hana.ondemand.com/#cloud |
Download the following files.
And setup these as Server Runtime Environments
Clone the GIT repository in the EGit perspective in Eclipse.
GIT Repository | Link to GIT Repository |
---|---|
ESPM V2 | * https://github.com/SAP/cloud-espm-V2 |
Copy (CTRL + C) the ESPM Git Repository Path (*) above and right click in the Git perspective
Just click Next
Next again, no rocket science involved so far. Just check that all branches are selected.
Finish the wizard. This takes a couple of minutes.
AHOY ! Repository cloned. You can see the branches too as we selected in the wizard.
Import existing Maven project in J2EE Perspective
Select the ESPM project in Git folder hierarchy and finish the wizard. This takes a couple of minutes.
It should be something like :
C:\Users\<username>\git\cloud-espm-V2
Select ESPM main project -> Right click -> Maven -> Maven Update Project
Select ESPM main project -> Right click -> Run As -> Maven build…
Enter “clean install” in Goals and then Run. This takes a couple of minutes.
This should ideally result into 3 SUCCESS messages
Right click on Project Explorer and refresh and you would see that a new deploy folder is created with a .war file inside post build process.
We will deploy this .war file in the Hana Cloud Platform Cockpit in the Java Applications area
For some reason SCN is not allowing me to add more screenshots so I will have to continue in another document.
This is Part 1 of a 2 part series. You can find Part 2 here.
A complementary installation guide to openSAP “Developing Java-Based Apps on SAP HANA Cloud Platform” MOOC (Week 1) – PART 2
http://scn.sap.com/docs/DOC-75212
Thanks, very detailed post...
Thank you, Amol, this guide was very helpful.
Regards, Alexandra
Thanks for your appreciation Dr Alexandra.