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.
Why?
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.
At the bottom of the page we find the download for the ESB versions:
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.
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.
Tooling
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.
Eclipse
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.
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.
Click on the link for your OS and you will get a screen like this:
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.
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.
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.
We now have Eclipse installed but still no Developer Studio. Let’s install that now. Select Help and Install New Software.
Select the P2 Repo we downloaded and click OK.
Select WSO2 ESB Tools and click next.
Optionally look at what’s being installed.
Accept the license and Press Next to install. If you get a Security Warning, click OK. Trust the certificates and Press OK.
Restart Eclipse for the changes to take effect.
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.
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 Tutorials, webinars 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.
