Technology Blogs by SAP
Learn how to extend and personalize SAP applications. Follow the SAP technology blog for insights into SAP BTP, ABAP, SAP Analytics Cloud, SAP HANA, and more.
cancel
Showing results for 
Search instead for 
Did you mean: 
Rui-Nogueira
Advisor
Advisor

Overview

ENROLL TO THE COURSE HERE (in case you haven't, yet): Course: Introduction to SAP HANA Cloud Platform (repeat)

You can find a list of the course guides for each week of this course in the corresponding parent project of this blog post.

Course Guide Week 1 - Basics

Hi everyone,

the first week of the openSAP course Introduction to SAP HANA Cloud Platform (repeat) will provide you with some basics around the platform.

We'll look into cloud services in general and into SAP HANA Cloud Platform specifically including the development environment and its' setup.

At the end of this week you'll have your first application deployed in the cloud and on your local environment.

This document is a detailed blog post around all the units of week 1. The parent document of this blog post provides you with an overview about all blog posts I'll write throughout the weeks of the course.

Table of Contents

Unit 1 - Basics

Definition of Cloud Services

You can find more detailed explanations around the definition of Cloud Services on various places.

The one I really like is on Wikipedia, that you can find under http://en.wikipedia.org/wiki/Cloud_services#Services

The  SAP Data Center

You can get detailed information about the SAP Data Center on the SAP Data Center home page.

Integration With Other Systems

SuccessFactors Integration

Be informed that we are planning to hold a complete new course around extensions on the SAP HANA Cloud Platform.

Stay tuned for more information, we'll share it soon.

Unit 2 - Your Account

Getting An Account

Find a more detailed explanation on the official documentation.

Pricing For Various Packages

Get a detailed drill-down of the prices and the various resources you can purchase for the SAP HANA Cloud Platform here.

Different Design on Account Cockpit

You'll find a difference in the look-and-feel of your account cockpit compared to the one you see in the videos.

This is due to a change in the colors of the user interface. There are also additional tabs due to an update of the platform with additional functionality.

In the new design the "Applications" have been renamed to "Java Applications".

You also have a new tab called "HANA Packages" for the HANA XS applications that you can also deploy on SAP HANA Cloud Platform.

For the oAuth support there is also an additional tab called "oAuth".

Former design:

New design:

Unit 3 - Setting Up The IDE

System Requirements

Read the list of product restrictions to get to know how you can use the SAP HANA Cloud Platform.

Setting up JAVA

You need Java 6 or Java 7 installed on your machine. You need also to make sure that the java path is set in the "PATH" environment variable and also as "JAVA_HOME" - Get more details.

Open a command window in the <HCP_SDK_PATH>\tools folder. Execute "java -version" to check what is the version of your java and verify that it is the one you expect. <HCP_SDK_PATH> is the path in the file system where you unzipped the HANA Cloud Platform SDK.

You can check if the JAVA_HOME is correctly set by executing the “set” or “env” command – both commands are listing all the environment variables you have.

Java 1.8 is not supported.

SAP HANA Tools: For Eclipse Kepler only

In case you are running Eclipse Juno you are not able to select the SAP HANA Tools. The SAP HANA Tools are available only for Eclipse Kepler.

So in case you want to install them you need to use Eclipse Kepler.

Issues with installing Eclipse

In case you have issues with installing Eclipse, please check-out this thread first to find out if you can fix it with the hints provided there.

Port Number Of Local SAP HANA Cloud Platform Server

When adding a server of type "SAP HANA Cloud local runtime" it can happen that you'll be assigned another port than 8080 to that server. This is the case whenever that port is already used by an application running on your machine.

For the course this is no issue at all. Simply use that port instead of the standard port 8080. If you forgot the port number of your local SAP HANA Cloud Platform runtime just double-click on the server entry in Eclipse and you'll see the port inside the newly opened window in Eclipse (see screenshot below):

On Windows you can find out which applications are running on which ports with the following commands in your command line:

netstat -a -b -p TCP

There should be a line like

TCP    0.0.0.0:8080

or

TCP 127.0.0.1:8080

In the next line the file name of the program is given.

Using other JRE than JRE 6

Nearly all of the sample projects use JRE 6. In case you have another JRE installed on your machine you can either install JRE 6 on your machine and point Eclipse to that installation (Eclipse Preferences>Java>JRE).

Alternatively you change the project properties of each sample project by right-clicking the project and clicking on Properties > Java Build Path > Libraries. After that double click the JRE System Library entry and select the other (Alternate) JRE you are using:


Using the SAP JVM

For those of you installing the sap jvm don't forget to add this setting to the eclipse.ini after the -vmargs option:

-XX:MaxPermSize=256m

Without this you will experience weird things with eclipse hanging all the time.

Get more details about this at https://help.hana.ondemand.com/help/frameset.htm?76137f42711e1014839a8273b0e91070.html.

Unit 4 -  The Development Environment

Introduction to Eclipse (and Java)

In case you have no experience at all with Eclipse I can recommend the free video course Eclipse and Java for Total Beginners. The course assumes you have no experience with Eclipse or Java and brings you up-to-speed in 16 lessons.

Unit 5 - Deploying The First Application

Common Issues

When deploying your first application to the cloud you might run into some  issues listed below with some measures to fix the issues.

Using Wrong Connection Details / Authentication Issues

The most prominent one is the usage of wrong connection details.

Ensure you are using the correct host for your trial account. This is hanatrial.ondemand.com and NOT hana.ondemand.com

Also be sure to use the correct account name and user.

The account name is something like Pxxxxxxxxxxtrial and the user name is Pxxxxxxxxxx.

You can get your account name at your account cockpit. It's at the top left corner under the text "Account".

In such cases you should follow the following steps:

  1. connect to your HANA Cloud account cockpit (https://account.hanatrial.ondemand.com/cockpit) with your credentials
  2. Can you connect to that? If yes, move on with step 3. If no, please check your credentials again and go to step 1
  3. Check the account name that is displayed on the top left under "Focus Object", "Account". This should be something like xxxxxxxtrial where xxxxxxx is your username
  4. Now switch to Eclipse and follow the instructions from 05:42min to 07:04min. Check your proxy settings in case you are working behind a proxy! Ensure you are using the account name and the user you saw on your cockpit. Don't forget that the host is hanatrial.ondemand.com and NOT hana.ondemand.com
  5. Add the application to your server as shown from 08:18min to 08:37min.

If you follow those steps you should be able to deploy the app.

Forgotten Password /Authentication Issues

Sometimes users forget their password for their account or don't know it (e.g. if they are SAP employees that get to the account cockpit with SSO).

In such cases you can follow these steps:

  1. Go to https://account.hanatrial.ondemand.com/
  2. If you don't see the Register button please log off by clicking on the corresponding icon on the top right
  3. Click on the Register button (yes, please click on Register although you are already registered 🙂
  4. Now don't fill out any fields besides the field for your email address
  5. Once you've typed-in your email-address switch to another field in the form
  6. You'll get a little pop-up window next to your email-address where you need to click on the link "Forgot Password"
  7. Once you've clicked on "Forgot Password" you'll receive an email with an activation link
  8. Copy-and-paste that link (and don't click on it) into your browser
  9. You'll now be able to provide a new password. That's the password you'll need to deploy applications to your SAP HANA Cloud Platform account

Please be aware that you can change your password only once within every 24 hours.

Could not reserve enough space for object heap

If you get this message in the Console view of your Eclipse when deploying an application to your local machine you can try the following possibilities:

  • Possibility 1: You've installed a 32bit Eclipse on a 64bit computer. Try using the 64bit Eclipse on your 64bit computer and check if that helps.
  • Possibility 2: You might be able to fix it by increasing the Timeout setting of the local server runtime. This issue can happen if you have a very slow computer.
    To do that you double-click on the local server in the Servers view in Eclipse. A new window for the server's properties opens up and you select  "Timeouts" and set "Start" to 120 seconds.
    Thanks to stuart.pratt2 for this hint that he added as a comment to this blog post.
  • Possibility 3: Following the same steps as above until you see the window in your Eclipse for the "SAP HANA Cloud local runtime". Click on "Open launch configuration", switch to the tab "Arguments" and under "VM Arguments" search for the text -Xmx1024m and substitute it with -Xmx512m. Save your changes (click on Apply and OK) and try again.

Less Common Issues

Error message: 'Server SAP HANA Cloud local runtime failed to start"

'findstr" is not recognized as an internal or external command

When switching to the Console view you  see an error message telling you that 'findstr" is not recognized.

The problem is most probably related to your system PATH variable. This means that C:\Windows\System32 is not inside you PATH. Just add it and restart Eclipse and this should work. Find some detailed descriptions how  to add something to your PATH in these instructions:

Best,

Rui

57 Comments