[Download] | [Documentation Home] | [Release Note]
This page explains how to build the WSO2 AppServer using the source distribution of the release. First download the AppServer source distribution from here.
Java Runtime Environment | 1.6.x (For instructions on setting up the JRE in different operating systems, visit http://java.sun.com) |
Maven | 2.2.0 or higher (download). |
Operating System | Tested on Windows XP, Windows Vista, Linux (Fedora core, Ubuntu and Gentoo), Mac OS X & Sun Solaris |
The WSO2 AppServer build is based on Maven. Hence, a prerequisite to build WSO2 AppServer from the source distribution is to have Maven and JDK installed. Extensive instructions are available on the Maven site.
You may need to set the MAVEN_OPTS if you come across OutOfMemory errors during the build. e.g. you may need to set MAVEN_OPTS=-Xmx1024m -XX:MaxPermSize=128m
This guide however contains the easiest path for quick environment setting. Advanced users can learn more about Maven.
Once Maven is properly installed, you can start building the WSO2 AppServer for Java.
The source distribution
is available as a zipped archive. All the necessary build
scripts are included with the source distribution. Expand the source archive
to a directory of your choice. You can run the following commands inside that
directory to build the WSO2 AppServer.
Note: The first time you run Maven, it will automatically
download the dependent .jars. Therefore, the first run will take more
time. The third party libraries required by WSO2 AppServer will be downloaded from the
Maven2 repositories specified in the main pom.xml file.
The list of commands that can be run are as follows. Please note that the released source
distribution contains sources for all the WSO2 Carbon based products. Therefore if you only
want to build the WSO2 AppServer, you have to always use the option "-Dproduct=wsas".
mvn clean install -Dproduct=wsas | To create the complete release artifacts of WSO2 AppServer including the binary and source distributions. |
mvn clean install -Dmaven.test.skip=true -Dproduct=wsas | To create the complete release artifacts of WSO2 AppServer including the binary and source distributions, without running any of the unit tests. |
mvn clean install -Dmaven.test.skip=true -Dproduct=wsas -o | To create the complete release artifacts of WSO2 AppServer including the binary and source distributions, without running any of the unit tests, in offline mode. This can be done only if you've already built the source at least once. |
All the sources of the major 3rd party components included in WSO2 AppServer can be found in the source distribution. For the purpose of debugging applications, you could attach these sources.