Title: Airavata Build Instructions
Notice:    Licensed to the Apache Software Foundation (ASF) under one
           or more contributor license agreements.  See the NOTICE file
           distributed with this work for additional information
           regarding copyright ownership.  The ASF licenses this file
           to you under the Apache License, Version 2.0 (the
           "License"); you may not use this file except in compliance
           with the License.  You may obtain a copy of the License at
           .
             http://www.apache.org/licenses/LICENSE-2.0
           .
           Unless required by applicable law or agreed to in writing,
           software distributed under the License is distributed on an
           "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
           KIND, either express or implied.  See the License for the
           specific language governing permissions and limitations
           under the License.

### Prerequisites

* Sources compilation require Java SE 8 or higher.
* The project is built with Apache Maven 3+ [Download][1] and [install][2] (Maven 2.x build will
  start but fail with errors)
* set or export JAVA_HOME to point to JDK
    * For example in Ubuntu: export JAVA_HOME=/usr/lib/jvm/java-6-openjdk
* Get Airavata source [checked out](source.html) from Airavata trunk.

## Command line

### Build the distribution

* cd airavata-trunk
* mvn clean install
* To build without running tests
    * mvn clean install -Dmaven.test.skip=true
* The compressed binary distribution is created at <PROJECT DIR>/modules/distribution/target

### Now What?

Once you have built the binaries the best thing to do is take a look at our [Airavata in 
Five Minutes][3] document which will help you get up and running.

### Build profiles

One of the salient features of Airavata Airavata is ability to use modules by themselves or as an 
integrated solution. The following modules can be build independently.

* XBaya Workflow GUI:
    * mvn clean install -Dmodule=xbaya-gui
* GFac Application Management POJO version:
    * mvn clean install -Dmodule=gfac-core
* GFac Axis2 Service:
    * mvn clean install -Dmodule=gfac-axis2
* WS-Messenger web service messaging system:
    * mvn clean install -Dmodule=ws-messenger
* Sample Axis2 Web Services:
    * mvn clean install -Dmodule=simple-math-service

##  Eclipse preparation
* Download [Eclipse IDE for Java EE Developers](http://www.eclipse.org/downloads/)
* Follow the instructions on Eclipse [Add New Software](http://help.eclipse.org/indigo/index.jsp?topic=/org.eclipse.platform.doc.user/tasks/tasks-127.htm) to add the following pluggins
* Add [M2Eclipse](http://download.eclipse.org/technology/m2e/releases) pluggin.
* Add [Subclipse](http://subclipse.tigris.org/update_1.6.x/) pluggin

##  Eclipse workspace configuration

* Build first using command line (see above)
* Regenerate .project/.classpath files
* maven eclipse:eclipse
* Open eclipse and import projects from airavata-trunk:
    * Import > Existing Maven Projects and point to trunk checkout directory.
    * You can import all or selective projects


  [1]: http://maven.apache.org/download.html
  [2]: http://maven.apache.org/download.html#Installation
  [3]: /documentation/tutorials/airavata-in-5-minutes.html