Skip to Content

NOTE: ASE license expiry

New ASE license is available here:

Renew ASE License: SAP Document Center

(This SAP Document Center folder includes instructions.)

(6th July, 2017 – I’ll leave this here till the end of this month. I have also included it under “ASE license expiry in the Concise Installation Guide.)

 

Linux for Newbies

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.
In this example, we will focus on the openSUSe distribution.

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 NW 750 SP2 ABAP AS Available to Download!

Preparation

  1. Download the latest released version of Oracle VirtualBox from https://www.virtualbox.org/wiki/Downloads for your Operating system.
  2. Download openSUSE Leap 42.1 in your local machine (64 bit, released version) from https://software.opensuse.org/421/en
  3. Make sure the relevant ABAP download files (“abap.rar”) are on your local hard drive.

In Oracle VirtualBox Manager:

  1. Start VirtualBox and create a new VirtualBox instance by clicking the New button:
  2. 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.
  3. Again in the VirtualBox Manager, click on Start to start the VirtualBox:
  4. In the dialog that appears, navigate to the downloaded openSuse installation file which you downloaded in Step 2, eg openSUSE-Leap-42.1-DVD-x86_64.iso.Then select this drive, choose OK:
  5. Now choose Installation (using keyboard, not mouse):
  6. 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.

    • Accept the License Agreement by choosing Next.
    • 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 partitionin: 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! You need to make settings:
    Scroll down to find Firewall and SSH.

    • Disable Firewall
    • Enable SSH service:
  8. Click on Install and Confirm again to Install the Operating System.The Linux operating system will install (yes!)
  9. If you are successful, you will see something like this:
  10. Boot up the system by choosing the first option, “Boot from Hard Disk.”Now, we just have a few settings to make before we install the ABAP server.
  11. Change 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 / https proxy settings according to your company requirements and set the port to 8080:
  12. Now we want to enter some commands 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. If these terms are unfamiliar, I would strongly recommend William Schotts’ The Linux Command Line (free PDF)).

    • 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%.)
  13. AND NOW…, it is time to download and extract the abap rar files to a local folder.
    First, so that the Linux system can access this folder, we need to register it for auto-mount.
  14. IMPORTANT: Make sure your Linux system is up and running.
    • Select the folder, 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.
    • IMPORTANT: Reboot the Linux system.
  15. Now we are going to change some settings, before installing the uuidd daemon. This daemen 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.
  16. 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.
    • Select “uuidd”, then choose Accept.
      YaST will install uuidd, then reboot.
    • End YaST.
  17. 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:
  18. Now, still in Xterm we will change the hostname, by entering sudo vi /etc/hostname.
    • Insert the hostname by entering i (for “insert”). It should look something like this:
    • Save your changes by hitting the ESC key, then :wq (ie “colon”, “Write”, “Quit”)
    • Check by entering sudo cat /etc/hostname
    • Restart network by entering: sudo rcnetwork restart
    • Check that the hostname has changed by entering hostname
  19. Now we will map hosts to the new hostname.
    • Check the IP address by entering sudo ifconfig
    • Open the hosts file by entering sudo vi /etc/hosts
    • Using this IP address, add a new entry of the form:
      <IP address> <hostname> <hostname>.dummy.nodomain
      (Here it is: 10.0.2.15 vhcalnplci vhcalnplci.dummy.nodomain )
    • (To add a new entry, proceed as before:
      • Enter 
      • Enter  10.0.2.15 vhcalnplci vhcalnplci.dummy.nodomain
      • Hit ESC
      • Enter :wq
    • Save the file hosts
    • Check the changes by using the cat command: sudo cat /etc/hosts
  20. And now…(last step before we install), we will assign root privileges, by entering sudo -i.
    • Enter the root’s password.
    • 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
  21. 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:
  22. Ok, we’re almost done. We just need to enter the right proxy settings 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

And that’s it! Hope this helps. Feel free to comment below.
We have also provided some additional info (admin, starting / stopping the server, created directories and users, etc) in the Concise Installation Guide.

Further reading:

The first thing to do is to make yourself familiar with the Linux command line (steps 17-21). I found the most helpful guide here:
The Linux Command Line, by William E Shotts, Jr (PDF)

For openSUSE support: openSUSE forums

To report this post you need to login first.

179 Comments

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

  1. Heiner Goehlmann

    Hi experts,

    for months I have been trying to make my testdrive installation run in a virtual PC on my Windows 10 Pro computer with Hyper-V and openSUSE. Some times installation was successful, but when restarting the SAP system the next day, NPL died with the message “No profile found”. But in most cases the install.sh ended with errors.

    Actually I built a completely new virtual PC and repeated therein the installation of openSUSE Leap 42.2, downloaded and extracted again the .rar files from tools.hana.ondemand.com, ran the install.sh, and replaced the license file.

    As Mandar Shete reported (on July 6, 2017 at 11:47 am, see above), now I would have to “Run the installation with ./install.sh -g option“. Whenever I do this, the install process keeps waiting for any kind of client connection:

    SAPinst build information:
    ————————–
    Version: 2016.06.0
    Build: 1676582
    Compile time: Jun 17 2016 – 16:03:12
    Make type: optu
    Codeline: 720-2_REL
    Platform: linuxx86_64
    Kernel build: 721, patch 626, changelist 1662147
    SAP JRE build: SAP Java Server VM (build 6.1.087 25.51-b02, Mar 1 2016 10:01:52 – 61_REL – optU – linux amd64 – 6 – bas2:264178 (mixed mode))
    SAP JCo build: 3.0.14
    Exe directory: /tmp/sapinst_exe.11150.1500025977



    The GUI could not be started because the environment variable DISPLAY is not set. Please make sure that this variable is defined correctly or start the GUI on another host (for details please consult the installation guide)



    Starting GUIServer using:
    SAPinst port : 21212
    GUI autostart : off
    GUI mode : normal
    command : /tmp/sapinst_exe.11150.1500025977/jre/bin/java -Xmx512M -Dsap.env.var.javahome=SAPINST_JRE_HOME -cp “/tmp/sapinst_exe.11150.1500025977/JAR/instgui.jar” SDTServer “rootdir=/root/.sdtgui” config=jar:sdtserver.xml guiport=21212 -nolock -srvarg=/SAPinstService/host=127.0.0.1 -srvarg=/SAPinstService/port=pipe:5:8 guistart=off

    guiengine: 2017-07-14 11:53:04 Waiting for client connection (1)
    load resource pool /tmp/swpm/resourcepool.xml
    Jul 14, 2017 11:53:07 AM [Info]: *************************
    Jul 14, 2017 11:53:07 AM [Info]: Starting Server
    Jul 14, 2017 11:53:07 AM [Info]: Reading server configuration.
    Jul 14, 2017 11:53:07 AM [Info]: Reading service configuration SAPinstService.
    Jul 14, 2017 11:53:07 AM [Info]: Configuring LogManager …
    Jul 14, 2017 11:53:07 AM [Info]: *************************************************
    Jul 14, 2017 11:53:07 AM [Info]: Starting SL Controller listening on port 21212 …
    Jul 14, 2017 11:53:07 AM [Info]: StorageService switched off.
    Jul 14, 2017 11:53:07 AM [Info]: Initializing SecurityManager …

    guiengine: No GUI server connected; waiting for a connection on host vhcalnplci, port 21212 to continue with the installation
    Jul 14, 2017 11:53:09 AM [Info]: Server certificate fingerprint is 28 F8 62 93 27 BE C0 F6 92 6E E9 E9 D7 56 CC B4
    Jul 14, 2017 11:53:09 AM [Info]: HTTPManager switched off.
    Jul 14, 2017 11:53:09 AM [Info]: WebstartService switched off.
    Jul 14, 2017 11:53:09 AM [Info]: RoleService switched off.
    Jul 14, 2017 11:53:09 AM [Info]: AlertService switched off.
    Jul 14, 2017 11:53:09 AM [Info]: NotesService switched off.
    Jul 14, 2017 11:53:09 AM [Info]: ProcessService switched off.
    Jul 14, 2017 11:53:09 AM [Info]: MIDService switched off.
    Jul 14, 2017 11:53:09 AM [Info]: Starting FileService …
    Jul 14, 2017 11:53:09 AM [Info]: LogService switched off.
    Jul 14, 2017 11:53:09 AM [Info]: MailService switched off.
    Jul 14, 2017 11:53:09 AM [Info]: Starting services …
    Jul 14, 2017 11:53:09 AM [Info]: Starting service “SAPinstService” …
    Jul 14, 2017 11:53:09 AM [Info]: Service “SAPinstService” started
    Jul 14, 2017 11:53:09 AM [Info]: Services started.
    Jul 14, 2017 11:53:09 AM [Info]: SL Controller started.

    I have tried many other ways to start install.sh, but with no success.

    Please guide me to the next step that I should perform.

     

     

    (0) 
    1. Harald Wilde

      Hallo Heiner,

      Same here. Watch out my thread a bit bottom down for some useful information beside, especially a better alternativ installation guide which makes some things easier.

      (0) 
  2. Cezary Kakowski

    Hello Julie, Hi Everyone!

    First thing – thanks a lot for this really neat step-by-step guide!

    I’d be 100% pleased if it acutally worked for me.

    My problem, at first, was that even if i changed hostname to the one requested it prompted that it’s not complient with standard (after hitting hostname command it prompted the old hostame).

    Yes i was in sudo when changing – solution was simply restarting linux before proceeding with anything.

    But before i figured that out i tried with ./install.sh -s – error the same some guys reported – seemingly it couldn’t change “sa” database user password to other. I also tried with -g but stuck on SL Controller started (or whatever that is) and no action.

    Then i took second try:

    I formatted completely my Virtual OpenSUSE, then before changing anything related to SAP Installation i updated every package installed forcibly by Online update (You can pick all installed packages when prompt is popping up, also You can install uuidd by the way).

    Then (after proceeding all preparation steps) i tried to install it once again (this time i restarted machine after changing hostnames). This time name convention was checked correctly.
    So i wanted to install my instance with graphic option.

    After hitting ./install.sh -g it went out fine until i got a message that no GUI server is installed and it listens on port 21212. So i said “f* it”, let’s give it a try without -g.

    The same message popped out – impossible to change username. And without any switch in install command i got the same result – “sa” was the problem for the installer.

    I think i’ll continue to describe my struggles here, maybe it will help anybody.

    Cheers,

    Cezary

    (0) 
    1. Cezary Kakowski

      Okay i gave it another try:

      This time i applied advice from Radek (to supply password – step 21 – not necessarily from Linux itself, but use pattern – small and capitalized letters plus digits without any special characters).

      I think Step 21 is kinda misleading. I thought at first i have to supply my sudo username over there twice, whereas it’s a SAP Admin and Database Admin pwd.

      Anyways:
      The same error message – cannot change password for user “sa”.

      I can log into both account on Linux – Database Admin and SAP Admin but i cannot execute on SAP Admin isql command, but there’s a possibility to apply this on Database Admin. Unfortunately there’s some .NET exception occuring – it cannot get connection to database nodes.

      SAP is literally first bigger program i have problems installing.

      Wouldn’t it be good to create some VHD with already installed and bootable version of correctly configured SAP Instance? I woudln’t mind to download 50 gb file (in parts) from Your servers, still i have to download like 15 gb

      I think i will give up for some time installing SAP.

      Cheers,

      Cezary

       

      (0) 
  3. Devidas P

    Hello Julie,

    The installation stops (keeps waiting) at the following line. Am I missing anything during the installation? Please help.

    guiengine: No GUI server connected; waiting for a connection to host vhcalnplci, port 21212 to continue with the installation.

     

    Thank You

    Devidas

    (0) 
    1. rathan george

      Hi Devidas,

      Restart your installation. Start fresh with your Suse Installation.

      Follow the below installation guide point to point.  

      https://sap.github.io/cloud-s4ext/week-1/unit-6/

      As the database license has expired. You’ll see password failure issue.

      Take a snapshot at that point.

      New ASE license is available here: Use this as per the instructions. You should be a root user to copy the specified licence.

      Renew ASE License: SAP Document Center

      Now use ./install.sh -g option. From that point. Fresh installation is not necessary. If something fails you start your OS from the snapshot that you have taken.

       

      (1) 
      1. Harald Wilde

        on my OracleVM/SUSE the -g Option does not work. Without this option it was successfull. Another hint if you are new like me with Linux/SUSE: Download the new license File unzipped, without the .pdf file. I used the SUSE Firefox for that.

        Hmm, yesterday the new SUSE/SAP system was up and running and i have had access with SAP_GUI, But today it aborts after “startsap ALL” with message “no Profil found”. Well… complete new Installation seems to be tricky. I will uninstall SAP/SUSE again like described here in blog and then try the installation guide provided by rathan.

        Rathan, please..Im not familar with rights in linux…

        How is the replacing done exactly? Last time i replaced it in XTERM with “su npladm” followed by “chown -v npladm licenses” and then copy with

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

        Do i need to change rights after replacing it? Or something other to be done?

        (0) 
        1. rathan george

          Hi Harald,

          On the logon screen when you login to Suse, switch user to root or enter root for user and login password. Ideally you are in the root now. Navigate to the said folders copy and paste the required licences. You have to change the rights after replacing the file. You can right click on the file and change the permissions. When you check the properties you’ll see the details for a root user (default permissions). Change the users to the proposed names in the license file.

          Thanks and Regards,

          Rathan.

           

           

           

          (0) 
          1. Harald Wilde

            Many thanx for your reply. I made complete new installation from th eOpenSAP Guide (which is better) but No User=root  available at login screen. Nevertheless i replaced the license file with command… above. Replacing was successful, now checking the rights..

            Do i need JAva SAP-GUI on SUSE for the install -g command? Because installation hanging at that point: “No GUI server connected; waiting for a connection on host vhcalnplci, port 21212 to continue with the installation” ist doesnt semmed to be the license problem…

            (0) 
            1. Harald Wilde

              There are no users named in the license File “SYBASE_ASE_TestDrive.lic”. I found nice apllication called “”File Manager – Super User Mode”. I think this is a File-explorer with root rights. Propertiese of the “SYBASE_ASE_TestDrive.lic” show rights as follows (i think its alright) 

              I will try it again from snapshot before replacing the license file. Just to see what rights are there before replacing…

              -restore snapshot- and yes.. permissions before replacing are exactly the same. Must be other reason.

              Also this speaks for that these are the right permissions: Karl Kessler on Twitter

              (0) 
              1. Harald Wilde

                I think i got it now. Without the -g option. See my post earlier in this thread searching for “In case of complete new installation”. For today it works after restarting. if i get again an error tomorrow i wil post it.

                 

                (0) 
      2. Devidas P

        Hi Rathan,

         

        Greetings! Thanks for your help. I tried as per your instructions however I am still not able to complete the installation successfully. Do I need to start any GUI server in order to complete the installation. Because the installation stops and waits with the following details;  Appreciate your help!

         

        The GUI could not be started because the environment variable DISPLAY is not set. Please make sure that this variable is defined correctly or start the GUI on another host (for details please consult the installation guide)

         

        Starting GUIServer using:
        SAPinst port : 21212
        GUI autostart : off
        GUI mode : normal
        command : /tmp/sapinst_exe.10110.1500992629/jre/bin/java -Xmx512M -Dsap.env.var.javahome=SAPINST_JRE_HOME -cp “/tmp/sapinst_exe.10110.1500992629/JAR/instgui.jar” SDTServer “rootdir=/root/.sdtgui” config=jar:sdtserver.xml guiport=21212 -nolock -srvarg=/SAPinstService/host=127.0.0.1 -srvarg=/SAPinstService/port=pipe:5:8 guistart=off

        guiengine: 2017-07-25 19:53:57 Waiting for client connection (1)
        load resource pool /tmp/swpm/resourcepool.xml
        Jul 25, 2017 7:54:00 PM [Info]: *************************
        Jul 25, 2017 7:54:00 PM [Info]: Starting Server
        Jul 25, 2017 7:54:00 PM [Info]: Reading server configuration.
        Jul 25, 2017 7:54:00 PM [Info]: Reading service configuration SAPinstService.
        Jul 25, 2017 7:54:00 PM [Info]: Configuring LogManager …
        Jul 25, 2017 7:54:00 PM [Info]: *************************************************
        Jul 25, 2017 7:54:00 PM [Info]: Starting SL Controller listening on port 21212 …
        Jul 25, 2017 7:54:00 PM [Info]: StorageService switched off.
        Jul 25, 2017 7:54:00 PM [Info]: Initializing SecurityManager …

        guiengine: No GUI server connected; waiting for a connection on host vhcalnplci, port 21212 to continue with the installation
        Jul 25, 2017 7:54:08 PM [Info]: Server certificate fingerprint is DD EE 1E B6 77 6C 6D 51 36 82 EA BB FB 3C 66 FC
        Jul 25, 2017 7:54:08 PM [Info]: HTTPManager switched off.
        Jul 25, 2017 7:54:08 PM [Info]: WebstartService switched off.
        Jul 25, 2017 7:54:08 PM [Info]: RoleService switched off.
        Jul 25, 2017 7:54:08 PM [Info]: AlertService switched off.
        Jul 25, 2017 7:54:08 PM [Info]: NotesService switched off.
        Jul 25, 2017 7:54:08 PM [Info]: ProcessService switched off.
        Jul 25, 2017 7:54:08 PM [Info]: MIDService switched off.
        Jul 25, 2017 7:54:08 PM [Info]: Starting FileService …
        Jul 25, 2017 7:54:08 PM [Info]: LogService switched off.
        Jul 25, 2017 7:54:08 PM [Info]: MailService switched off.
        Jul 25, 2017 7:54:08 PM [Info]: Starting services …
        Jul 25, 2017 7:54:08 PM [Info]: Starting service “SAPinstService” …
        Jul 25, 2017 7:54:08 PM [Info]: Service “SAPinstService” started
        Jul 25, 2017 7:54:08 PM [Info]: Services started.
        Jul 25, 2017 7:54:08 PM [Info]: SL Controller started.

         

        Thank you

        Devidas

        (0) 
        1. rathan george

          Hi Devidas,

          You don’t have to start the GUI server.  When the Installation fails for the first time with password failure issue with an error something like this ““sa” database user password to other”.

          Did you take  a snap shot at this point?

          If you saved it at this point, Restart your machine using this snapshot. Login as root user into your system. User Name: root password: <yourpassword>.

          Copy the new ASE licence as proposed in the file. Change all the user permissions as suggested.

          As you are already in root, navigate to the installation folder after mounting your folder with the installation files if your installation is on another folder.

          Do a /install.sh -g. After some time SAP Should launch a GUI window so that you can perform installation steps using the navigation and confirmation buttons on the screen.

           

          Thanks,

          Rathan.

           

          (0) 
          1. Harald Wilde

            Hi Rathan,

            Have you tried out the -g option by yourself on OracleVM/SUSE System with  a windows SAP-Gui? I tried it many times including waiting hours for the gui but without success. leaving the -g option -now, this day- seems to do it. After checking rights of the replaced  SYBASE license file and renewing SAP license in Transaction SLICENSE the same day like installation and without restarting the SAP.

             

            (0) 

Leave a Reply