For general information, download link, operating system and hardware requirements see the Developer Edition to Download: Introduction page.

Installation Instructions and First Steps


Network configuration of the SAP host operating system: The officially supported setup requires a static IP address for the hostname used for the SAP installation. Using DHCP is possible for this developer edition, but be aware of potential consequences. If our installation cannot ping the hostname specified when installing, the installation and startup of the SAP system will fail. Make sure that the hostname specified during installation fulfills SAP requirements, most importantly that it does not exceed 13 characters length and also needs to survive subsequent reboots.

Firewall: Deactivate the firewall.

Additional software requirement

The following software packages are required:

  • csh – Ubuntu and Debian require you to install csh before you start the ABAP installation
  • libaio – SAP Sybase ASE requires the libaio library to start the installation
  • 32bit libraries – SAP Management Console (SAPMC) requires 32bit libraries (ia32,glibc.i686) for ASE related functionalities
  • uuidd  – SAP AS ABAP requires the OS to run uuidd service to ensure the uniqueness of GUIDs. For more information – eg on why this is extremely important – please see archive thread 3379688: Is it mandatory to have uuidd for SAP installation
  • English – SAP AS ABAP requires that you configure English (LANG=en_US.UTF-8) as the operating system language

Server Installation

    1. Login as root (sudo). You need to have the password of the root user at hand, as the installation needs root privileges.
    2. Ensure that you (as superuser) have the necessary executable rights:
      chmod +x
    3. Extract downloaded archive: unzip Make the extracted download archive available on the server.
    4. Go into the root directory of the extracted archive.
    5. Run the installation, using the command: sudo ./

    (We provide you with several installation options:

    • ./ – installs the Developer Edition in dark mode, the installer will configure the SAP system for usage of the physical hostname
    • ./ -g– will present you a SAPINST GUI allowing you to modify certain system parameters
    • ./ -h <own hostname>– allows you to specify your own hostname to be used by the SAP system
    • ./ -s – allows you to skip the hostname check )


    1. Read and accept the license agreement.
    2. When prompted for a password, enter your master password of the virtual Linux OX instance twice.
      (All options prompt you for a master password. Please ensure that the password length exceeds 7 characters, contains capital letters and digits but does not contain special characters. The installation starts the database and server.)

    The installation will take a while (about 20 minutes – feel free to get a coffee).

    If the installation was successful, you should see the following message:

    • Instance on host vhcalnplci started
    • Installation of NPL successful

Client installation (optional)


If you have already a SAP GUI installation you can connect to your sytem. If not go ahead now with the client installation. SAP GUI space in SDN SAP GUI | SCN leads you to more documentation around SAP GUI for Java Environment. Requirements for the SAP GUI for Java include: Sun Java SE 6 32-bit or 64-bit, a properly installed Java Plugin and C++ runtime

ABAP Plugins for Eclipse

Go to the SCN space ABAP in Eclipse where you will find download links and tutorials.

Post-Installation Steps

Profile parameters

Adapt the following profile parameters:

  • icm/host_name_full = $(SAPLOCALHOST).dummy.nodomain
  • PHYS_MEMSIZE = 30%

License key

  1. Start the SAP system:
    • Switch to user npladm with default password Appl1ance in the console : su npladm
    • Start the SAP system : startsap ALL
  1. Log on to the system, client 000 as user SAP* with default password Appl1ance. In  transaction SLICENSE , ascertain your hardware key.
  2. Request the license key for your trial version at SAP Sneak Preview License Key Request.
    • Select NPL – SAP NetWeaver 7.x (Sybase ASE) as System ID.
    • Enter your personal data and agree to the License Agreement.
    • Choose Generate bottom right corner of screen.)
    • The web site automatically generates a .txt file for this system/key. Download and save this file, eg on the desktop for convenience.
  3. Go to transaction SLICENSE and install the license file:
    • In the tab Digitally signed licenses, delete the existing license, then choose Install. This opens the text file you got and installs the new license key.
  4. IMPORTANT: If you log on with the user DEVELOPER, then the first time you create an object, you will be asked for a user key. Enter the following key exactly: 35408798513176413512.

