Releasing EasySOA

Release process

1. Github repository

• Make sure all issues are either closed or postponed to another milestone
• Make sure the wiki is up-to-date
• Use git tag easysoa-[demo-]XXX to tag the last release commit, and push it with git push origin --tags

2. Archive deployment

• Package EasySOA with buildr buildall packageall tgz
• Upload the archive to EasySOA.org
• Update the "Download" page, then make a release post ("Release" category)

3. Post-release changes

• Use the updateVersion.sh script from easysoa-distribution/ to update all of the POMs to the next version number
• Update manually the .sh and .bat scripts, and the default "build.yaml" file

Prerequisites

Instructions to setup these applications (including Git) are detailed on this page. In short, you will need:

• Sun's 1.6 Java JDK
• Maven 2
• Buildr
• Nuxeo DM 5.4.2 (with Derby as a database, which is set by default)
• node.js

Please note that for now, it only works on Linux. It might work on Windows with Cygwin, but it has not been tested at the moment.

Building the distribution / releasing EasySOA

Build and run

After having clone the EasySOA repository, copy the easysoa-distribution/build.yaml configuration file to ~/.buildr/settings.yaml and edit it at will (make sure the Nuxeo and node paths are valid), then run the following command from the easysoa-distribution folder:

buildr buildall packageall

To launch EasySOA, type these commands:

cd easysoa
./run.sh

Build and package release

The set up is the same as above, but instead run the following command, from the easysoa-distribution folder:

buildr buildall packageall tgz

Task list

Global tasks

• buildr buildall builds all needed projects
• buildr packageall creates an EasySOA folder including all components
• buildr tgz creates a zip from the EasySOA package

Specific tasks

This help is available from the command line, by typing buildr help.

buildall                       # Builds all needed projects
nx_clean                       # Cleans all registry components
nx_dist                        # Deploys registry components
nx_mvn                         # Builds registry components using Maven
package                        # Create packages
packageall                     # Creates the EasySOA package
paf                            # Builds PAF CXF server
proxy                          # Builds the Esper & Light proxies
release                        # Make a release
test                           # Run all tests
test:failed                    # Run failed tests
tgz                            # Creates the EasySOA package
travel                         # Builds the Smart Travel demo and its backup services