Installation Guide

This is a installation guide for using/testing Stateline locally. For a guide on setting up Stateline in a cluster, see the Cluster Deployment Guide. This guide assumes that you are using Linux (other operating systems are currently not supported).

Prerequisites

This guide assumes you have GCC (>= 4.8.2), CMake (>= 2.8) and git.

Using fetch-all

The easiest way to build Stateline is to use the fetch-all script provided:

$ git clone https://github.com/NICTA/stateline.git
$ cd stateline && bash fetch-all.sh
$ cd build/debug && make -j8

To see if you've installed it correctly, you can run all the tests with make run-test-all.

Manual build

Downloading Stateline

Currently, the only way to obtain Stateline is to clone the GitHub repository. Run this in the directory that you want to download the Stateline source code:

$ git clone https://github.com/NICTA/stateline.git

Dependencies

There is a simple shell script that automatically downloads and builds the necessary dependencies. If you already have all the dependencies, you may skip this step. If you want to use the script to install all the dependencies, create a new directory to install the dependencies and copy over the shell script to that directory. Then, just run ./buildPrereqs.sh and it should automatically download and install the dependencies.

If you want to install the dependencies manually, see the prereqs README.

Building from source

Once the prerequisites are built, make a new folder where you want to build Stateline and copy over the build script.

Then, edit the build.sh file and modify STATELINE_SOURCE_DIR and PREREQ_DIR to point to your Stateline git repository folder and to where you've installed the dependencies, respectively. Finally, run ./build.sh && make which should start building Stateline.