Skip to Content

So, you want to install a developer edition of a SAP NetWeaver ABAP AS. It should sit on a Linux distribution, in a virtual box.
However, you’re a Linux newbie.
FEAR NOT!
We have created a genuine, step-by-step guide, with loads of screenshots to help you on your way.

 

Note: I am focussing on one, tried-and-tested installation procedure. Other variants (VMWare, Ubuntu, RHEL, etc) should also work. Please see the following for what to watch out for with other VM technologies or Linux distros: SAP AS ABAP 7.51 SP2 – Concise Installation Guide

Note 2: this guide is part of a series for anyone who wants a free trial version of an SAP NetWeaver ABAP AS. To find out more about this whole series, see SAP AS ABAP 751 SP02: Developer Edition to Download.

A. Preparation

  1. Ensure you have the following hardware:
    • x86_64 Processor based hardware
    • Required: at least 8 GB RAM plus about 8 GB swap space;
    • Recommended: at least 16 GB RAM plus about 8 GB swap space;
    • About 100 GB free disk space for server installation
    • About 2 GB free disk space for client installation
    • English – SAP AS ABAP requires that you configure English (LANG=en_US.UTF-8) as the operating system language
  2. Download the latest released version of Oracle VirtualBox from https://www.virtualbox.org/wiki/Downloads for your operating system.
  3. Download openSUSE Leap 42.3 in your local machine (64 bit, released version) from https://software.opensuse.org/distributions/leap
  4. Download the relevant ABAP download files (“abap.rar”) from https://tools.hana.ondemand.com/#abap.

B. Create VirtualBox instance; install openSUSE

    1. Start VirtualBox and create a new VirtualBox instance by clicking the New button:

      1. Enter the following values:
        • Name : MyVirtualLinux (for example)
        • Type : Linux
        • Version: openSUSE (64 bit) -> Next
        • Select Memory size : 6 GB  -> Next
        • Hard disk: Create a virtual hard disk now -> Next
        • Hard disk file type: VHD (Virtual Hard Disk) -> Next
        • Storage on physical hard disk: Dynamically allocated -> Next
        • File location and size: 100 GB
        • Choose Create.
      2. Again in the VirtualBox Manager, click on Start to start the VirtualBox:
    2. In the dialog that appears, navigate to the downloaded openSuse installation file (format .iso), which you downloaded in Step 2, eg openSUSE-Leap-42.3-DVD-x86_64.iso.Then select this drive; choose OK:
    3. Now choose Installation (using keyboard, not mouse):
    4. Important: Choose language and keyboard layout (test keyboard).
      NOTE: We have only tested the US English-language version. If you have problems, please use the English version.
    5. Accept the License Agreement by choosing Next.
    6. In Installation Options, leave the 2 options unchecked, and choose Next:
      • In Suggested Partitioning, choose Edit Proposal Settings and enter the following:
        • File System for Root partition: choose  Ext4 from the drop-down box.
        • Uncheck Propose Separate Home Partition
          (This step is needed so that SUSE installation creates only one drive but does not create 2 drives (Home and Extension) where Home has less space to continue the ABAP installation.)
        • (Optional: Enlarged Swap for Suspend – I left it unchecked.):
      • Choose Ok, -> Next
      • Select Region and Timezone -> Next
      • In Desktop Selection, choose GNOME desktop -> Next
      • Enter:
        • Your full name
        • (Create a ) user name
        • Create a master password, confirm it -> Next
          (
          I ticked Use this password for system administrator and Automatic Login. Leave the authentication method and encryption method as they are.
          The password should be at least 7 characters.)
    7. IMPORTANT: In Installation Settings, do not choose Install yet!
    8. You need to make the following settings:
      • Scroll down to find Firewall and SSH:
      • Disable Firewall
      • Enable SSH service:
    9. Click on Install and Confirm again to Install the Operating System.

The Linux operating system will install (yes!)

 

C. Prepare openSUSE system for ABAP installation

