ersap-vtp

JLAB VTP and SAMPA stream handler package. This package contains following projects:

LMAX Disruptor based stream aggregation in JAVA
LMAX Disruptor based stream aggregation in C++
ERSAP stream source engine for VTP SRO
ERSAP stream source engine for SAMPA SRO

Java Binding

Build notes

The project requires JDK 14 or higher.

Ubuntu

$ sudo add-apt-repository ppa:webupd15team/java
$ sudo apt-get update
$ sudo apt-get install oracle-java15-installer

Check the version:

$ java -version
$ java 15.0.1 2020-10-20
$ Java(TM) SE Runtime Environment (build 15.0.1+9-18)
$ Java HotSpot(TM) 64-Bit Server VM (build 15.0.1+9-18, mixed mode, sharing)
You may need the following package to set Java 15 as default
$ 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

Installation

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

$ ./gradlew clean
$ ./gradlew 

To deploy the binary distribution to $ERSAP_HOME:

$ ./gradlew deploy

C++ Binding for the LMAX Disruptor

Building notes

If on the Jefferson Lab CUE system using Redhat 7:

For C++ code you’ll need a compiler that is more advanced than the provided 4.8.5. This is necessary in order to compile and use the Disruptor library. Do this by calling “use”. In this case switch to version 7.2.0. Other versions are available:

use gcc/7.20

This C++ code requires Boost libraries. The cmake file will look for these libs.

This C++ code requires the Disruptor library. So the first thing you need to do get and compile it:

$ git clone https://github.com/JeffersonLab/Disruptor-cpp.git
$ cd Disruptor-cpp
$ mkdir build
$ cd build
$ cmake .. -DCMAKE_BUILD_TYPE=Release  -DCMAKE_C_COMPILER=/apps/gcc/7.2.0/bin/gcc  -DCMAKE_CXX_COMPILER=/apps/gcc/7.2.0/bin/g++
$ make
$ setenv DISRUPTOR_CPP_HOME <../>

If this is being compiled on a Mac the specification of the compiler can be removed:

$ cmake .. -DCMAKE_BUILD_TYPE=Release

Now getting back to compiling ersap-vtp.

For C++ compilation be sure the DISRUPTOR_CPP_HOME env var is set.

The do the following on Redhat 7:

$ use gcc/7.2.0
$ git clone https://github.com/JeffersonLab/ersap-vtp.git
$ cd ersap-vtp
$ mkdir -p build/release
$ cd build/release
$ cmake ../.. -DCMAKE_BUILD_TYPE=release -CCMAKE_CXX_COMPILER=/apps/gcc/7.2.0/bin/g++
$ make

If you want to install lib and executables into a specific directory, replace the last 2 calls with the following:

$ cmake ../.. -DCMAKE_BUILD_TYPE=release -CCMAKE_CXX_COMPILER=/apps/gcc/7.2.0/bin/g++ -DINSTALL_DIR=<dir>
$ make install

#### MacOS:

$ git clone https://github.com/JeffersonLab/ersap-vtp.git
$ cd ersap-vtp
$ mkdir -p build/release
$ cd build/release
$ cmake ../.. -DCMAKE_BUILD_TYPE=release -DINSTALL_DIR=<dir>
$ make

For a debug version, replace the word “release” with the word “debug”

$ mkdir -p build/debug
$ cd build/debug
$ cmake ../.. -DCMAKE_BUILD_TYPE=debug -CCMAKE_CXX_COMPILER=/apps/gcc/7.2.0/bin/g++

### On indra-s1 This node needs extra instruction since it was setup in a weird way with 2 versions of boost When building the disruptor:

$ bash
$ source /op[t/rh/devtoolseb-7/enable
$ git clone https://github.com/JeffersonLab/Disruptor-cpp.git
$ cd Disruptor-cpp
$ mkdir build
$ cd build
$ cmake .. -DCMAKE_BUILD_TYPE=release -DBOOST_LIBRARYDIR=/usr/lib64/boost169 -DBOOST_INCLUDEDIR=/usr/include/boost169
$ make
$ setenv DISRUPTOR_CPP_HOME <../>

Building ersap-vtp

$ git clone https://github.com/JeffersonLab/ersap-vtp.git
$ cd ersap-vtp
$ mkdir -p build/release
$ cd build/release
$ cmake ../.. -DCMAKE_BUILD_TYPE=release -DBOOST_LIBRARYDIR=/usr/lib64/boost169 -DBOOST_INCLUDEDIR=/usr/include/boost169
$ make

If the last (make) command fails, it’s because calling cmake for ersap will relink the disruptor lib to the wrong boost libraries. To fix this, got back to the disruptor and remake it.

$ cd <Disruptor_home>/build
$ rm CMakeCache.txt
$ cmake .. -DCMAKE_BUILD_TYPE=release -DBOOST_LIBRARYDIR=/usr/lib64/boost169 -DBOOST_INCLUDEDIR=/usr/include/boost169
$ make

Now go back to ersap and finish

$ cd <ersap_home>/build/release 
$ make