WSO2 Web Services Application Server for Java, 1.1 - Source Distribution

This page of the installation guide will explain how to build WSO2 WSAS for Java using the source distribution of the release.

Introduction

WSO2 WSAS for Java is available as a Standalone Edition and a Servlet Edition. In other pages of the Installation Guide we have given instructions on the installation of these 2 editions.

For the more adventurous users this release provides a source distribution so that they can build the WSO2 WSAS from source.

Download WSO2 WSAS Source Distribution: wso2wsas-java-src-1.1.zip

System Requirements

Java Runtime Environment 1.4 or 1.5 (For instructions on setting up the JRE in different operating systems, visit http://java.sun.com)
Maven 1.0.2 or higher in Maven 1.x series (download). Please download maven 1.x version.
Operating System Tested on Windows XP, Linux(Fedora core, Ubuntu and Gentoo), Mac OS X,

Setting Up the Environment and Tools

Maven:

The WSO2 WSAS build is based on Maven. Hence the prerequisites to build WSO2 WSAS from source distribution is to have Maven & JDK installed. Extensive instruction guides are available at the Maven site.

This guide however contains the easiest path for quick environment setting. Advanced users who wish to know more about Maven can visit here.

  1. Download and run the Windows installer package
  2. Set the 'Environment Variables' ( create system variable MAVEN_HOME and edit path. eg: "C:\Program Files\Apache Software Foundation\maven-1.0.2"; path %MAVEN_HOME%\bin)
  3. Make sure that system variable JAVA_HOME is set to the location of your JDK, eg. C:\Program Files\Java\jdk1.5.0_02
  4. Run maven --version to verify that it is correctly installed.

The tar ball or the zip archive is the best option. Once the archive is downloaded expand it to a directory of choice and set the environment variable MAVEN_HOME and add MAVEN_HOME/bin to the path as well. More instructions for installing Maven in Unix based operating systems can be found here.

Once Maven is properly installed you can start building WSO2 WSAS for Java.

Building WSO2 WSAS for Java from the Source Distribution

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 WSO2 WSAS.

List of commands that can be run are as follows:

Note: The first time you run Maven it will automatically download the dependent jars. Therefore, first run will take more time.

Maven release To create the complete release artifacts including Standalone Edition, Servlet Edition, and source distributions.
Maven dist To create Standalone Edition and Servlet Edition distributions.
Maven jar Compiling and building the jars