Skip to content

JeffersonLab/clara-java

Repository files navigation

CLARA

A micro-services framework to provide a heterogeneous computing environment for efficient Big Data processing.

Build Status Javadoc

Documentation

The reference documentation is available at https://claraweb.jlab.org.

Build notes

CLARA requires the Java 8 JDK.

Ubuntu

Support PPAs:

$ sudo apt-get install software-properties-common

Install Oracle Java 8 from the Web Upd8 PPA:

$ sudo add-apt-repository ppa:webupd8team/java
$ sudo apt-get update
$ sudo apt-get install oracle-java8-installer

Check the version:

$ java -version
java version "1.8.0_101"
Java(TM) SE Runtime Environment (build 1.8.0_101-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.101-b13, mixed mode)

You may need the following package to set Java 8 as default (see the previous link for more details):

$ sudo apt-get install oracle-java8-set-default

You can also set the default Java version with update-alternatives:

$ sudo update-alternatives --config java

macOS

Install Oracle Java using Homebrew:

$ brew cask install caskroom/versions/java8

Check the version:

$ java -version
java version "1.8.0_92"
Java(TM) SE Runtime Environment (build 1.8.0_92-b14)
Java HotSpot(TM) 64-Bit Server VM (build 25.92-b14, mixed mode)

Installation

To build CLARA use the provided Gradle wrapper. It will download the required Gradle version and all the CLARA dependencies.

$ ./gradlew

To install the CLARA artifact to the local Maven repository:

$ ./gradlew install

To deploy the binary distribution to $CLARA_HOME:

$ ./gradlew deploy
   Note. If you do not have access permission to the local directory
   to save artifacts, your build will faile with the
   "java.io.IOException: Operation not supported" exception.
   Use
      --project-cache-dir /tmp
   to save artifacts in /tmp

Importing the project into your IDE

Gradle can generate the required configuration files to import the CLARA project into Eclipse and IntelliJ IDEA:

$ ./gradlew cleanEclipse eclipse

$ ./gradlew cleanIdea idea

See also the Eclipse Buildship plugin and the Intellij IDEA Gradle Help.

Authors

  • Vardan Gyurjyan
  • Sebastián Mancilla
  • Ricardo Oyarzún

For assistance send email to [email protected].