Please note that all the above steps must be carried out; otherwise, the above user key will not work.

The system type changes to Demo. You can now explore the demo scenarios and develop using the ABAP tools in Eclipse and new features like the core data services or SAPUI5 UIs.

Proxy Settings

Make the following proxy settings:

Administering the SAP NW ABAP 7.5 Developer Edition

Starting and stopping the server

Terminal commands

With the user npladm you can start and stop the server using the terminal commands startsap and stopsap respectively or the newer sap control commands.I

Directories and Users

The installation creates following directories and users:

Created Directories:

Directory Size
/sapmnt ~  2 GB
/sybase ~ 50 GB
/usr/sap ~  3 GB

Created Users on OS level

The installation creates following users on OS level. During the installation you are prompted to enter the master password.

User name Password Description
sapadm master password Created by SAP hostagent
npladm master password SAP System Administrator
sybnpl master password SAP Database Administrator

The installed system provides the following database users:

User name Password Description
SAPSR3 Appl1ance SAP Schema User

The installed system provides the following SAP users in client 000:

User name Password Description
DDIC Appl1ance Data Dictionary User
SAP* Appl1ance SAP Administrator

The installed system provides the following SAP users in client 001:

User name Password Description
DDIC Appl1ance Data Dictionary User
SAP* Appl1ance SAP Administrator
DEVELOPER Appl1ance Developer User
BWDEVELOPER Appl1ance Developer User

Uninstalling instructions

If you ever want to uninstall your server, proceed as follows:

  1. Delete the created directories
  2. Delete the OS users
  3. Delete the added lines in /etc/services (should be the last lines beginning with sap* and sql6* respectively)
  4. Delete the line containing nplhost in /etc/hosts
  5. Delete the symbolic link in the directory /etc/init.d/rc3.d in case of SUSE or /etc/rc3.d in case of Red Hat
  6. Restart your network.


We encourage you to visit our SCN ABAP community.

In case of Linux problems read the Linux FAQ.

Post your comments to the introduction page.

