Installation¶

Dependencies¶

JACAL has two main dependencies (which in turn might require a lot more):

The DALiuGE execution framework, and
The Yandasoft libraries

Installation for both dependencies is covered below.

Docker Image Installation¶

The following installation instructions are recommended for deployment on a laptop or workstation.

Building the Images¶

DALiuGE is available from the ICRAR github repo. There are three packages:

daliuge-common – the base image containing the basic DALiuGE libraries and dependencies.

daliuge-translator – the DALiuGE translator, built on top of the base image. This converts Logical Graphs into Physical Graphs.

daliuge-engine – the DALiuGE execution engine, built on top of the base image.

cd <install dir>
git clone https://github.com/ICRAR/daliuge.git
cd daliuge/daliuge-common; ./build_common.sh dev
cd ../daliuge-translator; ./build_translator.sh dev
cd ../daliuge-engine; ./build_engine.sh dev

In JACAL, the standard daliuge-engine is replaced with a JACAL version that is based on both the DALiuGE base image and the Yandasoft image.

cd <install dir>
git clone https://gitlab.com/ska-telescope/ska-sdp-jacal
cd ska-sdp-jacal; ./build_engine.sh jacal

EAGLE is a web-based visual workspace for generating Logical Graphs.

cd <install dir>
git clone https://github.com/ICRAR/EAGLE.git
cd EAGLE; ./build_eagle.sh dev

Running the Images¶

Now that the images have been built, they need to be run. After this they can be graphed and deployed via EAGLE.

cd <install dir>
cd daliuge/daliuge-translator; ./run_translator.sh dev

cd <install dir>
cd ska-sdp-jacal; ./run_engine.sh jacal

cd <install dir>
cd EAGLE; ./run_eagle.sh dev

Bare-metal Installation¶

Note

For most use cases the docker installation described above is recommended.

DALiuGE¶

See DALiuGE documentation for up-to-date installation and usage information.

Yandasoft¶

See Yandasoft documentation for up-to-date installation and usage information. Note that Yandasoft has a list of dependencies on its own, including casacore, wcslib, cfitsio, fftw, boost, log4cxx and gsl.

JACAL¶

Once DALiuGE and Yandasoft are installed, JACAL itself can be built. JACAL uses the CMake build system, hence the build instructions are those one would expect:

cd <install dir>
git clone https://gitlab.com/ska-telescope/ska-sdp-jacal
cd ska-sdp-jacal
mkdir build
cd build
cmake ..
make

This process should generate a libjacal.so shared library which one can use within DALiuGE’s DynlibApp components. Stand-alone executables are also produced under test, which are used for testing the code outside the context of DALiuGE.