In this section, we will make some settings in the openSUSE system to prepare it for the ABAP installtion:

  • change proxy settings;
  • download and extract the ABAP .rar files;
  • install the uuidd daemon;
  • edit the hostname and hosts files;
  • assign root privileges to the install script.
      1. If you have successfully installed the openSUSE operating system, you will see something like this:
      2. Boot up the system by choosing the first option, “Boot from Hard Disk.”Now, we just have these settings before we install the ABAP server.
      3. Change the Proxy settings, if you are behind a proxy:
        • Open Activities and enter “N” as the search term.
          The system returns something like this:
        • Choose Network.
          In the dialog that opens, choose Network Proxy, then choose Manual.
        • Change the http and https proxy settings according to your company requirements and set the port to 8080:
      4. Now we want check used memory using a tool called Xterm.

    (Background note: Technically speaking, we are interacting with the shell, a program that passes keyboard commands to the operating system. We are interacting with the shell using a terminal emulator, called Xterm).

     

      • Again, choose Activities, then enter “X” as the search term.
      • Choose Xterm.
      • Check used memory by typing df -h :

        Minimum space in home directory should 33 GB to avoud memory errors during installation. (In this example, mine is 92G, or 5%.)
  1. AND NOW…, it is time to download and extract the abap rar files to a local folder.
  2. First, so that the Linux system can access this folder, we need to register it for auto-mount.
  3. IMPORTANT: Make sure your Linux system is up and running.
    • In VirtualBox Manager, select your Linux system, then choose Settings


    • Then choose Shared Folders.
    • Add a new folder to automount, by choosing the plus icon to the right:
    • In the dialog that appears, navigate to the folder that contains the ABAP installation.
    • Change the folder name to s4installer. (You will need to enter this folder name manually later, so using this alias is less error-prone than trying to remember the complete path.):
    • Choose OK, OK.
  4. IMPORTANT: Reboot the Linux system.
    .
  5.  Installing the uuidd daemon:
    Now we are going to change some settings, before installing the uuidd daemon. This daemon provides universal unique identifiers – essential for creating database keys. (See SAP Note 1310037 for more details.)
    (Note: You only need to do this step if you are using a proxy.)

    • Open the system tool YaST (choose Activities -> enter “Y” as search term…).
    • Enter your root password (ie the one you use to log on to the Linux system.)
    • On the left, choose Software .
    • Scroll down on the right-hand side and choose Proxy.
    • Change the http settings, tick Use same for all, then test proxy.
    • Choose OK, OK:.

      .
  6. Now we are going to install the uuidd daemon.
    • Still in YaST, scroll back up and select Online Update.
    • Open the Search tab, and and enter the search term “uuidd”, then choose Search.
    • Choose “uuidd” by ticking the checkbox, then choose Accept:

      YaST will install uuidd,
    • Now reboot when prompted.
  7. Now we are going to install a basic text editor, nano:
    • Open YaST again.
      Again, open the Search tab. This time, enter the search term “nano“, then choose Search.
    • Select “nano”, then choose Accept.
      YaST will install nano.
      .
  8.  Now we are going to start the uuidd service in Xterm:
    • Open Xterm.
    • Start uuidd, by entering:  sudo service uuidd start 
    • Enter the root’s password.
      (
      Note: sudo = “superuser do” ie you need to be a superuser to execute this command. Thus you also have enter the root’s password.)
    • Check if the service has started by entering: sudo service --status-all |grep uuidd
    • Your Xterm will look like this:
  9. We also need to check that libaio or libaio1is installed on your Linux system. In Terminal, enter the command rpm -qa | grep libaio. The system should return your libaio library and version no:
    libaio1 1-0.3.109-22.3x86_64 (or similar).
  10. Still in Xterm, we will change the hostname, by entering sudo nano /etc/hostname.
    • Delete the name that is there and replace it with vhcalnplci.IMPORTANTDo not rename the server after installation. This feature has been removed from this developer edition for simplicity’s sake.
    • It should look something like this:
    • Save your changes by choosing Ctrl+o, then Enter.
    • Quit the editor by choosing Ctrl+x.
    • Check by entering sudo cat /etc/hostname
    • Restart network by entering: sudo rcnetwork restart
    • Check that the hostname has changed by entering hostname
  11. Now we will map the IP address to the new hostname.
    • Check the IP address by entering sudo ifconfig
    • Open the hosts file by entering sudo nano /etc/hosts
    • Using this IP address, add a new entry of the form:
      <IP address> <hostname> <hostname>.dummy.nodomain
      (Should be: 10.0.2.15 vhcalnplci vhcalnplci.dummy.nodomain )
    • Again, save your changes by choosing Ctrl+o, then Enter.
    • Quit the editor by choosing Ctrl+x.
    • Check the changes by using the command sudo cat /etc/hosts
  12. And now…(last step before we install), we will assign root privileges, by entering sudo -i.
    • Enter the root’s password and navigate to the shared folder with the ABAP installation: cd /media/sf_s4installer
    • Change the access rights of the install script: chmod +x install.sh

 

