Building Conseil

Building Conseil

Prerequisites

The following need to be set up on your computer before your can build Conseil from source:

• Java Development Kit (> 8.x)
• Scala (> 2.12.x)
• SBT (> 1.2.6)
• A database supported by Typesafe Slick, e.g. Postgres

For example, on Ubuntu, you can set up the above using the following commands:

sudo apt-get install -y openjdk-8-jdk-headless
echo "deb https://dl.bintray.com/sbt/debian /" | sudo tee -a /etc/apt/sources.list.d/sbt.list
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 2EE0EA64E40A89B84B2DF73499E82A75642AC823
sudo apt-get update
sudo apt-get install -y sbt

Running the build

After cloning the Conseil git repo and switching to your desired tag or branch, run this command from the root directory of the repository:

sbt clean assembly -J-Xss32m

This will clean any existing local artefacts, compile the project, and create several fat JARs with the runnable application modules, including all needed dependencies.

You can now copy the outputted conseil-api.jar, conseil-lorre.jar, depending on which component you want to run, from the system /tmp folder to a location of your choice.

See Running Conseil for instructions on how to run Conseil and Lorre using this JAR file.