H2G Install SAP Web IDE locally for trial (Mac version)

(1)

Provided by Customer Experience Group

H2G Install SAP Web IDE locally for trial (Mac

version)

Applicable Releases: SAP Web IDE 1.4

(2)

Document History

Document Version Authored By Description

1.0 Customer Experience

Group

(3)

1. Business Scenario ... 4

2. Background Information ... 4

3. Prerequisites ... 4

4. Step-‐by-‐Step Procedure ... 4

4.1 Download and install Java ... 5

4.2 Download and install the required software ... 8

4.3 Configure and start Eclipse Orion ... 10

4.4 Connect to a remote system ... 14

4.4.1 Connecting to a generic OData source ... 14

4.4.2 Connecting to an ABAP system ... 17

(4)

1. BUSINESS SCENARIO

SAP Web Integrated Development Environment (or SAP Web IDE) is a next-generation cloud-based

meeting space where multiple project stakeholders can work together from a common web interface, connecting to the same shared repository with virtually no setup required. It includes multiple interactive features that allow you to collaborate with your colleagues and accelerate the development of your HTML5/UI5 applications.

2. BACKGROUND INFORMATION

In this How-To Guide we will see how to install SAP Web IDE locally for trial on a Mac. For this example we are using a Mac with OSX Yosemite 10.10.

3. PREREQUISITES Some prerequisites:

• A copy of the SAP Web IDE installation package. You can get it from here: you just need to fill the form with your data and follow the instructions.

4. STEP-BY-STEP PROCEDURE This is the sequence of steps:

1) Download and install Java

2) Download and install the required software 3) Configure and start Eclipse Orion

4) Connect to a remote system

(5)

4.1 Download and install Java

In order to run Eclipse Orion and Eclipse Director you need to have a JDK installed on your Mac. You need at least version 6. Unfortunately, version 8 is still not fully supported. It’s important that you install the JDK because, otherwise, just with the JRE, you cannot launch the Java command to run Eclipse Director from the Terminal.

1. To check your JVM version you simply need to open the Terminal and run the command “java -version”. If you get this

then it means that you don’t have any JVM installed. If you have already a valid JVM you can skip this chapter

2. In order to download a JDK you can go to Java SE downloads.

3. Once downloaded, double click to mount the .dmg file and follow the instructions. The version we are downloading in this example is JDK 7 release 72, but any other newer release of version 7 should be fine. As I said, at moment Java 8 is not fully supported.

(6)

4. After the installation, if you run the “java -version” command again, you should see this

This means that JVM has been installed successfully

5. For JDK 7 there is a fix that we need to apply because when you will start Eclipse Orion the first time it will prompt you to install Java 6, even though JDK 7 is already installed. This because JDK 7 comes with some disabled capabilities and Eclipse Orion looks just for that. To enable those capabilities, perform the next steps. Open Terminal

6. Run the command

cp /Library/Java/JavaVirtualMachines/jdk*.jdk/Contents/Info.plist /tmp to copy the Info.plist file in a temporary folder

7. Type

open /tmp/Info.plist

(7)

8. Locate the section “JVMCapabilities” and add in there the following lines <string>JNI</string>

<string>BundledApp</string> <string>WebStart</string> <string>Applets</string>

9. Save and close the file

10. Now you need to copy back this file. This time we need to run the command with sudo since you are not the owner of the file that will be replaced:

sudo cp /tmp/Info.plist /Library/Java/JavaVirtualMachines/jdk1.7.0_72.jdk/Contents/ 11. Enter the password for sudo and the file will be overwritten

12. Reboot you Mac

(8)

4.2 Download and install the required software You need to download 3 packages:

• Eclipse Orion: it’s a web based version of Eclipse

• Eclipse Director: it’s a tool that allows you to install some further components into Eclipse. It works from the command line

• SAP Web IDE installation zip file 1. Download the Eclipse Orion package at

http://www.eclipse.org/downloads/download.php?file=/orion/drops/R-5.0-201402262325/eclipse-orion-5.0-macosx.cocoa.x86_64.zip&mirror_id=17

2. Download Eclipse Director package at

http://www.eclipse.org/downloads/download.php?file=/tools/buckminster/products/director_latest.zip

