Download as pdf or txt
Download as pdf or txt
You are on page 1of 24

SAP Web IDE

How-To Guide

Provided by Customer Experience Group

H2G Install SAP Web IDE locally for trial (Mac


version)

Applicable Releases:
SAP Web IDE 1.4

Version 1.0 - October 2014


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

Document History
Document Version Authored By Description

1.0 Customer Experience First release of this guide


Group

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

TABLE OF CONTENTS
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.5   Connect  to  an  external  Git  repository  ................................................................................................  20  

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

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) Connect to an external Git repository

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

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.

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

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
and the Info.plist file will open

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

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

13. The fix has been successfully applied.

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

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


unzip ~/Downloads/eclipse-orion-5.0-macosx.cocoa.x86_64.zip

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

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.

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

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

4. Click on Choose Application…

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

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

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

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

11. Enter the required information and click on Sign up

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

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”

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

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

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

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

8. Create a new project (i.e. a new SAP Fiori Starter application),

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

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

10. You can click on Next and continue with the project creation

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

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

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

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

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

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

10. You should be able to see the list of services provided by that system

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

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

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

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

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

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

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

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

12. The project has been cloned successfully

23
www.sap.com

© 2014 SAP SE. All rights reserved.

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.

Crossgate, m@gic EDDY, B2B 360°, and B2B 360° Services are
registered trademarks of Crossgate AG in Germany and other
countries. Crossgate is an SAP company.

All other product and service names mentioned are the trademarks of
their respective companies. Data contained in this document serves
informational purposes only. National product specifications may vary.

These materials are subject to change without notice. These materials


are provided by SAP SE and its affiliated companies ("SAP Group")
for informational purposes only, without representation or warranty of
any kind, and SAP Group shall not be liable for errors or omissions
with respect to the materials. The only warranties for SAP Group
products and services are those that are set forth in the express
warranty statements accompanying such products and services, if
any. Nothing herein should be construed as constituting an additional
warranty.

You might also like