Installation

Prerequisites

GeePS is developed on a 64-bit Ubuntu 14.04 system, with CUDA toolkit installed in /usr/local/cuda.

GeePS will use network from port 9090 to 9290, so please make sure they are open.

Obtaining GeePS and Caffe application

Run the following commands to download GeePS and its submodules:

git clone --recurse-submodules https://github.com/cuihenggang/geeps.git

The --recurse-submodules option downloads the submodules (namely, our minorly modified Caffe fork).

Install dependencies

You can run the following commands to install the GeePS dependencies:

sudo apt-get -y update
sudo apt-get install -y --force-yes scons pdsh libboost-thread-dev libboost-program-options-dev libgoogle-glog-dev libgflags-dev libatlas-base-dev libtbb-dev libzmq-dev

And run the following commands to install the Caffe dependencies:

sudo apt-get -y update
sudo apt-get install -y --force-yes libatlas-base-dev libopencv-dev protobuf-compiler libprotobuf-dev libgoogle-glog-dev libgflags-dev libhdf5-dev libleveldb-dev libsnappy-dev liblmdb-dev libpython-dev libboost-python-dev libboost-filesystem-dev cython python-numpy python-protobuf python-skimage python-h5py python-matplotlib openjdk-7-jre

Or, you can simply run these two scripts to install the dependencies (from geeps root directory):

./scripts/install-geeps-deps-ubuntu14.sh
./scripts/install-caffe-deps-ubuntu14.sh

Build GeePS

You can build GeePS by simply running this command from geeps root directory:

scons -j8

Build GeePS-Caffe

You can build GeePS-Caffe by first entering the apps/caffe directory and run make -j8:

cd apps/caffe
make -j8