To report this post you need to login first.


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

  1. Simone Cattozzi

    i’m having some problems during installation.
    First of all on launch give me the message “the hostname you have choosen is on a loopback” despite i’ve configured /etc/hosts /etc/hostname.
    However i can skip hostname check with -s option, but installation give me this error

    Log file in /tmp/../sapinst.log

    The problem is related to gui session issue?


    1. Julie Plummer Post author

      Hi Henning, Sorry about the delay. I needed to check back with Gateway colleagues. The answer is:
      “I don’t see a problem here in downloading the add-on IW_PGW since it is stated that “SAP Software” shall mean the free development versions of ..:” and “…and to which You are given access to on or through an SAP web site.”

      Obviously, this is own risk: No support if something goes wrong.
      HTH Julie.

      1. Henning Rettenmaier

        Hi Julie, thank you for the reply.

        But when I want to start transaction SAINT I receive the following error:

        The error message is:
        “No valid maintenance certificate found for system NPL.”

        Kind regards,

        1. Julie Plummer Post author

          Hi Henning,
          I’m sorry. This appears to be a GW licensing issue.
          I will pass this issue on to the GW team, but they may not be able to help.
          You can also post the relevant question on the Gateway forum, but again I don’t know if they can help.

          The point of the trial edition is to introduce:
          1. non-ABAP developers to the ABAP language, ADT, etc
          2. older ABAP developers to 7.5 features.

          I am sorry I cannot personally help further.

          Best wishes,
          Julie Plummer.

  2. Axel Dietrich

    Hi, installation went well, system running.
    just few comments to avoid confusion:
    – the uuidd service should be installed, not to be mixed up with the uuid (libuuid) as stated above
    – the 3 rar arcive files to download contained few duplicate dbdata.tgz_xx files.

    Kind regards,

        1. Julie Plummer Post author

          Sorry – looking at this from my phone (from “Notifications” queue, I opened the wrong blog – I apologise.
          I’ll attend to this.
          Thanks and best wishes,

  3. Michael Biber


    thank you for providing another plain netweaver AS ABAP system for developer to play with!

    But is it possible that the developer key is wrong? The system tells me so. I also had a look to the table DEVACCESS which contains a different key for the user DEVELOPER but this one is incorrect, too.

    Thanks in advance.

      1. Michael Biber

        Hello Philipp,

        i started the transaction slicense to do this and found a valid license so  I skipped this step. I will try to get a new license and install it later.

        Best regards

        1. Michael Biber

          This worked indeed. I requested a neew license key that also changed the installation number of the system. Now the given developer license works.

          Thank Philipp for the tip.

          Best regards

  4. Palaniappan Sivakumar

    Hi Team(Julie),

    After a successful installation of application, I am (really a new to SAP) having issues either user Linux Java client or Windows client. I have tried various methods, finally build a OPENSuSE machine. Still same issue.

    As soon the section reaches the license option, it would be really helpful for folks like to get the environment going.

    Is there any improved or modified version of this install document? Links or references would be really helpful. 🙂

    1. Julie Plummer Post author

      Hi Nick,

      Sorry, no. The trial / developer editions can only be made available for a limited time, under a limited license. You can, however, transport your dev objects to a later version.

      Best wishes Julie.

  5. Abraham Kumah

    Hi Julie,

    I was able to get past all the errors during installation by increasing the ram of my machine to 64G, however, after installation I got this message: Database is not available via R3trans. Also, when I looked at the status of the services running, some are green but others are grey and I am not able to start the GUi.

    disp+work and dispatcher are grey instead of green.

    Any help will be appreciated.


    to start the Gui.


  6. Gaurav Sahu

    Hi All,

    I am using ubuntu 16.04. When i am trying to install via ./ -g or ./, i got error as shown in attached file. Coould you please advise me what needs to be done. Below is my hostfile setting localhost ubuntuabap

    # The following lines are desirable for IPv6 capable hosts
    ::1 ip6-localhost ip6-loopback
    fe00::0 ip6-localnet
    ff00::0 ip6-mcastprefix
    ff02::1 ip6-allnodes
    ff02::2 ip6-allrouters

    1. Derick Florian

      Hi, Gaurav, I think the script is assuming you are using “vhcalnplci” as the host name.


      you could change ubuntuabap to vhcalnplci


      try this option from the instructions above: “./ -h <own hostname>”– allows you to specify your own hostname to be used by the SAP system”


      Hope this helps!

  7. Michael Doering

    Hi to all


    my installation works fine.


    I’m able to log in but

    a) the developer access key is invalid


    b) the web site for requesting a NPL license is redirected to a new site. The request does not work. I get no email with a license file. I tried it 2 times.


    What is the problem? I noticed that the email field is a little bit more bold framed than the others.

    I tried a different email address but that doesn’t help.

    Perhaps there is a problem with the system number or the installation?

    Have someone tried this new page?


    Edit: Okay, I got the key. Solution for all others: The new webpage doesn’t send you a mail. You have to use the Internet Explorer and it immediately ask you to download the NPL.txt file.



    1. Harry Jääskeläinen

      Thanks Michael, that did the job for me!

      @SAP I tried to register several times, please update the guide. BTW, I really don’t like to use Microsoft products, especially their web browsers :-/


  8. Derick Florian

    UPDATE: I made the simple mistake of not starting my program name with the letter “Z”. It should have been Zsample_123. Everything is up and working. Thanks Julie and SAP Communtiy at large for putting this advice together.


    Hello, everyone. I successfully installed the license key but am having trouble using the developer key provided above in the instructions.

    Here’s what I tried:

    • Retrieved a NPL Sybase license from the minisap site.
    • I installed the license key logging in as SAP* on client 000. It installed successfully and it seems to work.
    • logout and log back in as DEVELOPER on client 001.
    • Go to SE38 and try to create a new program.
    • Paste in the developer key 35408798513176413512 and press ok.


    Am I performing one of the steps incorrectly?

    Are there any troubleshooting steps I can perform? Is there a workaround?

    Should I post any additional info?


    Thanks for the help!


    1. Harry Jääskeläinen

      Hi Derick,

      you try to modify a standard object and the system wants an access key for that. Something  completely different, so I suggest further reading in ABAP.

      Sorry for lecturing.

      Cheers, Harry.


        1. Julie Plummer Post author

          Hi Vinoo,

          I want to make a few additional checks with a colleague, but I don’t see why you should have to re-download and reinstall. I will get back to you.

          Best wishes Julie.

          1. Julie Plummer Post author

            Hi Vinoo, I have now tested the different users and passwords.

            The guide is up-to-date.

            However, you should not have to re-download the files and start again. You should simply be able to log in to your system / client.

            Are you having problems with this?
            Best wishes Julie.

  9. Anatoly Tarasevich

    Good day!

    Please help me to avoid an issue..

    I installed that TestDrive on SUSE 12. 8GB RAM. 4 vCPU.

    I used SAPinstGUI to install it. Proccess was successful. But have some issues – below i will describe it.

    After installation i updated an SAP kernel and installed a DB patch (

    But some issues are present.

       1. Preriodically work processes stopping. Logs from SAP MMC:

    S Tue Feb 14 12:46:02 2017
    S  handle memory type is RSTSPROMMM
    M  ThWpNeedsRestart: abap strategy == kill, restart
    M  ThWpRestart: restart wp (pid=11156) automatically
    B  Disconnecting from ALL connections:
    B  Wp  Hdl ConName          ConId     ConState     TX  BC  OC  HC  PRM RCT INF TIM MAX OPT Date     Time   DBUser                           DBHost           Program                                 
    B  011 000 R/3              000000000 INACTIVE     NO  NO  000 NO  YES NO  NO  000 255 255 20170214 114605 SAPSR3                           smart6                                                   
    C  DbSlDisconnect hdl: 0 
    B  Disconnected from connection 0
    B  statistics db_con_commit (com_total=88, com_tx=72)
    B  statistics db_con_rollback (roll_total=0, roll_tx=0)
    M  ***LOG Q02=> wp_halt, WPStop (Workp. 11 11156) [dpuxtool.c   317]

       2. DBACOCKPIT contains those messages:

    Job execution failed. See job history and log files for details.
    Msg 4002, Level 14, State 1
    Server 'NPL':
    Login failed
    Client message:
    Message number: LAYER = (4) ORIGIN = (1) SEVERITY = (4) NUMBER = (44) 
    Message String: ct_connect(): protocol specific layer: external error: The attempt to connect to the server failed.

    Logs form /sybase/NPL/ASE-16_0/install/NPL_JSAGENT.log :

    worker  ct_connect() failed.
    worker  jsj__RunSQLJob: jsd_MakeConnection() failed for user sapsa to server NPL
    worker  jsj__RunSQLJob() failed for xid 22394
    worker  Client message:
    worker  Message number: LAYER = (4) ORIGIN = (1) SEVERITY = (4) NUMBER = (44)
    worker  Message String: ct_connect(): protocol specific layer: external error: The attempt to connect to the server failed.


    In my opinion some troubles with passwords for sapsa in SSFS. But i have enought skiils to resolve it.

    Please can you guide me?

    Thank you!

    1. Anatoly Tarasevich


      I have resolved the issue with Login failed

      To fix the issue, follow finals steps in the SAP note 1706410:

      Login as npladm

      isql -X -Usapsa -SNPL -w999
      use master
      exec sp_dropexternlogin SYB_JSTASK, sapsa
      exec sp_addexternlogin SYB_JSTASK, sapsa, sapsa, '<new sapsa password>'
  10. Jepi Flanders

    Dear Experts,

    Thank you for providing this great blog.

    I’ve done the installation, all Okay, and now I cannot start the GUI from openSUSE. I fear I’ve the same issue as Abraham here above.

    Here are my screen-shots:

    SAP instance seems successfully started. Indeed, checking the processes, Dispatcher is GRAY:


    Do you have any solution for this?

    Thank you for the help.




      1. Jepi Flanders

        Hi Anatoly,

        Thank you for replying. I’ve checked R3trans -d and here is the result:



        It looks good, isn’t it? As far as I’ve understood, return code 0 should mean all is Okay. However, GUI connection still fails.

        Do you have any further hints?

        Thanks and bye, JF


        1. Anatoly Tarasevich

          Hi, Jepi

          Yes, code 0 is OK.

          I recommend you try SAP MMC. You can download it from MarketPlace.

          Use this to observe Process List or state of work processes and view Developer Trace of it. Traces have errors and reasons of abnormal behavior.

          Also be sure if you opened all need ports on server. In my case i switched off almost a firewall. It will be done explicitly.

          When i had installed SLES i chose an “Firewall off” option and i was surprised that it still worked after installation process ended and i needed to switched it off again.

  11. Fabian Lupa

    For your convenience, in the client/Misc subdirectory, we also provide the SAPMMC installation package and a template script for calling SAPMC standalone.

    Is this this the case? I cannot find a misc folder there and I also do not have access to the marketplace to download the mmc plugin from there.

  12. Agus Prajogo

    Hi.. I’m new in SAP here and tried to install SAP Netweaver AS ABAP7.50 SP2 under OpenSuse (on Virtualbox). The host is Ubuntu 16.04 Desktop.

    I managed to follow the step by step process as per indicated in the page and finish the installation. However, once I tried to run the SAP system using npladm user (using startsap ALL) then check the R3trans, the message is:

    This is R3trans version 6.25 (release 745 – 30.10.15 – 12:47:42).

    unicode enabled version.

    2EETW152 Cannot open file “trans.log”

    : Permission denied

    r3trans finished (0012).


    Is there any mistake I made? since I tried to login using SAPGUI (I installed SAPGUI 7.40 ver 8 for Linux) with connection properties in advanced tab as: conn=/H/

    The page launch, but I cannot login using Client 000, user SAP* and Password Appl1ance. Did this problem because of the permission denied above?

    Thank you for your kind help 😀




    1. Agus Prajogo

      Dear all,

      I can access the system and activate the system. My IT colleague told me that the problem was because I’m having multiple virtual box active at the same time.

      I’m not sure about how to remove the message “Cannot open file ‘trans.log'” since it still showing the same message, however, I will not do anything since it is not disturbing the system – at least for now.

      Thank you!

  13. David Liu


    I am trying to install on Ubuntu 16.04 on Azure, There are the following errors block the installation:

    ERROR 2017-03-16 03:26:50.744 (root/sapinst) [CInstallerCallBackImpl.cpp:259] id=ind-rel.ind-os.ind-db.assertionFailed errno=CJS-00030
    Assertion failed: Unable to update database device locations. Refer to trace file sapinst_dev.log for further information.

    ERROR 2017-03-16 03:26:50.745 (root/sapinst) [iaxxbjsmod.cpp:97] id=modlib.jslib.caughtException errno=MUT-03025
    Caught ESAPinstException in module call: Assertion failed: Unable to update database device locations. Refer to trace file sapinst_dev.log for further information..

    ERROR 2017-03-16 03:26:51.828 (root/sapinst) [CSiStepExecute.cpp:1107] id=controller.stepExecuted errno=FCO-00011
    The step syb_step_update_dbdevices with step key |offlineadjustment_dialogs|ind|ind|ind|ind|0|0|offlineadjustment_db_post|ind|ind|ind|ind|db_post|0|syb_rename_db_post_dia|ind|ind|ind|ind|syb|0|NW_SYB_DB_REN|ind|ind|ind|ind|syb2|0|syb_step_update_dbdevices was executed with status ERROR ( Last error reported by the step: Assertion failed: Unable to update database device locations. Refer to trace file sapinst_dev.log for further information.).


    I use “-s” option to skip the check of hostname. I am not sure what is the root cause. Could you please give me some advice. Thanks in advance!

    1. Julie Plummer Post author

      Hi David,

      There is no immediately obvious reason why this shouldn’t work in Ubuntu and Azure.

      However, we have only tested it on-premise (and openSUSE).

      I am sorry but we do not have the resources here to test why this is not working in a Cloud environment.

      If everything else is working in your Azure setup, you could try posting to the SAP- Linux forum, though I am not sure that you will get help there: SCN SAP on Linux Forum

      Alternatively, if you want to offer an ABAP dev edition in the cloud, try here:

      SAP AS ABAP on SAP HANA / ASE: FREE Developer/Trial Editions . and choose a SAP CAL edition.

      For more information on SAP CAL, see the SCN Wiki: including “General Technical Questions

      Sorry this is not the answer you wanted, but I cannot test your specific scenario here.

      Best wishes, Julie.


  14. Eduardo Gorges


    Hello everyone!


    An AS Trial was installed, uninstalled and now we are trying a new installation.

    After unistall, we did:

    • delete C:\user\sap and C:\sapdb directories
    • delete C:\Program Files\sapinst_instdir
    • clear Registry HKLM\System\ControlSet001\Services\sb2port – sap & DBTech entries
    • reboot

    But during the new setup, we are receiving the error message:

    Could not read the profile path for user S-1-5-21-1037899709-540295885-904245438-1009 from the registry: The system cannot find the file specified

    The respective entry was not found in registry, although a very similar with -1021 suffix was found.

    Any clues?

    Thanks in advance.

    1. Julie Plummer Post author

      Hi Eduardo,

      2 things:

      1. If you follow the deinstallation instructions above, we do not suggest that you manually registry settings. Therefore we have not tested and cannot support this.
      2. It looks as if you are installing this on your local (Win) HD. If you install it via Linux on VBox, then that should work. Also, it should get round your problem with the registry entries.

      Best wishes Julie.

  15. Robin Fillerup

    Hello, I installed NPL in  VMWare player/Ubuntu 16.04, it runs perfect, th installation guide is superb, many thanks for the NPL & guidance. But one thing is bothering me: The date of 1 july is approaching, probably the expiring DB license is halting my beloved NPL then, is there a new Trial in preparation?

    Best regards, and: “May the source be with you”, Robin.

    1. Alexander Tsybulsky

      Hello Robin,

      you mentioned you installed NPL in ubuntu. Could you please tell if you did any specific additional steps to it ? How did you run the ./ (I mean params)  ? How did you setup hostname and hosts ? I successfully installed the package itself. But startsap does not bring up D00 instance. I experimented with hosts and hostname a bit and D00 began to start properly BUT i cannot connect there with SAP GUI… very strange I think I’m just half step from success but missed something small.


      UPDATE: no worries, seems that I figured it out. Changed hosts to link to real interface IP (not restarted and it worked. 

  16. Prakash Upadhyay

    Any help, how can I connect my SAPGUI with the SAP Installed in vmware? Can i use SAPGUI installed in my Windows PC and connect with my Virtual Machine, where SAP is installed?

    Thanks for helping with me on this, appreciate your time.

  17. Deepak Bhargude


    While installing m getting below error.

    Abort execution because of
    Step returns nw.syscopy.storagecopy.HostIsNotLocal


    Please team help me!!!

  18. Alfonso Rodriguez


    I have a problem during SAP installation.

    I’m using Mac OS with SUSE Linux under Virtualbox.

    When I execute sudo ./ I get following error after some seconds:

    rm: cannot remove ‘/sapmnt/NPL/profile/NPL_D00_vhcalnplci_*’: No such file or directory
    ./ line 321: /usr/sap/NPL/SYS/exe/run/SAPCAR: No such file or directory
    ./ line 322: cd: /tmp/hostctrl/: No such file or directory
    ./ line 323: ./saphostexec: No such file or directory
    ./ line 325: /usr/sap/hostctrl/exe/SAPCAR: No such file or directory
    ./ line 326: cd: /tmp/swpm/: No such file or directory
    ./ line 330: ./sapinst: No such file or directory
    Installation of NPL failed, please check logifiles in /tmp/sapinst_instdir for possible root cause.
    Any idea?
    Thanks and regards.
  19. J singh

    Hello  Julie,

    Is it possible to download the SAP note for a correction from developer edition.

    I am unable to create the catalogs (SAP Fiori Development) and it has the correction note.

    Connection test of RFC Destination SAPOSS is failing.

    Please advice. Thanks!


    J Singh



Leave a Reply