WSO2 Enterprise Integrator 3 min

WSO2Torial: Adding WSO2 DSS to the WSO2 ESB

Rob Blaauboer
Rob Blaauboer
Integration Consultant & WSO2 Trainer

WSO2torial_rgb600.pngWSO2 products are based on something that is called the WSO2 Carbon Core. This is a combination of standard functionality that all WSO2 products have in common. On top of Carbon features are installed to make it into a specific product like WSO2 Enterprise Service Bus (WSO2 ESB), WSO2 Identity Server (WSO IS) or WSO2 Data Services Server (WSO2 DSS).

All these features are available as one collection, called the P2 Repo. This is a massive file (1.1 GB) for Carbon 4.4 (the WSO2 carbon middleware platform) that can be used to add features to products and make it into a better (or more suited) version of a WSO2 product. If you want to know what Carbon version your product uses, you can check the Release Matrix by WSO2.

Of course not all product / features are candidates for this. Extremely resource hungry products like Data Analytics Server or critical components like Identity Server need their own environment.

WSO2 Carbon

Some products, like WSO2 DSS can actually be installed as a feature within another product. In this blog we will install DSS as a feature in the Enterprise Service Bus (WSO2 ESB). With WSO2 DSS you can connect to each WSO2 supported databases like MySQL, Percona, ClustrixDB, Oracle, MS SQL Server and so on by creating WSO2 data services.

Getting Started

To get started we take a brand new copy of the ESB and install it on our local machine. We use 4.9.0 for this article. The latter is important since the version of the Carbon Core needs to match the repo version (Wilkes, 4.4.X).

We simply start the ESB and move to the Feature Management found in the Configure tab.

WSO2 ESB feature engagement

At this time there are no repositories found, so we need to add one. In this case we choose to select the online repo (http://product-dist.wso2.com/p2/carbon/releases/wilkes/) that can be found on the Repo Page from WSO2.


We simply copy the url into the location field and click add. On the popup, click ok and the Repo will be added.


In the Available Features we search for Data and find the Data Services Hosting feature. Since this is the one we need to add we can select it and click install.


It indicates the detail features. Do not worry about the versioning in this case. If something is wrong the features will not install.


WSO2_ESB_Home.png We need to agree to the terms of the license agreement and after that the feature will be installed. Last step is to reboot the server (the ESB) and start it again to see the new features.

What you will immediately see it that the services not only show Proxy Services, but also Data Services.

The DSS is a relatively light product and many of its other options are also available in the ESB (like adding a Datasource, adding Carbon Apps) and so on.

Adding other features works in a similar way, so you can try it yourself. Keep in mind that it might not work or even might not be a good idea to combine features. But the only way is to try it out (and Google if it doesn’t work).

As a final note: WSO2 does not recommend the combination of features for production environments because of the untested nature of the combination. For development and testing purposes they can be used.

Read also our other WSO2 tutorials and blogs about WSO2 Identity Server or WSO2 API Manager, written by our WSO2 Gurus. In case you need WSO2 support, contact the Yenlo WSO2 Guru team to get WSO2 Development Support or WSO2 Operational Support. Of course we do deliver excellent WSO2 training services as well, based on reallife WSO2 tutorials.

With thanks to Thijs Volders for his comments and review on this blog.

WSO2TORIALS help you to change, update or improve WSO2 products and are based on our experiences with the products. WSO2TORIALS will guide you step by step with minimal knowledge required.   WSO2TORIAL.jpeg


Full API lifecycle Management Selection Guide

whitepaper hero
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