Nuxeo Server

Nuxeo Distributions

Updated: December 5, 2017 Page Information Edit on GitHub

This page is scheduled for review and update. Check back soon for updated content!

The nuxeo-distribution Module Purpose

The nuxeo-distribution module is used for the packaging and the high-level testing of the Nuxeo Platform: Nuxeo CAP Tomcat, Shell, Core Server, Startup Wizard, Functional and Performance Tests... The key concepts are: CAP, SDK, assembly, ant-assembly-maven-plugin, NXR, WAR, Nuxeo Package, tools-nuxeo-ftest, Selenium, WebDriver, FunkLoad, Gatling.

With nuxeo-distribution, you can build from Nuxeo sources, run tests against existing distributions and much more: if you need to assemble your own distribution, you will find in nuxeo-distribution some resources, templates and samples on which to base your packaging.

You don't need to use the nuxeo-distribution module if:

You have to use nuxeo-distribution module if:

  • You want to reproduce the Nuxeo build process,
  • You work on Nuxeo source code and need a quick feedback on your changes,
  • You want to run the Nuxeo main functional or performance test suites against a given distribution.

Read the Nuxeo Core Developer Guide for more information on how to package from sources using or miming nuxeo-distribution.

The nuxeo-distribution Module Usage and Outputs

The module is used for building and testing. It is executed at the very end of the whole Platform source code build, including the addons, but before the Nuxeo Packages build and tests.

There are four kinds of products built by the nuxeo-distribution module:

  • Standalone products to embed in a final package like the Launcher (aka NuxeoCtl), the Startup Wizard.
  • Static resources like configuration templates.
  • The CAP NXR for use in package assemblies.
  • The Nuxeo CAP Tomcat distribution.

Sample usage:

  • Build all Nuxeo products without running Integration Tests:

    mvn clean package
    mvn clean verify -DskipTests -DskipITs
  • Build all Nuxeo products running Integration Tests:

    mvn clean verify
  • Build only the Tomcat distributions

    mvn clean package -pl :nuxeo-distribution-tomcat

See the nuxeo-distribution/ file for a detailed description of the nuxeo-distribution module usage and outputs.


7 days ago Manon Lumeau add tags for doc days
13 days ago Manon Lumeau Fix tags for doc days
a month ago manonlumeau Added content-review-lts2017 label
2 months ago manonlumeau NXDOC-1346-FT review screenshot
2 years ago Solen Guitter 17
2 years ago Manon Lumeau 16
2 years ago Julien Carsique 15
4 years ago Solen Guitter 14
4 years ago Alain Escaffre 13
4 years ago Alain Escaffre 12
4 years ago Alain Escaffre 10
4 years ago Alain Escaffre 11
6 years ago Julien Carsique 8
6 years ago Julien Carsique 9 | Migrated to Confluence 4.0
7 years ago Stéfane Fermigier 7
7 years ago Julien Carsique 6 | formatting and typos
8 years ago Solen Guitter 5 | formatting and typos
8 years ago Julien Carsique 4
8 years ago Julien Carsique 3
8 years ago Admin name placeholder 2
8 years ago Admin name placeholder 1
History: Created by Admin name placeholder