Technical Articles
Installing SAPWebIDE Personal Edition and connect it to a System
Todays blog is about the setup of the webide personal edition. There are some blogs out there, explaining how to setup it. In the meantime, the world did not stand still and I had my issues to get started easily.
So for all folks of you, going to get on that road the next days / weeks / months (not years) here I give you the lessons I have gone through the last days.
- Connect your system to the webIde. Working with the metadata-file end in a lot of work to handle the connection between your system and the app!
- Make sure, you have a naming convention out there, not because I like guidelines that much, moreover to be absolutely clear how to identify your apps and avoid strange symptoms because of similar names
- Using templates does not mean, you do not need a concept before. Whenever you are going to develop something new, you need to know in which direction you aim, and this is a really big pain point if you do not know that.
So, ok, enough from the fancy tips, but please remember those, when it comes the call to action!
Ok, how to setup the SAP WebIDE personal edition?
- visit tools.hana.ondemand.com and browse to the ui5-tab
–> download the preferred version
- Follow the guide section install
–> Make sure, that you do not use the build in zip tool from microsoft. The guide is not that clear, but this extractor cannot handle long filenames and you will end in this message
when trying to start the server.
I used 7zip and it worked fine (ok, have to be true, used it at the second time:-))
Extract the zipped files to C:\SAPWebIDE.
The folder-structure should look like this in the end:
Have done it, because of the guide, not sure if this is necessary, but you know, when there is a guideline, stick to it.
- Start the WebIDE and test, if you can reach the website
http://localhost:8080/webide/index.html
–> To start the WebIDE you have to go to the folder eclipse and start the orion.exe (marked yellow above)
This window should show up
When your at that point, the local parameters look all fine for the moment and you can proceed with step 4, if you are in trouble, I can recommend to copy paste the message you get and search sap community.
- Connect to a onPremise system
- Create some folders as explained here
Yes, these all are folders, destinations is also a folder, not the file!
- Create for your onPrem System a textfile (my example is A4H)
delete the extension, it should look similar to this screenshot
- Now open it with your preferred editor and copy paste the follwing lines (These are also included in the guide mentioned above)
Description=<mysystem> description Type=HTTP TrustAll=true Authentication=NoAuthentication Name=<mysystem> ProxyType=Internet URL=https\://<host>\:<port> WebIDEUsage=<add a value according to the table below> WebIDESystem=<mysystem> WebIDEEnabled=true sap-client=<SAP client number for ABAP systems only. Delete this line if you are not using an ABAP system.>
Should look like this at the end (of course, you also have a host and port included)
The yellow marked part is in my example everything you can insert here.
As a sidenote here, also pay attention to the sap-client. The docker 1909 need the client 001
You have to choose, what you want to do with your connection.
Also the ProxyType could be OnPremise, when your behind a firewall
Both are explained in the above link.
- When you have finished that, you have to configure your system you want to connect also.
Log on to your system and open transaction SICF
Make sure you have activated the following nodes including all subnotes!!
- /sap/opu/odata
for the OData functionality of Gateway
- /sap/bc/ui5_ui5
for executing SAPUI5 applications from the SAPUI5 ABAP Repository
- /sap/bc/adt
for extensibility scenarios and developing or deploying to SAPUI5 ABAP Repository
- /sap/bc/bsp
- /sap/bc/ui2
for working with fact sheets
- /sap/hba
for SAP HANA XS OData services
If you have installed SAP_BASIS 7.31 SP 14 or 7.40 SP 8 or later everything fine, if not have a look at the link, there are some notes mentioned what to do.
Here’s the link to the guide explaining it:
When you have finished all of the above you can start your orion-server again and try to consume a service. It should appear a logon dialog when trying that and everything is fine.
Conclusion:
The official guide do include all the information I have mentioned in my blog here. It’s just not that easy to read, because it mix up the different WebIDE Editions and so I thought this could be a helpful blog for those, starting the journey right now.
Another problem are also the older blogs on that topic. Installationpath has changed over the time and you have to figure it out, if the problem or the recommendation is still valid, so this will also happen to this blog at a time. But I think for 2018 it will remain the same:-)
Like always, add your comments, thoughts and if there is room for improvement (and I’m sure there is) let me know.
How do you handle the versions you created with the WebIDE, right now I download the projects and save it to the task. Sometimes I have only one App and I think a Git-Server is a little to big to control the versions. Are there any alternatives out there (next to the filesystem?)
The next blog will cover the odata-creation with CDS and Eclipse, but that could take me a while;-)
~Florian
Great walkthrough Florian. But for activating the Backend services I would suggest to use the existing task lists in Transaction STC01. Check out this slide of my SAP TechEd 2016 Talk: Tips and Tricks for an Efficient Implementation of SAP Fiori.
Thank you Gregor. The ABAP Task lists are powerful. IS there somewhere an overview, what lists are there and what these are for? Hard to identify at the moment...
~Florian
I would try the F4 help first. In many cases i.e. S/4HANA UX the Best Practice Guides mention them.
Hi Florian,
This blog seems like a repeat of the documentation for me.. You say it's unclear or not easy to read, so maybe I can make it easier to read instead of adding more places with the same info... I also don't understand how it "mix up the different Web IDE editions".. We have a section for the personal edition in the SAP Web IDE documentation and in SAP Web IDE Full-Stack documentation. Do you have a different proposal to make it more convenient?
With regards to improving the documentation, I can add a section at the end that recommends the users to execute the SAP_BASIS_ACTIVATE_ICF_NODES task from the Task List. Will that be sufficient?
Thanks,
Michal.
Hi Michal,
as I mentioned above, the official documentation do include everything you need to do, but it is not easy to read at all. For example the connection to a system is not explained in a way, I would expect it.
Here is the section how to connect to a system
so, why is there a separation of personal edition and cloud. I would expect one section in the documentation how to connect to a system.
Whenever I read documentations I start at the very beginning, because in the past this was always the way how SAP provided documentation.
And a "Getting Started" Section does talk to me exact that what it sounds, but right here, there is a extra section at the end, why?
So before wasting time again I have “documented” it in a way I would want to see it.
Maybe it’s just me, who know.
~Florian
also - here we can post our queries too , which isn't possible with SAP Help doc.
Sreehari
Hi Michal,
do you need more details than the given ones below? We can also have a chat on the topic.
~Florian
Nice step by step and very useful for me.
Thank you!
Michelle
Hi Florian.
Do you know when to upgrade WebIDE personal edition.?
Todays version UI5 in personal edition is 1.44 and in cloud 1.54.3
Updates to the personal edition comes every quarter. As a result of the process with convert and testing that the cloud-version is always some steps ahead..
~Florian
Thanks, Florian for answer.
But at https://tools.hana.ondemand.com/#sapui5 we see
SAP Cloud Platform, Web IDE Personal Edition. Updated: 06/07/2017
and it's almost a year ago. It is a not every quarter.
Hi Alexander K ,
haven't seen your comment. Anyway, the answer is, that you can download the different versions a little more below, so no need to rearrange the whole software.
Hi Florian,
nice writeup and good tips. just one clarification request. if configuration is correct, shouldn't point 3 show somewhere a successful population of the dropdown of the (destination SID) System, e.g. here?
Thank you, greg
Yes, there should be a system now after restarting the WebIDE Server.
IF there is nothing make sure, you have the path correctly insert.
C:\SAPWebIDE\eclipse\config_master\service.destinations\destinations\ <-- Here is the file located
I've created a file at this location with the contents described in your blog. In SAPWebIDE though there still is no system shown in the "select application from SAPUI5 ABAP Repository" dialog (same as the image above).
Another commenter below mentions the file type of the destination file is important. I created it as a text file and simply removed the file extension as your blog describes, but the file remains a "type TXT" file. Is this the problem?
I've also tried instead to create a file with no type in Notepad++ with the same contents. This file's type shows as simply "File", but still there is no destination shown in SAPWebIDE.
After putting the file there you need to restart the whole application. And yes, if it is still shown as txt-file it might be your problem.
Did you name the file like the SID? I think that is mandatory.
Hi Florian,
I did restart Orion and also closed and reopened the Chrome browser and navigated again to the localhost URL and logged in. Still there are no systems listed in the dialog. The system file is currently just of type "File" and not "Text" and is named the same as the system I want to connect to (although I don't know how Orion would know one way or the other whether the file name is also a SID). I wonder if you have any other ideas? Are there other components that need to be installed?
Cheers,
Amy
MAy you post the file what's in the itself and maybe as a seperate question
Thanks for the reply Florian. I've posted my question separately.
Hi Experts!
I just joined a company and they need to develop Fiori Applications that will be hosted on SAPUI5 ABAP REPOSITIRY.
What development environment would you recommend?
Is a subscription in SAP Cloud Platform necessary to use the SAP WEB IDE service?
If the above is not necessary, can I use SAP WEB IDE trial for this purpose?
Should the company pay a subscription to do this type of development?
Thank you very much for your comments.
Regards!
Hi Florian,
I need to know how to install SAP Web IDE Personal Edition on Windows Server System .. where I have my SAP Gateway [ OData ].
Thanks ,
Bhaskar.
No, you have to install it on your personal machine..
Thank you Florian
Bhaskar
Hello Expert,
Can i use SAPWebIDE Personal Edition for on premise S/4 HANA 1610 fiori standard app extension project?
Thanks
Of course, that is exactly what I have done in the beginning. Just make sure to understand what kind of version you can use with your release. Not that you are wondering that some things do not work as expected.
Thanks a lot for your reply. I was wondering why someone use Web IDE as cloud service to implement simple extension on S/4 HANA on premise Fiori App when personal web IDE is available for such extension.
Customer has already paid license fees for S/4 HANA 1610. Now why customer will pay again for Web IDE as cloud service?
Thanks
Using the personal edition does not mean you get it for free. The personal edition is divided in two versions.. trial and productive.
It's just delivered as install local installation, because some companies have such high security rules, that SAP has decided to also offer it as a local installation.
So be aware, using the personal edition for productive development, does also mean you have to pay 😉
Hi Florian,
Do you know what is difference between Cloud Web IDE and on premise Web IDE (personal edition - Productive) with respect to Fiori extension development?
I know if i am going for cloud web ide then i need to use cloud connector to connect on premise system.
Thanks for your reply and support.
Doesn't have any differents. The "Cloud Edition" is just always up to date and the personal edition gets an update every quarter. But regarding the extension possibilities you won't be limited with the personal edition. At least I haven't found something for the extensions I have done so far.
Hi Florian,
thanks for sharing this! It was a great help for me, a good summery of different pages with valuable hints.
Best regards
Renald
Hi FLorian,
Thanks for this helpful blog. I could install webide personal very quickly on one system. However on antother system, I have Java version 10, and I think due to this reason I am not able to install webide person. Orion server is starting but when i give the URL , I get the error message-
HTTP ERROR: 404
Problem accessing /webide/index.html. Reason:
How have you extracted the package. I mean what tool. MAybe you have used the windows integrated one by accident.
I don't think that the java-version is the rootcause of the problem.
Otherwise you can have a look here:
https://wiki.scn.sap.com/wiki/display/SAPHCP/SAP+Development+Tools+for+Eclipse+Installation%3A+FAQ+and+Known+Issues
Hi Florian,
Thanks for the promot reply...It's running now...My one more mistake was that destination file should not be created as txt file.
Best Regards
Smriti
Hi Smriti,
that was a very important step. I looked everywhere for a solution and never thought about changing the filetype. Thank for mentioning it after finding a solution. It saved me a lot of time.
Best Regards
Dennis
With Personal WebIDE, I am able to build UI5 applications and execute them without any issues. But, I am not able to open Websocket connections, and get a 404 error. It seems that ws:// urls are not getting translated into correct endpoints, like in case of a odata call. Is there anything to be setup specifically, to enable Websocket connects?
I am trying to connect to ABAP backend, to use ABAP Push Channels. The channel works when I try to test it using SE80.
Thanks,
Juwin
I do not know a setup you have to do, but can imagine, that your problem is, that if you have developed your ui5 application with the personal edition, the local server just have problems to connect to your backend.
I suggest you have already checked, that you added
everything possible to your connection-file. As I have not used such a scenario maybe you create a question for it.
~Florian
Hello Florian,
Thanks for the nice post.
I just did the first steps, downloaded install file, and when I extracted it, I do not see the orion components in it. Is there anything that needs to be done for getting this Orion content?
thanks,
Sam
No, should be all there.. no additional steps needed.
Hi Team
Please find that I am getting "Catalog Service is unavailable. Please try again" error . I have activated all services. I have removed local system alias for catalog services.Please check. Thanks
Hi Madhukar,
sorry for the late reply. I'm sure it's a problem of the destination. Go to the responsible persons for network and ask if you have to do something additional in the "etc/hosts"
Hello Floria
I have WEBIDE local trial versión installed on my pc...i developed a ui5app that calls to odataservice in the backend system but i have gotten a 404 error. i created a file without extensión into the folder destination in eclipse/config_master/ service.destinations /destination on my pc, is it necesary the cloud conector ?
What information adicional do you need for help me? 🙂
Please your help
Thanks
Hi Luis,
it would be better you post this as a question. Maybe you can try to call your backend-service first and see if it is reachable.
NExt step would be to have a look at the debugger of the app.
More on this after you posted it as a question. As a comment it is not the right way and also not useful if anybody else got the same question.
~Florian
Excellent and useful
But those who use ABAP1909 Docker edition
sap_clent=001
You may like to add a small note just after screen shot that shows sap_client=100
I lost a lot of time but realized mistake 100 001 very close!
Excellent
ABAP1909 docker has
sap_client=001
I copied everything from screen shot
As 001 100very close
You may add a small note after screen shot
Working beautifully
Thx for the hint. Just put a line to it.
Happy to hear, that it still helps.
Hi Florian
In WebIde you have a special facility not available in BAS or VSCODE
New Project from Sample Application
Could build all 3 and interesting that it was all JS
First worked with "Mock Data"
With a new file RefAppsBackend replacing A4H contents
Description=RefAppsBackend
Type=HTTP
TrustAll=true
Authentication=BasicAuthentication
Name=RefAppsBackend
ProxyType=Internet
URL=http\://192.168.1.150\:50000
WebIDEUsage=odata_abap,odata_gen,ui5_execute_abap,dev_abap,bsp_execute_abap,odata_xs
WebIDESystem=A4H
WebIDEEnabled=true
sap-client=001
User=DEVELOPER
Password=xxxxxxxx
The 3 apps worked just fine with "real data"!
WebIde is no longer available as per
https://blogs.sap.com/2020/08/20/sap-web-ide-trial-update/
But disappointed that this is JS heavy lifting!
Not perhaps Fiori Elements which has different "internals"
Thought you may be interested
Jayanta@Kolkata
This is super helpful..thanks a lot Florian!
Hello Florian Henninger,
I have follwed all steps of for connecting WebIDE as mentioned https://help.sap.com/docs/SAP_Web_IDE/825270ffffe74d9f988a0f0066ad59f0/10291af7cc614f43b5b0a848a36af56f.html but still not able to connect http://localhost:8080/webide/index.html. I am getting message like site cant be reached. I dont have any onpremise SAP system installed just I want to design fiori app using local system. Please guide me.
With regards,
Bala
Hi Florian,
Thank you for sharing. After following all of your step, I got below error
"Java.lang.ExceptionInInitializerError" Caused by: java.lang.reflect.InaccessibleObjectException: Unable to make protected void java.net.UrlClassLoader.addUrl(java.net.Url) accessible: module java.base does not "opens java.net" to unnamed module.
I install java sdk 20.0.
Please advise should I downgrade the javasdk ?
Best Regards,
Afin
excuse me, it;s done. I should download jre 8 in here instead of jdk 20,0. So, it's solved.
Hi Florian and Zainal Arifin
Thank you for sharing. After following all of your step.
I have question that How can I use other instead of java sdk (Oracle) like SAP Java.
Please advise should I downgrade SAP Java or other one and How can I find guidance and setting it to run Orion and WebIDE?
Best Regards,
MaiThi
Hi,
I have configured the sap es5 destination then fetching oData GWSAMPLE_BASIC but it throws error after connecting first time by service url.
Data is coming ok from es5 destination from oData GWSAMPLE_BASIC.
500 Server error coming in service url connection in oData in projects now.
Kindly check the file below.
Thanks
Kaushik
I have maintained destination file as
ES5
#Password=<< Existing password/certificate removed on export >>
#
#Wed Sep 27 13:04:46 UTC 2023
Description=ES5 System
Type=HTTP
sap-platform=ABAP
HTML5.DynamicDestination=true
Authentication=BasicAuthentication
WebIDEUsage=odata_abap,dev_abap
Name=ES5
WebIDEEnabled=true
ProxyType=Internet
URL=https\://sapes5.sapdevcenter.com
sap-client=002
User=**********
Password=********
WebIDESystem=Gateway