3. Download the SAP Web IDE installation package from SCN to your local hard drive. The file you download is something like “SAP_Web_IDE_Local_Inst.zip”. Once you have extracted it, you will find a file named “updatesite.zip”. This is the SAP Web IDE installation package

4. Open Terminal

5. Create a new folder in the “/Applications” path named “SAPWebIDE” with the following command: mkdir /Applications/SAPWebIDE

6. Go into this new folder

cd /Applications/SAPWebIDE

7. Extract the Eclipse Orion package in /Applications/SAPWebIDE

(9)

8. Extract the Eclipse Director in /Applications/SAPWebIDE

unzip ~/Downloads/director_latest.zip

9. At the end, you should have the following folder structure

10. Go to the /Applications/SAPWebIDE/director folder cd /Applications/SAPWebIDE/director

11. Run this command in order to install the SAP Web IDE package into Eclipse Orion: ./director -repository jar:file:/<location of the downloaded zip file>\!/ -installIU

com.sap.webide.orionplugin.feature.feature.group -destination /Applications/SAPWebIDE/eclipse In our example it’s

./director -repository jar:file:/Users/macadmin/Downloads/updatesite.zip\!/ -installIU com.sap.webide.orionplugin.feature.feature.group -destination

/Applications/SAPWebIDE/eclipse

NOTE: Pay attention to the part in yellow “\!/”, this is not an error. The “\” is required to escape the “!”, because this is a special symbol: it allows the zip file to be automatically extracted 12. You have successfully installed your local copy of SAP Web IDE

13. Should you need to uninstall, you can use the command

director -uninstallIU com.sap.webide.orionplugin.feature.feature.group -destination /Applications/SAPWebIDE/eclipse

IMPORTANT!!! : If you need to install a new version of SAP Web IDE, you have first to uninstall the previous version and then install the new one.

(10)

4.3 Configure and start Eclipse Orion

... Choose the menu option File -> New -> Project

Before starting Eclipse Orion, let’s change the port of the Orion server by modifying a parameter in the configuration file.

1. With Finder select the Applications folder and go inside the eclipse subfolder. Let’s change the default Eclipse Orion port from the standard 8080 to 9090. This is an optional step, but since there could be other software running on that port, it’s a best practice to change it

2. Right click on the orion application and choose Show Package Contents

3. Expand Contents and MacOS and double click on the orion.ini file

(11)

5. Use TextEdit and click on Open

6. Locate the line “-Dorg.eclipse.equinox.http.jetty.http.port=8080”, change the port number to 9090 and save the file

7. Double click on the Eclipse Orion application to start it. If you are not able to open it for security reasons you can try by double clicking on it while holding the control key

(12)

8. You will get a new terminal window like this: don’t close it

9. Open your Internet browser and type http://localhost:9090/webide/index.html

10. The Eclipse Orion home page will be loaded. Click on Create a new account

(13)

12. Your local SAP Web IDE will be loaded

13. You have successfully started your local SAP Web IDE

14. Should you need to close SAP Web IDE and Eclipse Orion, close first the browser page containing SAP Web IDE and then select the console that Eclipse Orion opened when you started it up. Type the command “close” and then hit ENTER. Confirm to close it by pressing “y”

(14)

4.4 Connect to a remote system

...

Now that we have configured our SAP Web IDE, we might also want to connect it to a remote system to get some data.

There are basically 4 ways to do it and for a couple of them you need to create a special destination file, which gives to SAP Web IDE all the needed connection information.

In particular, we might want to connect to a generic OData source or to an ABAP system. Let’s give a look to how we can create the destination files for these two connection methods.

Choose the menu option File -> New -> Project

4.4.1 Connecting to a generic OData source

Let’s suppose we want to connect to the public sample gateway system “sapes1.sapdevcenter.com”. You can get more information and register to it by going to the page Getting started with the SAP Netweaver Gateway Service Consumption System.

1. Open terminal 2. Type cd /Applications/SAPWebIDE/eclipse/orion.app/Contents/MacOS/config_master/service.destinatio ns/destinations/ 3. Type touch es1 4. Type open es1

(15)

5. Append the following lines to the file: Description=es1 Type=HTTP TrustAll=true Authentication=NoAuthentication WebIDEUsage=odata_gen Name=es1 WebIDEEnabled=true URL=https\://sapes1.sapdevcenter.com ProxyType=Internet WebIDESystem=es1

