Installation

Supported Platforms

Peloton is known to work on the following platforms. Please note that it will not compile on 32-bit systems.

• Ubuntu Linux 14.04+ (64-bit)
• macOS 10.12+ (64-bit)

Ubuntu Quick Setup

1. Clone Peloton repo

   git clone --recursive https://github.com/cmu-db/peloton.git

2. Install the packages in the package list using this script.

   cd peloton/script/installation
   sudo bash packages.sh

3. Now, go to the Build Peloton step.

OSX/Windows Quick Setup

1. Install Git, Virtualbox, and Vagrant (if needed).

   Git Download Virtualbox Download

   • Vagrant Download
   • Getting Started with Vagrant on OSX Yosemite
   • Getting Started with Vagrant on Windows

2. Clone Peloton repo

   git clone --recursive https://github.com/cmu-db/peloton.git

3. Initialize the vagrant box

   cd peloton/script/installation
   vagrant up

   NOTE: Actual VM is managed by VirtualBox, not stored in the local Peloton repo you just cloned.

4. Connect to the vagrant box

   vagrant ssh

5. Now, go to the Build Peloton step.

OSX Installation without Vagrant

Make sure you have the right version of clang installed. Check by running clang --version. Peloton will build on any version higher than Apple LLVM version 8.0.0 (clang-800.0.42.1) If you have a lower version, specify version of Xcode and download from here

Vagrant Reload

In case you wish to reload the virtual machine so that any changes made in the Vagrantfile take effect, use this command:

vagrant reload --provision

Build Peloton

Before building peloton, make sure that you have installed all its software dependencies by following the instructions given above in Ubuntu Quick Setup or OSX/Windows Quick Setup depending on your machine.

Enter the build directory and run cmake:

• Ubuntu:

   mkdir -p build
   cd build
   cmake -DCMAKE_BUILD_TYPE=Release ..

• Vagrant VirtualBox VM:

  /peloton on VM is automatically created as a shared folder linked to the repo on host. This might not support building directly in the repo, so a separate build dir needs to be created:

   mkdir -p ~/build
   cd ~/build
   cmake -DCMAKE_BUILD_TYPE=Release /peloton

If your system reports error then please try the following alternative instead (it is caused by code coverage not being supported under release mode):

cmake -DCMAKE_BUILD_TYPE=Release -DCOVERALL=False ..

If your system can not find llvm under macOS, please try with following:

cmake -DCMAKE_PREFIX_PATH=`llvm-config-3.7 --prefix` ..

For building a debug mode binary, please run the following command:

cmake -DCMAKE_BUILD_TYPE=Debug .. 

Build and install Peloton

make -j4
make install

Update paths in .bashrc or .zshrc or your favorite shell's startup file :

export PATH=$(BUILD_DIR)/bin:$PATH
export LD_LIBRARY_PATH=$(BUILD_DIR)/lib:$LD_LIBRARY_PATH