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
Document History Document Version Authored By Description 1.0 Customer Experience Group First release of this guide 2
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
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
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
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
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
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
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
Choose the menu option File -> New -> Project H2G Install SAP Web IDE locally for trial (Mac version) 4.3 Configure and start Eclipse Orion... 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
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
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
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
Choose the menu option File -> New -> Project 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. 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
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
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
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
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
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
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
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
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
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.