Skip to Content
Technical Articles
Author's profile photo Søren Hansen

Install ABAP Developer Edition (HANA 1909) system on your own PC – the Very Easy Way…..

There are many reasons why you would like to have a local ABAP system installed on your PC. Maybe you don’t have access to any ABAP system, and just would like to try out some ABAP development. Or maybe you are like me, who has a lot of experience doing ABAP development, but not so much on the Basis side. And would like a system to play around in, where you can try different settings without ruining it for a lot of people.

A couple of years back I fiddled around with installing an ABAP system on my laptop using these guides:

https://github.com/larshp/nwabap751

https://github.com/nzamani/sap-nw-abap-trial-docker

It was a little tricky, but doable to install your own ABAP system on a laptop/PC.

Now SAP are delivering a formalized way to install the newest ABAP Developer Edition system in a VERY EASY way.

To boil it down, you just have to install a program (Docker Desktop) and then issue 2 commands in cmd.exe, then you have a running SAP ABAP system – it does not get easier than that.

In this blog I will show all the details for getting the server installed and how to start and stop it. It is very easy, and anybody can do it.

I am on a Windows 10 laptop, but this also works for MacOS and Linux. Refer to the documentation for details on these OS’es.

 

If you want the really short guide, then here it is:

  • Create a user on https://hub.docker.com/
  • Download and install Docker Desktop
  • Open cmd.exe and issue command:
    • docker pull store/saplabs/abaptrial:1909
    • This will download and extract everything (appr 25 GB) and takes 20-30 min depending on your bandwidth.
  • In cmd.exe issue command:
    • docker run --stop-timeout 3600 -i --name a4h -h vhcala4hci -p 3200:3200 -p 3300:3300 -p 8443:8443 -p 30213:30213 -p 50000:50000 -p 50001:50001 store/saplabs/abaptrial:1909 -agree-to-sap-license -skip-limits-check
  • You now have a running SAP ABAP HANA 1909 system on your PC.

 

The longer version is here…

Check out the ABAP section of the official site for downloading (free) software from SAP.

https://tools.hana.ondemand.com/#abap

This refers to this blog:

https://blogs.sap.com/2021/02/15/sap-abap-platform-1909-developer-edition-available-soon/

Which again refers to:

https://hub.docker.com/_/sap-abap-trial/plans/ac8a4f9b-ae29-4afa-9b39-25aeea24b821?tab=instructions

The above links are the basis for this guide.

 

Please be aware of the system requirements. You need 16GB RAM for Docker, which means you probably need at least 24GB RAM in total. You also need appr. 170GB of free disk.

I am lucky because I have just gotten a new laptop. I use a Lenovo X1 Carbon Win10 with 1TB SSD and 32GB RAM. On this machine I don’t have any problems at all. The ABAP server runs smoothly.

Please let me know in the comments, if you can get it up and running on smaller configurations.

The ABAP NW751 server I mentioned in the beginning, was able to run on Windows 10 with just 8GB of total RAM on the laptop.

In the following I will go through each step one at a time.

 

Step 1. Create a Docker Hub user (free)

Go to https://hub.docker.com/ and click the ‘Sign Up’ button.

 

Step 2: Download and install Docker Desktop

Login to https://hub.docker.com/ via ‘Sign In’-button

Click ‘Download for Windows’ (if you are using Windows 😊)

Now install Docker Desktop

 

Step 3: Start Docker Desktop

When starting Docker Desktop it should look like the above.

 

Step 4: Pull (download and extract) Docker container data

Open cmd.exe and issue command:

docker pull store/saplabs/abaptrial:1909

It will now start downloading data (the biggest file is 23.52GB)

Please note:

It does not matter from which folder you issue this command. I did navigate to a specific folder, because I was unsure if it would download data to this. It turned out that all data is downloaded to Docker controlled folders.

After download, extraction begins.

When everything is downloaded and extracted you will see the above.

 

Step 5: Define and start your Docker container

Refer to this guide for details on startup parameters and troubleshooting.

In cmd.exe issue this command:

docker run --stop-timeout 3600 -i --name a4h -h vhcala4hci -p 3200:3200 -p 3300:3300 -p 8443:8443 -p 30213:30213 -p 50000:50000 -p 50001:50001 store/saplabs/abaptrial:1909 -agree-to-sap-license -skip-limits-check

Now your SAP system is up and running.

And you can now see the Docker container running in Docker Desktop

 

Step 6: Stopping the server

In Docker Desktop click the container ‘a4h’

Simply click the ‘Stop’-button to shut down the server.

Docker will ensure this is done gracefully.

When you see this the server is completely shut down.

 

Step 7: Starting your server

To start your server just mouse over the ‘a4h’-container and click the ‘Start’-button.

If you click on the container name and click ‘LOGS’, then you will see a command prompt on the status of the startup.

When it has started completely, you will see this message.

 

