How to setup, build, and run tests on Linux

Note: as of 7/10/2014 we require the latest Ubuntu LTS 14.04 and Boost 1.54 for development branch; This will be required for master branch in the next release

1. Install Ubuntu 14.04 or later.

2. Add the Ubuntu PPA for GCC 4.8:

sudo apt-get install python-software-properties
sudo add-apt-repository ppa:ubuntu-toolchain-r/test  
sudo apt-get update  

3. Install all the needed build tools and libraries

sudo apt-get install g++-4.8 git make libboost1.54-all-dev libssl-dev cmake

4. (Optional) We recommend using g++-4.8 as your default compiler:

sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-4.8 20
sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.8 20

5. Clone the project using Git (it will be stored in the folder "casablanca"):

git clone https://git01.codeplex.com/casablanca

Going forward, you will want to pull from the master branch, which will always contain the last known release.

6. Build the SDK for Release

cd casablanca/Release
mkdir build.release
cd build.release
CXX=g++-4.8 cmake .. -DCMAKE_BUILD_TYPE=Release
make

You can build the Debug version by specifying -DCMAKE_BUILD_TYPE=Debug on the cmake line instead.

7. After building you can run the tests by executing the ./run_tests.sh script inside the "Binaries" folder:

cd Binaries
./run_tests.sh

For versions prior to 2.0, please visit Setup and Build on Linux (1.4)