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
Turn on suggestions
Auto-suggest helps you quickly narrow down your search results by suggesting possible matches as you type.
Showing results for 
Search instead for 
Did you mean: 

SAP HCP openSAP course guide week 1

Rui-Nogueira
Product and Topic Expert
Product and Topic Expert
‎2013 Oct 28 8:05 AM
21,521

[Update: This course is being repeated with updates]

Hi everyone, please be informed that the course "Introduction to SAP HANA Cloud Platform" was updated with new functionalities of the platform. Some of the units from the first course in 2013 no longer work seamlessly. To avoid issues on your side, please look into the repetition of the course "Introduction to SAP HANA Cloud Platform". There is also a course guide available with the links to all blog posts I wrote for the updated course.

Course Guide Week 1 - Basics

Hi everyone,

the first week of the openSAP course Introduction to SAP HANA Cloud Platform 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

Introductory video

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

Unit 2 - Your Account

The Most Important Links

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.

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.

Running SAP HCP Tools in Eclipse on Windows 8

After installing SAP HANA Cloud Platform Tools and restarting Eclipse, there is no "SAP > SAP HANA Cloud" node in the "New Server Runtime Environment". My colleague vladimir.pavlov provided a blog post with a workaround for this issue.

The Most Important Links

Unit 4 -  The Development Environment

The Most Important Links

Introduction to Eclipse

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

7

Common Issues

When deploying your first application to the cloud you might run into some  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:

The Most Important Links

Best,

Rui

47 Comments
Labels in this area
Popular Blog Posts