WSO2 Tungsten Source Distribution

This page of the installation guide will explain how to build WSO2 Tungsten using the source distribution provided with this release.

Introduction

Tungsten comes as a standalone server and as embeddable server or in other words as part of a J2EE servlet container. In other pages of the installation guide we have given instructions on the installation of the standalone version and Web application archive (WAR) installation for the embeddable version.

For the more adventurous users this release provides Tungsten source distribution so that can build the WSO2 Tungsten server suing this.

Download WSO2 Tungsten Source Distribution: tungsten-java-src-1.0.zip

System Requirements

Setting Up the Environment and Tools

Maven:

The WSO2 Tungsten build is based on Maven. Hence the only prerequisite to build Tungsten from source distribution is to have Maven 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.

• MS Windows

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.

• Unix based OS (Linux etc)

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 Tungsten.

Building Tungsten from the Source Distribution

The source distribution is available as a zipped archive. All the necessary build scripts are included with the source distribution. Once the source archive is expanded into a directory of choice, move to the expanded directory.

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, fisrt run will take more time.