Fork me on GitHub

Building

To build the Oracle Coherence Incubator you need to have the following software installed:

  1. Java SE Development Kit 6 or 7. (experimental support for Java 8 is also available).

    Available from: Oracle Java SE Downloads

  2. Apache Maven Version 3.0.4+ (not 3.0.3)

    Available here: Apache Maven Downloads

  3. The source code.

Additionally you should set your Maven Options as follows:

MAVEN_OPTS="-Djava.net.preferIPv4Stack=true
            -XX:MaxPermSize=512M
            -XX:+UseConcMarkSweepGC
            -XX:+CMSClassUnloadingEnabled
            -XX:+CMSClassUnloadingEnabled"
  1. In order to build the Coherence JVisualVM plug-in (available coherence-jvisualvm directory) you will need to add the following repository in your Maven settings.xml:

    jvisualvm jvisualvm http://bits.netbeans.org/nexus/content/groups/visualvm/

Once you have this software and have correctly configured the above Maven options, building the entire source tree is as simple as executing the following shell command (from the root of the source directory):

$ mvn clean install

Important: The fact that the Oracle Coherence Incubator depends on a commercial product, namely Oracle Coherence that of which is not available in a public Maven Repository, probably means that your first build is likely to fail because of a missing dependency on coherence.jar.

Should this problem occur and you aren't using the standard Coherence installer, you will need to manually install the appropriate coherence.jar and coherence-web.jars into your local repository or your organization's repository.

To install the standard coherence.jar into your local Apache Maven repository, simply change to $COHERENCE_HOME/lib directory and run the following command:

$ mvn install:install-file  \
      -DgroupId=com.oracle.coherence  \
      -DartifactId=coherence  \
      -Dversion=12.1.2-0-1  \
      -Dfile=coherence.jar  \
      -Dpackaging=jar \
      -DgeneratePom=true

To install the standard coherence-web.jar into your local Apache Maven repository, simply change to $COHERENCE_HOME/lib directory and run the following command:

$ mvn install:install-file  \
      -DgroupId=com.oracle.coherence  \
      -DartifactId=coherence-web  \
      -Dversion=12.1.2-0-1  \
      -Dfile=coherence-web.jar  \
      -Dpackaging=jar \
      -DgeneratePom=true

The groupId, artifactId and version properties are critically important. They must be as indicated above otherwise the Oracle Coherence Incubator won't build.

Of course the above assumes that you are installing the Coherence 12.1.2-0-1 jars If you want to install one of the more recent releases, change the version number in the command above accordingly.

Once theses are properly installed into your Apache Maven repository, you should be able to build the Oracle Coherence Incubator.