Independent extensions:

RSS Feeds


Pages and Blog posts
Mailing list

Prequisites

  • Check out or download as a ZIP file the Codehaus Cargo source code from Github into a CARGOHOME directory (wherever you want on your machine).
  • Install Maven 3.2.3 or later. Verify your installation works by running the following command in a command prompt / terminal window: mvn --version

Building

To build Codehaus Cargo:

  • Go to CARGOHOME and run mvn install
    This will build the full Cargo project.
  • If you wish to clean all build-generated files, cd to CARGOHOME and run mvn clean


First time build

The Codehaus Cargo build contains functional tests. Those tests are run on different containers. The first time you build Codehaus Cargo it will download those container distributions which will take some time (the containers are installed into core/samples/java/installs). If you want to tell Codehaus Cargo to run only on some specific container, see below.

Selecting containers

The default list of containers to run on depends a property cargo.containers defined in CARGOHOME/core/samples/pom.xml. It can also be supplied at the command line by using profiles (-P<containerId>).

For example if you only want to run on Tomcat 8.x you'd run: mvn -Ptomcat8x clean install

Proxy settings

If you need to build Codehaus Cargo from behind a proxy, proceed as follows:

  • Edit the .m2/settings.xml file from your home directory (C:\Documents and Settings\username or C:\Users\username on Windows),
  • Comment out the <proxy> element and fill in the proxy server settings accordingly.

ArtifactTransferException with Maven 3.8.1 onwards

With Maven 3.8.1 onwards you might get errors such as: org.eclipse.aether.transfer.ArtifactTransferException: Could not transfer artifact org.ow2.jonas.tools.configurator:api:pom:1.9.4-SNAPSHOT from/to maven-default-http-blocker (http://0.0.0.0/): Blocked mirror for repositories: [ow2-snapshot (http://repository.ow2.org/nexus/content/repositories/snapshots, default, snapshots)]

To work around the issue, create a settings.xml file in your .m2 home which overrides the HTTP-based OW2 SNAPSHOTS repository:

settings.xml sample
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                      http://maven.apache.org/xsd/settings-1.0.0.xsd">
  <mirrors>
    <mirror>
      <id>ow2-snapshot-override</id>
      <name>ow2-snapshot-override</name>
      <url>https://repo.maven.apache.org/maven2</url>
      <mirrorOf>ow2-snapshot</mirrorOf>
    </mirror>
  </mirrors>
</settings>
Copyright 2004-2021. All rights reserved unless otherwise noted.
Click here to read our privacy and cookie policy