miniSAP Installation – Part 3


Installing miniSAP on our new Linux system

You are one step closer to owning your own Personal SAP System. In Part 1, we Installed Linux Mint for our SAP system and in Part 2, we Configured the Linux system for our SAP Installation. In this part, we will install miniSAP on the Linux system which we have installed and configured.

Now is the time to pop open another beer. A big one, if you bought them in several sizes. 😛

Remember all the .rar files that we’ve downloaded, containing the SAP system? Let’s decompress them to the Shared Folder. First copy the files to the Shared Folder.

Now let’s extract them. I use 7Zip, which I’ve grown fond of, but there are several programs to extract .rar files available. Use the one you prefer:

How to install SAP IDES for FREE and get your access now

Sit back. Watch a couple of episodes of that amazing show that is on TV that you love so much, and let’s wait for the extraction to be completed. I’ll be here when you get back.

So you’ve extracted the files into the Shared Folder. Now it’s time to start the SAP installation, per se. Just write the following commands:

…where <your shared folder name> is the name of the Shared Folder, in my case sf_SharedFolder.

This command lists the files on the current folder. You should see something like this.

How to install SAP IDES

In case you still have them, you can get rid of the .rar files, since they’re only taking up space:

How to have free online access to SAP

Then you set the permissions for the install script to be executed.

And run the installation script (the -g flag means that we will be running the GUI version of the installer. If you want to have just the command line version, omit the -g):

Oops! Error!

SAP IDES for practice

This is because we’re missing one final step. You know when you enter a new server on SAPGui. How would we do that in this case, since we don’t know the IP address of our SAP system?

First, write.

on the terminal.

inet addr

See where it says inet addr? That’s our IP address. Save it on a paper somewhere. We’ll need it now and later on when we’re configuring SAPGui.

Now write.

(I prefer vim, but nano is more user friendly for beginners, and I don’t want to enter an emacs vs vim war, so let’s go with that). 🙂

On the second line, we see our hostname, but the IP address is a local one. We’ll have to comment this line and add our own IP address. To comment, you use a # symbol. In the end, it should be something like this.

comment in Linux

Just use your own IP address and not the own shown above, and we’re all set. To leave this program, press CTRL+X, press Y to confirm that you want to save, and press ENTER to confirm the file name:

personal SAP System

Now we can repeat the sudo ./ -g command from before.

Press ENTER and read carefully the licence agreement… or scroll down (tip, to scroll down faster, keep pressing SPACE – it works like PAGE DOWN on these unix walls of text).

At the end of the license agreement write yes and press ENTER.

install SAP IDES for Free

Now choose a password. I’ve used the same one as my Linux system, so I don’t forget it. It will be used for administrative purposes, and remember the rules (at least 7 characters, with at least a capital letter, small letters, digits and no other characters. Again, we’re going to go here with Abap2017).

SAP ABAP System for Practice

And now you can get the rest of the six pack because it will take a while… actually, go buy another one from the grocery store. This screen will be greeting you when you come back home. 🙂

step by step installation of sap system for free

Are you back? OK, then. After a while, you’ll see some more familiar SAP colors. 🙂

If some error happened, you can contact us through the comments section, and we’ll try our best to help you out. In my case, I had a failure on the first installation and so I repeated it. If that happened to you, I suggest you to delete everything in the /sapmnt folder.

Attention – do only the following line of code if the installation failed for some reason.

In my case, I tried to reinstall without deleting, so for those to which that happened, the following screen may appear. You’ll just click Next while selecting the first option.

SAP System Installation on Personal Laptop for free

Here we won’t change anything as well, so just click Next (and another – tiny – sip of beer…). 😀

For a changeJust 4 Versions of the same program to understand OOPs ABAP

SAP System Parameters in miniSAP

This next screen seems scary, but we’ll continue using the old aunt approach, by clicking Next. 😀

Software Provisioning

And then we will disobey a bit by saying No (otherwise it would repeat the pre-requisites check):

Guess what button we will be pressing now? That’s right, Next. 😉

SAP IDES Installation for Free

This next screen is a bit more serious. We need to setup the password for the npladm user, which is the user responsible for starting our SAP instance. It’s better if we use the same password we’ve used before, to keep consistency. After all, this is not a production machine. This is a machine used for our own training, and as long as we keep our personal computer safe, there shouldn’t be a problem in using the same password throughout our SAP system. As long as we don’t forget that one password…

After the password is set, you can press… Next (notice that it is using the csh login shell that we installed earlier. Later we will see it in action).

how to access SAP for free?

The same applies to the following screen.

SAP Practice Server

