mcrouter installation

Automatic installation for Ubuntu 14.04

To simplify dependency installation, we provided an auto-install script that's been tested on Ubuntu 14.04.

The script might also be useful for other systems - make sure to read through its source files. It contains a bunch of "recipe" files to download and install each mcrouter dependency, including workaround for common pain points.

After you've read through the script and made sure you're fine with the commands it will run, invoke with absolute dir for self-contained install and any arguments to make:

$ git clone [email protected]:facebook/mcrouter.git
$ ./mcrouter/mcrouter/scripts/install_ubuntu_14.04.sh /home/$USER/mcrouter-install/ -j4
[sudo] password for ...:
...
$ ~/mcrouter-install/install/bin/mcrouter --help

Manual installation

Dependencies

• GCC 4.8+
• Boost 1.51+ (boost::filesystem, boost::system, boost::regex, boost::context)
• Ragel

Here's a list of required packages for Ubuntu from the auto-install script:

sudo apt-get install -y gcc-4.8 g++-4.8 libboost1.54-dev libboost-thread1.54-dev \
    libboost-filesystem1.54-dev libboost-system1.54-dev libboost-regex1.54-dev \
    libboost-python1.54-dev libboost-context1.54-dev ragel autoconf unzip \
    libsasl2-dev git libtool python-dev cmake libssl-dev libcap-dev libevent-dev \
    libgtest-dev libsnappy-dev scons flex bison libkrb5-dev binutils-dev make \
    libnuma-dev ragel

• folly. Follow instructions from folly README. Also take a look at auto install folly recipe.
• FBThrift. Follow instructions and check out the auto install recipe.

Build mcrouter

In mcrouter folder run

 autoreconf --install
 ./configure
 make

###Run unit tests (optional)

Run

 make check

If you have "symbol not found" errors from gtest, build it and put libgtest.a/libgtestmain.a into you LD_LIBRARY_PATH. To build gtest:

• load it from http://googletest.googlecode.com/files/gtest-1.6.0.zip
• in make subfolder run

 make

• Rename gtest.a to libgtest.a; gtest_main.a to libgtestmain.a
• Don't forget to add libgtest.a and libgtestmain.a to your LD_LIBRARY_PATH