Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

WSO2 invites you to contribute by checking out the source from the Subversion (SVN) source control system, building the product and making changes, and then committing your changes back to the source repository. (For more information on Subversion, see http://svnbook.red-bean.com.) The following sections describe this process:

...

Orbit:

$ svn checkout https://svn.wso2.org/repos/wso2/carbon/orbit/tags/x.x.x <local-orbit-directory>

Kernel:

$ svn checkout https://svn.wso2.org/repos/wso2/carbon/kernel/tags/x.x.x <local-kernel-directory>

Platform:

$ svn checkout https://svn.wso2.org/repos/wso2/carbon/platform/tags/turing <local-platform-directory>

Checking out patches

Note

If you are building any of the Kernel patches, you need to first check out the relevant patches from this location: https://svn.wso2.org/repos/wso2/carbon/kernel/branches/4.2.0/patches/.
Note that if you are going to use any of the patches given below, a few additional changes are required in the POM files. Expand the following links for details:

Expand
titlepatch0003

To manually update the POM files:

  1. Open the POM file of patch0003 from here: https://svn.wso2.org/repos/wso2/carbon/kernel/branches/4.2.0/patches/patch0003/orbit/jdbc-pool/7.0.34.wso2v1/pom.xml
  2. Add <version>1.4.0</version> to the following section:

    Code Block
    <plugin>
    <groupId>org.apache.felix</groupId>
    <artifactId>maven-bundle-plugin</artifactId>
    <version>1.4.0</version> 
    <extensions>true</extensions>
Expand
titlepatch0009

To manually update the POM files:

  1. Open the POM file of patch0009 from here: https://svn.wso2.org/repos/wso2/carbon/kernel/branches/4.2.0/patches/patch0009/orbit/hazelcast/3.0.1.wso2v1/pom.xml
  2. Add <version>1.4.0</version> to the following section:

    Code Block
    <plugin>
    <groupId>org.apache.felix</groupId>
    <artifactId>maven-bundle-plugin</artifactId>
    <version>1.4.0</version> 
    <extensions>true</extensions>
Expand
titlepatch0010

To manually update the POM files:

  1. Open the following POM files for patch0010.
  2. Add <version>1.4.0</version> to the following section in all of the above POM files:

    Code Block
    <plugin>
    <groupId>org.apache.felix</groupId>
    <artifactId>maven-bundle-plugin</artifactId>
    <version>1.4.0</version> 
    <extensions>true</extensions>
  3. In the https://svn.wso2.org/repos/wso2/carbon/kernel/branches/4.2.0/patches/orbit/tomcat/pom.xml file, remove the following:

    Code Block
    <Bundle-Classpath>patch.jar.,</Bundle-Classpath>
Expand
titlepatch0012

To manually update the POM files:

  1. Open the POM file of patch0012 from here: https://svn.wso2.org/repos/wso2/carbon/kernel/branches/4.2.0/patches/patch0003/orbit/jdbc-pool/7.0.34.wso2v1/pom.xml
  2. Add <version>1.4.0</version> to the following section:

    Code Block
    plugin>
    <groupId>org.apache.felix</groupId>
    <artifactId>maven-bundle-plugin</artifactId>
    <version>1.4.0</version> 
    <extensions>true</extensions>

Building the product 

Anchor
build
build

Before you build:

  1. Make sure the build server has an active Internet connection to download dependencies while building.
  2. Install Maven and JDK. See Installation Prerequisites for compatible versions.
  3. Set the environment variable  MAVEN_OPTS="-Xms1024m -Xmx4096m -XX:MaxPermSize=1024m" to avoid the Maven OutOfMemoryError.

To create complete release artifacts of the products released with this chunk version, including the binary and source distributions, go to <local-platform-directory>/repos/wso2/carbon/platform/tags/turing-chunkXX/product-releases/chunk-XX and run the following Apache Maven commands. To build only a selected product/s, open the <local-platform-directory>/repos/wso2/carbon/platform/tags/turing-chunkXX/product-releases/chunk-XX/products/pom.xml file, comment out the products you do not want to build and run the relevant Maven command.

For example, if you want to build chunk-02 use the following path:

...