D. Install ABAP

  1. FINALLY, we run the installation, by entering the command ./install.sh

    • Read and accept the license agreement
    • When prompted for the OS users password enter your master password of the virtual Linux OS instance twice
    • Be patient, this will take a while…
    • If the installation is successful, you will see something like this:

E. Post-installation settings

Proxy settings

  1. We need to enter the right proxy settings at Virtual Box level, so that SAP GUI, ABAP in Eclipse etc can find your ABAP system:
    • In Oracle VirtualBox Manager, select the VirtualBox with the installed ABAP system on it, then choose Settings from the context menu.
    • From the left-hand menu, choose Network.
    • Open Advanced, then choose Port Forwarding.
    • In the dialog that appears, enter the following settings:
      Name Protocol Host IP Host Port Guest IP Guest Port
      HTTP TCP 127.0.0.1 8000 10.0.2.15 8000
      HTTPS TCP 127.0.0.1 44300 10.0.2.15 44300
      RFC TCP 127.0.0.1 3300 10.0.2.15 3300
      SAPGUI TCP 127.0.0.1 3200 10.0.2.15 3200

Connecting to the ABAP server from SAP GUI for Windows

The VirtualBox VM will likely be assigned the IP address 10.0.2.15 (because of the NAT network type). Your local WINDOWS cannot see that IP.

Instead it will communicate to the VirtualBox VM through port-forwarding using 127.0.0.1 (your windows local host).

  1. To be able to use your SAP GUI on your local WINDOWS system, then the application server must either be:
    • 0.0.1,
    • or a hostname if added it to your WINDOWS hosts file
  2. Update in administrator mode the C:\Windows\System32\drivers\etc\hosts file and add an entry such as: 127.0.0.1 <your_vm_hostname>
  3. The SAP GUI settings should be:
    • Application server =  127.0.0.1 or <hostname>
    • Instance = 00
    • System ID = NPL

Additional information

We have also provided some additional info (admin, starting / stopping the server, created directories and users, etc) in the Concise Installation Guide.

Note: Since we now have 6 blogs referring to 2 different versions of the download developer edition, blog comments are becoming unmanageable. In addition, searching through blog comments is very difficult for other users, resulting in many duplicate issues.

From now on, please DO NOT post a blog comment if you require troubleshooting.

Please post on the ABAP Development forum : https://www.sap.com/community/topic/abap.html , using the hashtag #ABAP_Trial. I promise to work through the backlog here, but cannot answer any further blog comments.

Thank you for your understanding.

To report this post you need to login first.

