Building and running EasySOA V1

The easy way

Through scripts - the quick way (requires Java 7, Maven 3, Ruby as said in prerequisites)

git clone https://github.com/easysoa/EasySOA-Incubation.git
cd EasySOA-Incubation/easysoa-registry-v1
mvn clean install -Pmarketplace -DskipTests
./nuxeo.rb deploy
YOUR_EASYSOA_INSTALL_PATH=../..
cp -rf easysoa-registry-marketplace/target/nuxeo-cap-* $YOUR_EASYSOA_INSTALL_PATH/

Through scripts - in details

• Clone the sources (git clone git://github.com/easysoa/EasySOA-Incubation.git)
• [Configure your access to the Nuxeo Studio repository](Configuring the Nuxeo Studio repository settings)
• Make sure Ruby (and Java 7, Maven 3 as said in prerequisites) is installed
• From a command-line console (Linux/Cygwin), browse to ./easysoa-registry-v1 and run:

./nuxeo.rb fastbuild deploy run

• which builds but also starts Nuxeo (BEWARE, next build will clean up your data, to change that either move it from ./easysoa-registry-v1/target/nuxeo-cap-* to your install directory, or see below). If everything worked the login screen should be customized to the EasySOA branding.

More

Type ./nuxeo.rb without arguments to get the available commands and see how to deploy to a persistent Nuxeo (rather than the default one, that is cleaned up at each build) :

> AVAILABLE GOALS
build     : Build with Maven.
fastbuild : Build with Maven, skip the tests to go faster
fastestbuild : Build with Maven, skip the tests and run offline to go faster (consequence: won't update any SNAPSHOT from remote repos, like NxStudio plugins)
test      : Run the Maven tests only, in debug mode
deploy    : Unzip the Nuxeo distribution if necessary, deploy the marketplace package
reset     : Delete the unzipped Nuxeo distribution, or reset the data of your custom Nuxeo (works only with Derby/H2 configs)
run       : Runs Nuxeo

> WARNING
With the default configuration, the whole Nuxeo distribution is deleted during each build.
Deploy Nuxeo outside of the repository if you want to keep your data/config
(its path can be set by creating a "nuxeo-config.rb" from the "nuxeo-config.default.rb" example)
Tip: you can grab a Nuxeo DM ZIP in ./easysoa-registry-marketplace/target/ after a build.

> EXAMPLES
./nuxeo.rb test
./nuxeo.rb fastbuild deploy run
./nuxeo.rb reset deploy run

The manual way

You can alternatively use Maven and Nuxeo Marketplace command lines (mvn and nuxeo-ctl mp-xxx commands) to do it. That's actually how the nuxeo.rb script works.

Here's how :

Building

• Download and install the latest Nuxeo DM 5.7 snapshot (Tomcat)
• Clone the sources (git clone git://github.com/easysoa/EasySOA-Incubation.git)
• [Configure your access to the Nuxeo Studio repository](Configuring the Nuxeo Studio repository settings)
• From the repository root, run mvn clean install -Pmarketplace
• The libaries/bundles are packaged in ./easysoa-registry-v1/easysoa-registry-marketplace/target.

Deploying

• Unzip the nuxeo-distribution-tomcat-VERSION-nuxeo-cap.zip Nuxeo distribution
• From a console, go to the the bin/ directory of the unzipped Nuxeo
• Run:

./nuxeoctl mp-init
./nuxeoctl mp-install ../../easysoa-registry-marketplace-VERSION.zip

(You might have to adjust the EasySOA package, especially if you decide to keep your distribution somewhere out of the highly temporary easysoa-registry-marketplace/target/)

• Run Nuxeo, if everything worked the login screen should be customized to the EasySOA branding.