WSO2 ESB - Source Repository [ Documentation Index ]

WSO2 Enterprise Service Bus (ESB) Source Repository

WSO2 ESB is developed on top of the revolutionary WSO2 Carbon platform. You might need the source of the Carbon platform as well apart from the ESB source code. Please note that both ESB and the Carbon platform is open source and the code is available under the Apache Software License v2.0.

Overview

This project uses Subversion to manage its source code. Instructions on Subversion use can be found at http://svnbook.red-bean.com/.

Source code of the ESB 4.0.0 release

The following is a link to the online source tag of the WSO2 ESB 4.0.0 release.

The complete source including the carbon platform can be checked out anonymously from SVN with this command:

$ svn checkout http://svn.wso2.org/repos/wso2/tags/esb/java/4.0.0 wso2esb

This code base contains the ESB product source code inside the directory "product" and it also contains the source for the platform under the directory "carbon-pltform". Further there will be a "build.sh" script to build the ESB with the platform.

This script accepts any of the maven related system properties, but the property to skip the tests has been shortned to "-ts", for example to build the ESB with the platform on skipping tests the command is;

$ ./build.sh -ts

To build off-line with this build script you can pass in the "-o" option. If you just need to build either the product or a specific part of the platform (for example Synapse) you just need to traverse to that directory and use maven to build any of the projects.

Source code of the WSO2 ESB trunk

Everyone can access the Subversion repository via HTTPS, but Committers must checkout the Subversion repository via HTTPS.

$ svn checkout https://svn.wso2.org/repos/wso2/trunk/esb/java wso2esb

The Carbon framework related source code can be checked out from the following commands.

$ svn checkout https://svn.wso2.org/repos/wso2/trunk/carbon carbon
$ svn checkout https://svn.wso2.org/repos/wso2/trunk/carbon-components carbon-components

The Carbon project is the root project of the OSGi platform on whcih all the Java product stack is built on top of, and the carbon-components contains all the components not just ESB specific components. So you obviously need to build just the set of components required by the ESB, which can be achieved through;

$ mvn clean install -Dproduct=esb

To commit changes to the repository, execute the following command (svn will prompt you for your password)

$ svn commit --username your-username -m "A message"

Access from behind a firewall

For those users who are stuck behind a corporate firewall which is blocking http access to the Subversion repository, you can try to access it via the developer connection:

$ svn checkout https://svn.wso2.org/repos/wso2/trunk/esb/java wso2esb

Access through a proxy

The Subversion client can go through a proxy, if you configure it to do so. First, edit your "servers" configuration file to indicate which proxy to use. The files location depends on your operating system. On Linux or Unix it is located in the directory "~/.subversion". On Windows it is in "%APPDATA%\Subversion". (Try "echo %APPDATA%", note this is a hidden directory.)

There are comments in the file explaining what to do. If you don't have that file, get the latest Subversion client and run any command; this will cause the configuration directory and template files to be created.

Example : Edit the 'servers' file and add something like :

[global]
http-proxy-host = your.proxy.name
http-proxy-port = 3128