WSO2 Enterprise Integrator 4 min

WSO2 ESB 5.0.0: Downloading and Installing the tooling

Rob Blaauboer
Rob Blaauboer
Integration Consultant & WSO2 Trainer
WSO2 ESB Enchanced and Extended

install eclipse on windows desktop

The advent of the WSO2 Enterprise Integrator has moved the older versions of the Enterprise Server Bus a bit to the background. You can still download the product but you need to look and work a bit harder when you want to create a complete Enterprise Server Bus setup (ESB, Analytics and Tooling).

In this blog we will show you how to find and setup the WSO2 ESB 5.0.0.


WSO2 only shows the current versions of its product. The page for the Enterprise Server Bus now prominently shows the new WSO2 Enterprise Integrator product.

WSO2 ESB Enchanced and Extended.png

At the bottom of the page we find the download for the ESB versions:

Download WSO2 ESB versions.png

For older versions you are redirected to a repository. That is not necessarily a bad thing since we can go back to previous version if you so like. So where do we find  these versions? If you would click the link above you would be redirected to http://wso2.com/more-downloads/esb where you find the versions.

WSO2 ESB older versions.png

As you can see, previous versions can be found here all the way back to version 1.7.1 (not visible). The analytics and tooling is only available for ESB  5.0.0 since it was introduced for that version, previous versions of the ESB were separated from tooling and analytics. You simply downloaded Developer Studio and Data Analytics Server (previously Business Activity Monitor) and installed the products.


So it is simple, right? Download ESB, Analytics and Tooling and you are done! Yes and no. The current tooling version is not the complete combination of Eclipse and the P2 repository (aka Developer Studio) but rather just the P2 repository. You need to separately download Eclipse for your OS and subsequently install the P2 repository in order to have the ESB tooling that supports debugging and helps you graphically define your proxies and APIs.


It takes a bit of searching to find  Eclipse. Clicking on Tooling just downloads the wso2esb-tooling-composite-p2-5.0.0.zip file. In the documentation we find a link to install WSO2 ESB Tooling. In there there is a link for the complete Tooling set, however that takes you to the link of the P2 repository we just downloaded.

Luckily there is another link that is more appropriate: Install WSO2 tooling on Eclipse Mars using the P2.zip file.

There you find a link to the Eclipse IDE for Java EE Developers. As you see from the Releases, there are many versions. Mars is the version we need to select.

Eclipse IDE for Java EE Developers.png

If you were to click the Mars Package you will see the following links. By the way, you do not need to click the packages, below the text you see in the image below you will find direct links to the Windows, Mac Cocoa and Linux Version.

Eclipse Mars 2 Packages.png

Click on the link for your OS and you will get a screen like this:

eclipse download.png

Click on download (choose another mirror if you want that is closer to your location) and the Eclipse environment is downloaded.

You will now have two files.

eclipse jee mars 2 win - wso2 esb tooling composite p2 5.0.0.png

Installing Eclipse and P2 Repo

For this WSO2TORIAL we will install Eclipse on Windows on the desktop. We drag the elipse zip file to the desktop and unzip the file. You will end up with a directory that holds the Eclipse application. To start we click on the Eclipse Application. Note that Eclipse needs Java to be installed. Please look at this blogpost for the installation of Java.

install eclipse on windows desktop-1.png

We select the default Workspace Eclipse suggests by clicking OK. If you are using a 4K screen, Eclipse might disregard the magnification factor and start up in native 4K mode. The solution in that case is to set the resolution lower and sign out of your OS if Eclipse does not resize.

Workspace Launcer.png

We now have Eclipse installed but still no Developer Studio. Let’s install that now. Select Help and Install New Software.

Install new eclipse software.png

Available software - installing eclipse on windows machine.png

Select the P2 Repo we downloaded and click OK.

Select the P2 Repo.png

Select WSO2 ESB Tools and click next.

Select WSO2 ESB.png

Optionally look at what’s being installed.

Install Details.png

Accept the license and Press Next to install. If you get a Security Warning, click OK. Trust the certificates and Press OK.

Trust the certificates and press OK.png

Restart Eclipse for the changes to take effect.

Restart Eclipse.png

When Elipse is started, your will see that there is a Menu Option called Developer Studio. Click on that and Select Open Dashboard. You will see the ESB Tooling in Developer Studio.

WSO2 Developer Studio.png

You should now have successfully installed ESB Tooling and you are ready to start developing ESB artifacts for WSO2 ESB 5.0.0

If you have any questions about this blogpost contact us via the comments section of this blog. View also our WSO2 Tutorialswebinars or white papers for more technical information. Need support? We do deliver WSO2 Support (WSO2 Product Support, WSO2 Development Support, WSO2 Operational Support) and WSO2 Training Programs. 

ESB Selection Guide

esb frontback
Get it now
We appreciate it
Care to share

Please select one of the social media platforms below to share this pages content with the world