In this screen, we leave the default settings and press… Next (hey! I just remembered a nice drinking game!).

my sap practice server

In the next screen, we’ll leave it as it is and press Next. This screen is for the setting of the database users’ passwords. (Note: I don’t know if we can set our own passwords here. The installation always worked fine without touching this screen, so I prefer to err on the side of caution. If someone has any information regarding this, please leave a comment).

Here we change to Default Key and press Next.

How to create your own Mini SAP

Since we won’t be executing our SAP system from outside our home, we leave the default DNS settings (we would have to set up a server to access it from outside our local network. That is something we’ll not be getting into here).

Press Next.

setting up personal SAP System

Again here, press Next.

how to learn and practice SAP?

And here… Next.

Step by step instruction to install mini SAP

In the next screen, we have a summary of all the settings we’ve chosen, which allows us to change anything, in case we made any mistakes. Since we are happy with our work so far, let’s click Next.

get your own SAP IDES server

Did you actually manage to get another six pack from the grocery store? No? Then go back. 😀 This will take a while – SAP is finally installing.

Free SAP System

During this part of the installation, you may face some errors, like this.

sap system rename

My best tip to take care of these errors is to delete the temporary installation folder and the SAP NPL installation folder and try to do it again. If that doesn’t work, then install Linux again and be careful to provide a password that complies with the restrictions mentioned before.

But the best tip that I’ve read concerns the error Unable to generate a new password for database login ‘sa’. This error occurred to me several times but the only way I’ve managed to address it is by following the instructions contained on the PDF of this URL, and also by deleting the temp and SAP NPL installation directories.

To delete the folders, write the following on the terminal.

This is the step in which your patience is required, because some things can go wrong and you have to keep trying to make it work. Be patient, delete the folders, follow the (thankfully short) instructions on the PDF mentioned above and it eventually work out. I’ve installed SAP on four computers, two of them went without a hitch, another went… OK… and the last one went totally berserk. But we got there!

Also Read: Struggle of an ABAPer in SAPUI5.

And finally, if all goes well, you’ll reach something like this, in which you just press OK and we’re done.

how i installed my sap system on my personal laptop

The next highlighted sentence should be a good reason to take a good swig at your beer. 😀

Installation of NPL successful

A final configuration is needed, in case we want to develop WebDynpro or SAPUI5 applications – that require the browser to recognize your hostname.

List the files in /usr/sap/NPL/SYS/profile.

Notice the NPL_D00_vhcalnplci file? Open it:

Go to the SAPLOCALHOST line and write under it:

It should look like this.

SAP Local Host

Save it and then we can proceed to install SAPGui… I promise, that would be our last part and you would be able to write your first Program on your virgin SAP system. 🙂

…on Part 4!

The other parts of this article can be accessed on the following links:

Part 1 – Linux Mint Installation

Part 2 – Configuring Linux for the SAP installation

Part 3 – Install SAP on Linux System