6. Save the file

7. Close SAP Web IDE, if it was already open, and restart it. You will probably need to sign again in Eclipse Orion

(16)

9. At the step “3 - Data Connection” you can do the following: a. Click on Service URL

b. Select the es1 destination

c. Enter the path to the resource (it will be concatenated with the URL specified in the destination). In this example we can use “/sap/opu/odata/IWFND/RMTSAMPLEFLIGHT/” d. Click on Select

e. After entering the credentials for accessing the gateway system, you will get the list of the available OData entities

(17)

4.4.2 Connecting to an ABAP system

Instead, if you want to connect to an ABAP system, you need to create a different kind of destination. Let’s suppose you want to connect to the GM6 ABAP system (https://ldcigm6.wdf.sap.corp:44333) in order to consume some OData for creating a new Fiori app or for extending some existing ones. Furthermore you want also to execute some other SAPUI5 applications. We need to pass this information to the SAP Web IDE and the way to do it is through the destination’s additional property WebIDEUsage; we need to specify in this property the three usages we want to have with this destination: odata_abap (for consuming OData), dev_abap (for extending existing Fiori apps) and ui5_execute_abap (for executing SAPUI5 apps). Please refer to the official SAP Web IDE

documentation to get more information on this.

NOTE: Please notice that GM6 is an internal SAP system, so you might not have access to it. 1. Open terminal 2. Type cd /Applications/SAPWebIDE/eclipse/orion.app/Contents/MacOS/config_master/service.destinatio ns/destinations/ 3. Type touch GM6 4. Type open GM6

(18)

5. Append the following lines Description=GM6 HTTPS destination Type=HTTP TrustAll=true Authentication=NoAuthentication Name=GM6 ProxyType=Internet URL=https\://ldcigm6.wdf.sap.corp\:44333 WebIDEUsage=odata_abap,ui5_execute_abap,dev_abap WebIDESystem=GM6 WebIDEEnabled=true

6. Save the file

7. Close SAP Web IDE if it was already open and restart it. You will probably need to sign again in Eclipse Orion

(19)

8. If you start creating a new project you should be able to see your remote server in the list

9. Enter your credentials for GM6

(20)

4.5 Connect to an external Git repository

...

Since you need to pass through a proxy you cannot access your Git repositories. For this you need to do some configuration. First of all you need to configure the orion.ini file to allow the SAP Web IDE to pass through the proxy.

Choose the menu option File -> New -> Project

1. Close SAP Web IDE and exit from Eclipse Orion as explained at step 14 of 4.3 2. With Finder select the Applications folder and go inside the eclipse subfolder

3. Right click on the orion application and choose Show Package Contents

(21)

5. Add the following lines to the file, just after the -vmargs line: -‐Dhttp.proxyHost=<proxy>

-‐Dhttp.proxyPort=<port> -‐Dhttps.proxyHost=<proxy> -‐Dhttps.proxyPort=<port>

-‐Dhttps.nonProxyHosts=<hosts to be excluded from proxy> In our example it’s

-‐Dhttp.proxyHost=proxy.wdf.sap.corp -‐Dhttp.proxyPort=8080

-‐Dhttps.proxyHost=proxy.wdf.sap.corp -‐Dhttps.proxyPort=8080

-‐Dhttps.nonProxyHosts=*.sap.corp|localhost

6. Save the file

7. Restart Eclipse Orion and reopen SAP Web IDE

8. You need now to configure the account settings for the SAP Web IDE Git Client. Click on Tools à Git Settings

(22)

9. Provide your account information and click on Update

10. You have successfully configured your Git client with a proxy. You can test it by simply going to File à Git

àClone Repository

11. Enter the name of a repository you want to clone in your environment, provide your credentials and click on OK

(23)

(24)

SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP BusinessObjects Explorer, StreamWork, SAP HANA, and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP SE in Germany and other countries.

Business Objects and the Business Objects logo, BusinessObjects, Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, and other Business Objects products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of Business Objects Software Ltd. Business Objects is an SAP company.

Sybase and Adaptive Server, iAnywhere, Sybase 365, SQL Anywhere, and other Sybase products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of Sybase Inc. Sybase is an SAP company.

H2G Install SAP Web IDE locally for trial (Mac version)