Skip to Content

How to install SAP HANA Studio for Mac OS X – and build your first XS app in HANA SP07

This is a pretty trivial thing but I keep looking for the URL and can’t find it, so it can’t be that easy to find. So I thought I’d write a document so I can find it in future. Maybe it helps someone else 🙂

As a bonus, we then go on to configure the Developer perspective and build our first Hello World XS app using the new HANA SP07 Team functionality.

There is no current supported version of SAP HANA Studio for Mac as of SP07 – we hope for a version to come in the future. But, there is an internal build that SAP use, and our friends at the SAP HANA Developer Center made it available for us to use! It is available on the SAP HANA Developer Center page. This version is usually a few revisions behind the current revision of SAP HANA Studio, and is only updated from time to time, and explicitly offers you no formal support.

Edit – for now, it’s not available on the Dev Center page but you can download the old version directly from here.

You can go ahead and download it now! I find the SAP HANA Developer Center gives me great download speeds, so it’s downloaded whilst I wrote this paragraph! It will appear in your downloads as a GZ file:

Screen Shot 2013-12-18 at 6.03.45 PM.png

Double click on the GZ file and it will quietly create a folder called hdbstudio, which you can navigate into. Be careful, because this folder will have an older date so you may not spot it!

Screen Shot 2013-12-18 at 6.06.37 PM.png

I copy this top level folder into the Applications folder – HANA doesn’t do this automatically, at least for now! I already have a version there, so it prompts me to copy it.

Screen Shot 2013-12-18 at 6.07.25 PM.png

Then, I open the hdbstudio folder and drag the hdbstudio Application onto my taskbar. It looks like this:

Screen Shot 2013-12-18 at 6.08.41 PM.png

If you are running a new-ish version of Mac OS X it won’t let you run this file – it will give you this error message: “hdbstudio” can’t be opened because it is from an unidentified developer.

Screen Shot 2013-12-18 at 6.09.43 PM.png

Not to worry… press Apple –> System Preferences –> Security & Privacy. You should see the following:

Screen Shot 2013-12-18 at 6.11.21 PM.png

You can go ahead and click Open Anyway!

Screen Shot 2013-12-18 at 6.11.52 PM.png

Click Open. Yay… along comes HANA Studio!

Screen Shot 2013-12-18 at 6.12.01 PM.png

Here it is in all its glory…

Screen Shot 2013-12-18 at 6.20.33 PM.png

If you’re new to SAP HANA, here’s how to connect. Click Open Administration Console –> Right click and click Add System

Screen Shot 2013-12-18 at 6.21.23 PM.png

Enter the system details, username and password and click “Save to Secure Storage”

Screen Shot 2013-12-18 at 6.22.07 PM.png

Now you have your HANA system, with the Rev.68 version on Mac you should be able to use the developer tools without regi.exe – and so do native development. Select Window -> Open Perspective -> Other -> SAP HANA Development and press OK:

Screen Shot 2013-12-18 at 6.26.48 PM.png

Select Repositories -> Create Repository Workspace:

Screen Shot 2013-12-18 at 6.29.15 PM.png

Screen Shot 2013-12-18 at 6.28.38 PM.png

You can now browse the repository workspace on your HANA Server. Here is some SAP-delivered content:

Screen Shot 2013-12-18 at 6.32.17 PM.png

Now you can click the Project Explorer View and select New -> Project:

Screen Shot 2013-12-18 at 6.32.56 PM.png

We have to drill in to find the HANA XS Project:

Screen Shot 2013-12-18 at 6.33.37 PM.png

As of HANA SP07 I can just give the project a name… and select the default location.

Screen Shot 2013-12-18 at 6.34.24 PM.png

Now I have to share my project back to the HANA Server using the Eclipse Team functionality. Right click your project and select Team –> Share Project:

Screen Shot 2013-12-18 at 6.35.31 PM.png

You can give it whatever name you want, depending on where you want your project to end up in the SAP HANA Repository. I choose a location provided to me as a test area. Note that by default the project will create a subfolder, so my location will actually be trainingContent.trainees.USER11.xstest:

Screen Shot 2013-12-18 at 6.38.52 PM.png

That’s it! My Project is configured and ready to go! Note that my project appears with a * next to it – meaning “unsaved”, until we have some active content.

Screen Shot 2013-12-18 at 6.40.11 PM.png

For bonus points… let’s go ahead and configure a simple Hello World scenario. Right click your project, select New -> Other and browse for the XS Application Descriptor File:

Screen Shot 2013-12-18 at 6.42.06 PM.png

Go through the wizard and finish up – don’t change any settings. Then right click, select Team -> Activate.

Screen Shot 2013-12-18 at 6.43.09 PM.png

Repeat the same with the XS Application Access file – and activate it. Your project should look like this, and you’re ready to go:

Screen Shot 2013-12-18 at 6.44.54 PM.png

Now let’s create a simple index.html – right click your project, select New -> File -> index.html. It will open in a browser so close the browser, right click index.html and select Open With -> Text Editor.

Screen Shot 2013-12-18 at 6.46.44 PM.png

Then type Hello World… Save… and activate. We’re done! Our Hello World example is exactly where you would hope. Note that it is our server name, followed by port (8000+system number), then our repository location that we configured, our project name, and index.html. Super simple!


Screen Shot 2013-12-18 at 6.48.29 PM.png

Final Words

I hope this helps someone get up to speed with HANA development fast! Note that if you are a HANA SP06 developer then this process is slightly different – and much simpler and more sensible.

A quick thanks to Rich Heilman and @Thomas_Jung for helping me out when I came to configure my first system. The differences between SP06 and SP07 left me confused.

Happy developing!

You must be Logged on to comment or reply to a post.