Part 4 – Installing and configuring SAPGui


  1. Hi Sérgio Serra,

    I have had a problem when I finished change host and then executed the command “sudo ./ -g” but the problem persist, “the hostname you have chose….”. Any suggest ?

  2. Hi Sergio, Thanks for the wonderful step-by-step guide.

    I’ve run into the same problem of DNS not being determined.
    Unable to determine parameter “DNS domain name”. DNS domain name is not configured in resolv.conf (UNIX) or the registry (Windows) and neither getaddrinfo nor gethostbyname could retrieve it.

    I’ve done some research and found one tip which did the trick for me. I understand it has been a while so that the others might have already solved the issue but no posting on how the issue was resolved.
    So thought I’d share with everybody.

    In the host file (sudo nano /etc/hosts) I put extra wording(?) after vhcalnplci so that it reads now “ vhcalnplci vhcalnplci.dummy.nodomain” which I believe you mentioned to do after the installation.
    So if anyone has still the same issue then should give it a try.

    Now I am facing another issue which I saw a few people have already mentioned in part 4. It’s now asking for developer key and the key you provided is perhaps for your user id. Any ideas on how to go about getting the developer key? I don’t have S-id and running out of ideas.

  3. Hola Sergio!

    Thank you very much for this tutorial! I just don’t understand why you didn’t elaborated more the way of how to solve the issue with the “Unable to generate a new password …”-issue. If I may share my wisdom after failing at this (Point 18 of the Installations) for sth like 8 times: This is due to an expired license. The solution what helped for me was downloading the .lic file from the “PDF”-Link you provided, and sudo copying it to

    sudo cp SYBASE_ASE_TestDrive.lic /sybase/NPL/SYSAM-2_0/licenses/

    In the net there were several attempts of this, and for me a little bit confusing (like unzipping, copying the license-file, and then zipping again the file /server/TAR/x86_64 etc.)

    What did it for me was to first to start the installation, until the error occured at Point 18, and then NOT CLOSING the installation-dialogue, but opening a new terminal, sudo copying the beforementioned file to the folder, and clicking on “continue/redo” something like that, such that the installation-routine does not overwrite the file with the deprecet one, and just continuous from that particular point, reads again the (now up to date) license, and … NLP installed :).

  4. ​Hi,
    I am trying to access SAP system from browser. My basic goal is to connect sap system to webide for fiori developments.
    I have activate ping service from SICF transaction and also as mentioned in tutorial have made the entries in
    sudo nano /usr/sap/NPL/SYS/profile/NPL_D00_vhcalnplci​

    icm/host_name_full = $(SAPLOCALHOST).dummy.nodomain​

    However i get server IP cannot be reached error.
    Any inputs to guided me right direction.

    • Kunal,

      I am receiving the same error. I have modified my hosts of Windows to add the IP address with no luck. If you were able to resolve the issue, please let me know the fix.


  5. Getting below error

    An error ocurred while processing option System Rename > Standard System > SAP System Rename

    Tried removing temporary installation files. Installed linux multiple times but no luck.

    Any pointers on how to resolve this issue.

      • I’m not able to see any comments regarding the issue and how the issue was resolved.

        Can you please help me with the steps I need to take to resolve the issue.

        Thanks & Regards,

  6. I found all the 8 files (downloaded) having same content and when i am trying to unzip all files it is overwriting each other… could you please suggest whether we need to extract one zip file only or all 8 files (step 1 of this post)

  7. Hi,
    I am stuck at “sudo ./ -g”, the error displayed: “No such file or directory exists”.
    Actually, I’m getting none extra files or folders apart from the extracted 8 folders, so from where would I download the rest of it?

  8. Hi. Installation of NPL failed. Please check logifiles in /tmp/sapinst_instdir for possible root cause ia the error I am getting. This is the third time I am trying.. Still mo luck.. Kindly help me on this.. Been sitting with this for a couple of days.. 😣.

  9. Hi Sérgio,

    I am trying to install “sap_netweaver_as_abap_751_sp02_ase_dev_edition” but it got stuck at “load resource pool /tmp/swpm/resourcepool.xml” can you please let me know how can I resolve this.

    Thank you.

  10. Hi Sérgio,

    Thank you so much for your very useful article and screenshots.
    I am facing an issue in the Installation of SAP NetWeaver AS ABAP 7.51 SP2 Developer Edition “Installation of NPL failed, please check logifiles in /tmp/sapinst_instdir for possible root cause.”

    I am trying to install “SAP Netweaver as ABAP 751 sp02 ase dev edition” I have tried it 3-4 times from scratch to install it but every time, at last, it is showing me the error.
    I tried to clear /sapmnt folder also before starting the installation but still getting the error.

    Can you please help me on this.

  11. How long does the step “Set user enrvironment” usually take? last time i tried it took more than 18 hours … then i stopped the installation – nop it is in this step for 1 hours .. i am a bit afraid, that this will come again ..

  12. Installation of NPL failed, please check in logifiles /tmp/sapinst_instdir for possible root cause. This error is what im getting each time after following all the steps

    Please help i am stuck

  13. Hi,
    i run the command sudo ./ -g but now it stays at “sapmnt/NPL/profile/NPL_D00_vhcalnplci.1” … this is now for at least 9 hours …
    is there anything i could do?

    • I faced similar issue. when i used command ./ -g, the installation got stuck up somewhere. I tried this twice but it was same.
      The solution is..

      you can run it via ./

      install SAP GUI from net and try accessing it from ur windows/mac system with the ip as application server ip.

      Hope this was helpful. If not post it here again, I would be happy if I could help.


  14. Hi Sérgio,

    Any idea on what could be the cause of this error during installation?
    Unable to determine parameter “DNS domain name”. DNS domain name is not configured in resolv.conf (UNIX) or the registry (Windows) and neither getaddrinfo nor gethostbyname could retrieve it.
    Failed action: with parameters
    Error number 301 error type SPECIFIC_CODE

    Thread SLPCommunicator (139771062376192) exits with exception
    Joined thread SLPCommunicator (139771062376192), returning 18446744073709551615
    Started thread cancelExecution (139771062376192)
    Leaving state Starting
    Received response BUTTON_CANCEL_PRESSED
    Entering state Canceled
    Leaving event loop
    Thread eventLoop (139770852275968) returns with 0
    Joined thread eventLoop (139770852275968), returning 0
    Joined thread eventLoop (139770852275968), returning 18446744073709551615
    Canceling thread SLPCommunicator (139771062376192)
    Canceling thread startInstallation (139771112642304)
    Joined thread eventLoop (139770852275968), returning 18446744073709551615
    Joined thread eventLoop (139770852275968), returning 18446744073709551615
    Canceling thread SLPCommunicator (139771062376192)
    Installation of NPL failed, please check logifiles in /tmp/sapinst_instdir for possible root cause.
    working on this issue since last couple of days with no luck. Tried surfing a lot of website.
    Only got this which i think requires credential of ‘s’ id as it didn’t open with my developer id access. Error is same but solution demands authentication.

    Desperate for some help.

  15. hey Sergio, Thank you for your blog. All the time my installation stuck with this error, wondering if you face similar issue, or something which can help me in getting this installed.
    Unable to determine parameter “DNS domain name”. DNS domain name is not configured in resolv.conf (UNIX) or the registry (Windows) and neither getaddrinfo nor gethostbyname could retrieve it.
    Failed action: with parameters
    Error number 301 error type SPECIFIC_CODE

    Here is the entry from /etc/hosts, as suggested in your blog.
    192.XXX.X.XXX vhcalnplci

    I was never able to get SAP Java Installer, even though i am using sudo ./ -g

    I appreciate your inputs.

    • Hi Prakash,

      were you able to resolve the error. I am having the same error of DNS domain name. I am not getting what to do next. your help would be really appreciated

  16. Hi there!
    I’m stuck in the “Set user enviroment” step. It’s about 7 hours in this step with the message “SAP checking account sybnpl for system NPL…”
    It’s the second time I’m trying to install, both stuck in the same step… :-/
    Do you know whats wrong?

  17. Hi Sérgio,

    I am continuously failing to install the NPL with the command “sudo ./ -g”. I have downloaded 8 .rar files using FDM and extracted the contents as explained. Somehow there seems to be some problem in the extraction process with dbdata* files in server folder which i observed from the log while using 7ZIP. Eventually when i try to reinstall everytime it fails. I even tried to remove the contents from /sapmnt folder via the terminal command and tried reinstalling. Still it fails.
    Tried downloading the rar files several times and extracted the contents and repeated the process. No luck 🙁

    Could you pls point me in the right direction ?
    Hey, and… when i typed the command ‘sudo ./install’ initially it did not give me any error like you said after which I have changed the IP in host file anyway from the inet address though.

  18. Hi Sérgio Serra,

    First of all, thanks for this article. I have been searching for a way to practice ABAP.

    During the process of installing SAP, I encountered 1 “hopefully” minor hiccup.

    May I ask if you have ever encountered an error on phase 34 (Import temporary license). The error is “Instance NPL/ASCS01 [STOP] did not stop after 7:50 minutes. Giving up.”. Already tried retrying thrice (pressed retry) and still the same error.

    I also encountered the error “Unable to generate a new password for database login ‘sa’.” but I was able to solve it by replacing the ASE license files as per the PDF.

    Thank you.

  19. I know how much pain it will take to install R3 and i did it few years back using VM Ware on Windows. It will take more than 12hrs to setup, create client etc. But it will huge fun to play with it. Thanks for your educating post on installation which is additional effort from you along with install effort 🙂

  20. Hi Sérgio Serra,

    thanks for sharing this experience into a step by step relatively easy instruction.

    I think I am one of the guy who didn’t get one time shot zero error installation.
    Instead I had more than 4 or 5 times trouble here and there.

    I finished the installation by overwriting the dbext.tgz-aa file.
    Is that mandatory now?
    Or is there any chance that you succeed install without replacing that file?

    I did change the NPL_D00_vhcalnplci file.
    However, when I open one of available menu in the sap easy access tree of DEVELOPER user,
    SAP Fiori Launchpad menu,
    My browser open this URL
    but the page can’t be displayed.
    Seems the URL setting is not proper yet.

    Any idea what I need to do,
    to be able to open the URL?

    Thank you.

    • Tom,

      Were you able to resolve this issue of launching Fiori launchpad. I am seeing the same issue; Appreciate any help to resolve the issue.
      Best regards

    • I’m glad that you made it!

      To me that happened a lot in the third installation I’ve made. I got almost to the point of quitting. Hopefully I didn’t otherwise I wouldn’t have gotten the instructions on how to solve it.

      As for it hanging on that step, I would immediately make a reinstallation and it would pass that phase. Weird. I’m disappointed on you for not using Mint. 🙂

Leave a Reply to Natee Pantong Cancel reply

Please enter your comment!
Please enter your name here