19 Comments

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

  1. Jacques Nomssi

    Hello Julie,

     

    thanks to you and your team for this update.

     

    Note:  OpenSuse installation aborts on my machine with 8 GB memory if the recommended memory size (6 GB) is used. I reduced it to 5 GB and the installation was performed.

     

    best regards,

    JNN

     

     

    (1) 
  2. Pavan Kumar

    Hi ,

    I am trying to install ABAP server on my system..but failing continuously(5 times)..

    due to only one error…

    “Installation of NPL failed .Please check log files in /tmp/sapinst_instdir..”

    Please, can anybody let me know how to check this log files.

    I have downloaded ABAP 7.51SP02 still not able to installed.

    I am using Win10..and installing ABAP on Oracle Virtualbox.

    Please your help will be much appreciated..

    (0) 
    1. Julie Plummer Post author

       

      Hi,

      Since we now have 6 blogs referring to 2 different versions of the download developer edition, blog comments are becoming unmanageable. In addition, searching through blog comments is very difficult for other users, resulting in many duplicate issues.

      From now on, please DO NOT post a blog comment if you require troubleshooting.

      Please post on the ABAP Development forum : https://www.sap.com/community/topic/abap.html , using the hashtag #ABAP_Trial. I cannot answer any further blog comments, which are troubleshooting.

      Thank you for your understanding.

      (0) 
  3. Rogerio Ribeiro Macedo

    Hi Julie,

    thank you for your post, it is very useful, once I am very newbie about linux.

    I followed all steps (except the proxy configuration), however the installation has failed returning the exception modlib.jslib.caughtException, and the message “syntax error near unexpected token `(‘ ” in the file sapinst.log

    What could I do to solve it?

    Thank you in advance

    Rogerio

    (0) 
  4. Rafal Kowalski

    Hi Julie,

    just I’ve installed 751 version and can not to go on with SAP GUI (attached to downloaded files is ver 7.40), Receive information:

    This SAP Front End patch cannot be applied. Either the installed components are already on the same patchlevel or the components to be patched are not installed.

    Would be possible to ask you for help ?

    Many thanks

     

    (0) 
    1. Julie Plummer Post author

      Hi Rafal,

      That sounds like a SAP GUI issue. Can you please also post on the SAP GUI forum, and let me know how you get on:

      SAP Community: SAP GUI 

      Next time, please don’t post comments on the blog (see the end of the blog – it is too confusing.) Thanks

      Best wishes Julie

      (0) 
  5. Christian Nagel

    Hi Julie,

     

    I just installed SAP NetWeaver AS ABAP 7.51 SP02 Delevoper Edition in openSUSE Leap 42.3 and everything worked well, system is running. Thanks for the great step-by-step instruction.

     

    Unfortunately there’s one little thing left to do: In transaction SLICENSE license expiration date is 14.02.2018 and no matter what I do – I tried to renew the license with both mentioned options (generating a .txt file and uploading it and replacing the .lic file in openSUSE file directory) the license expiration date hasn’t changed to 31st of March 2018 yet. What else can I do?

     

    Thanks in advance and best regards!

     

    (0) 
    1. kyo choi

      Normally it’s only for 3 months and you can apply for extension after wards or few days before your current one runs out.  Or you can reinstall.

       

      1. Use the SLICENSE transaction code to get your Hardwarekey.

       

      2. Then go to following site to generate the key which will be a text file.

      https://go.support.sap.com/minisap/#/minisap

       

      3. Go back to SLICENSE to apply the generated License.

      (0) 
      1. Julie Plummer Post author

        NOTE: Ivy, you are almost correct. However, before you install the new license, PLEASE REMEMBER to delete the old license.

        Why? Well, this is specific to our free developer editions: For simplicity’s sake, we have hardcoded a developer access key – for ONE developer license. If you fail to delete the old license before installing the new one, you may have issues creating / editing dev objects later.

        I have described this here:

        https://blogs.sap.com/2017/09/04/sap-as-abap-7.51-sp2-developer-edition-to-download-concise-installation-guide/

        Also below for your convenience:

        Best wishes Julie.

        ABAP 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.

        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.

        Renewing your license

        Many of you have asked about this: Yes, you can apply for a new license. Just use the same procedure as above.

        In theory, indefinitely, however, the ASE and HANA licenses last for about a year.

        IMPORTANT: To use the developer key that we provide, you MUST delete your old license before you install the new one (as described in step 4 above). Otherwise, the system will generate a different license that no longer matches our pre-configured dev. key.

        As an aside: I have noticed that some useful information is available only in the concise guide, not the newbies’ guide. I am considering creating a PDF with the (verbose) Installation Guide plus additional info, FAQs, setup etc.

        (0) 
      2. Christian Nagel

        Hi kyo choi,

        thank you for the information, it worked well! At the moment the key generation seems to only work by using Google Chrome as browser; any other browser did not download the .txt file that contains the generated license.

         

        (0) 
    2. Julie Plummer Post author

      Hi Christian, Please read Kyo’s comments – and, IMPORTANTLY – my comment below.

      However, just fyi: I believe you are talking about 2 different licenses:

      The 14.02.2018 date is correct for the AS ABAP license.

      The 31st March, 2018 date is correct for the ASE database license.

      You can work freely till Q1 next year, then update each license at the appropriate time.

      Hope this clarifies.

      Best wishes Julie.

      (0) 
      1. Christian Nagel

        Hi Julie,

        I did and it worked (after deleting the old license!). Thank you for clarifying the difference between the two licenses, it helped me a lot.

        Best wishes

        Christian

        (1) 
  6. Serkan Erkan

    Hi Julie,

     

    I want to ask you a question about SLT Replication Server (LTRC) on 7.5x systems. The LTRC transaction does not exist. I think I must install an add-on.

    I have found some blog posts about DMIS add-on. But couldnt download it.. Can you help me?

     

    Best,

    Serkan

    (0) 

Leave a Reply