Step 8 (optional): Adjust your hostfile

The hostname of the new server is ‘vhcala4hci’, but it is hosted on your PC (localhost) so in order to be able to use URL’s generated on the server, you can define a mapping on your local PC, which is done in the hosts file.

Procedure:

Open Explorer and go to directory C:\Windows\System32\drivers\etc

Open file ‘hosts’ and add these lines to the bottom of the file

# SAP System A4H Developer Edition on Docker
127.0.0.1 vhcala4hci
# End of section

PS: I did not have permission to the save file onto itself from notepad. So I copied the file to another location and made the changes there. Afterwards I replaced the old hosts file with the new one.

 

Once you have this in place, you will be able to open URLs with the hostname of you server.

E.g.: http://vhcala4hci:50000/sap/opu/odata/IWBEP/GWSAMPLE_BASIC/?$format=xml

If you don’t make this adjustment you can just call the URL’s by replacing the hostname ‘vhcala4hci’ with ‘localhost’.

 

Step 9: Login to yor SAP system

Open your SAP GUI logonpad and create a new connection.

Parameters for SAP GUI (sorry for danish labels).

Credentials are found here

User name: DEVELOPER

Password: Ldtf5432

We are now logged in.

 

That’s it – good luck and happy testing.

Assigned tags

      12 Comments
      You must be Logged on to comment or reply to a post.
      Author's profile photo Felipe Silva
      Felipe Silva

      I think it cant get easier than that! Thank you for sharing

      Author's profile photo mus cat
      mus cat

      Thats very good. Am not a basis person but an ABAP beginner. Does it have some sample data in the tables? What all do we need to do before writing an ABAP in this newly installed system.

      Author's profile photo Felipe Silva
      Felipe Silva

      I think this is more to showcase the technology rather than the ERP. So don't expect it to have SAP modules, with its tables and bapis.

      This is to have your own dev box, test out cds, rap, abap in general. All custom.

      Author's profile photo Marc Bernard
      Marc Bernard

      Nice summary. It's short because you skipped a few things like installing SAPGUI or ABAP Dev Tools. Also good idea to read the license once so you know what you are allowed to do with the system 😉

      PS: If you want to logon using HANA Studio, you also need to open port 30215 (-p 30215:30215).

      Author's profile photo mus cat
      mus cat

      Followed above steps till step7. But what to do to open up the SAP GUI / Download it ?? ( on Windows)

      Author's profile photo Michael Schliebner
      Michael Schliebner

      Dear mus cat

       

      SAP GUI / Download can be found here:

      Get Started with Free Trials and Downloads

       

      Enjoy & Have fun!

      Author's profile photo Alexander Michael Stier
      Alexander Michael Stier

      To get permission to save the file onto itself, you need to run the editor with the  "run as administrator" command. Go to the Windows Start Menue, select the application i.e. notepad and right click, then select "run as administrator".

      Author's profile photo Marçal Oliveras
      Marçal Oliveras

      Thanks! Now I just need to double my laptop memory!

      Author's profile photo LEONARDO PAVIA
      LEONARDO PAVIA

      Nice blog post, thank you. I have a question, is it possible to install this image in other drive rather than C:? My system drive is running low of space, but I have another disk drive plenty of space.

       

      Best regards

      Author's profile photo LEONARDO PAVIA
      LEONARDO PAVIA

      I found this guide for Docker Desktop on Windows. HowTo: Change Docker containers storage location with WSL2 on Windows 10 | Coding with Titans (codetitans.pl)

      Just tried it and works perfectly.

       

       

      Author's profile photo Bartho Mac
      Bartho Mac

      Worked for me, but I added the port 30215 (-p 30215:30215) as Marc Bernard mentioned. I also needed to replace the "" (in –stop-timeout and –name) with "--".

      So my command is:

      docker run --stop-timeout 3600 -i --name a4h -h vhcala4hci -p 3200:3200 -p 3300:3300 -p 8443:8443 -p 30213:30213 -p 50000:50000 -p 50001:50001 -p 30215:30215 store/saplabs/abaptrial:1909 -agree-to-sap-license -skip-limits-check
      Author's profile photo Georgi Slavov
      Georgi Slavov

      On a Windows10, 16 GB system, i am getting an error that the Worker Process start command fails(10 unsuccessful attempts ):

      08.09.2021 07:59:38
      StartWait
      FAIL: process disp+work Dispatcher not running
      Worker Processes: the start command failed, exit code=2
      The service Worker Processes has failed to start and initialization is blocked until the problem is resolved
      You can try your luck 4 times until initialization is terminated
      Hint: docker containers can be joined by: docker exec -it <name> bash
      Hint: HDB license must not be expired
      Hint: HDB must be running
      Hint: AS ABAP license must be valid
      Hit Return to continue
      Worker Processes: starting

      This is probably the result of insufficient memory, or? I followed the short instructions, one to one.