Authors: Hien Nguyen, David Tamas-Parris

First, make sure you have all the dependencies needed to run this project. We use Boost v1.69.0 [download here], Crow (a single header file crow_all.h has been included in this repository, which can also be downloaded here), and nlohmann/json for reading JSON data (follow the download instructions here).

To install Boost v1.69.0, run the following commands

wget https://dl.bintray.com/boostorg/release/1.69.0/source/boost_1_69_0.tar.gz
tar -zxvf boost_1_69_0.tar.gz
cd boost_1_69_0
./bootstrap.sh    # this will generate ./b2
sudo ./b2 install

You can check the installed version by running

cat /usr/local/include/boost/version.hpp | grep "BOOST_LIB_VERSION"

If you see something like below, you have the correct version installed.

#define BOOST_LIB_VERSION "1_69"

To compile all programs, run

make

Then start the server (default running on port 8080),

./cache_server

cache_server accepts four optional command line arguments. -m maxmem, -s server, -p port, and -t threads. You can assume the server is always running on 127.0.0.1, and ignore the thread count option for now. However, for the purpose of testing the cache, you can try setting maxmem to some number (default is 8), and changing the default port.

To check the status of all networking tests, in another terminal tab, run

./test_cache_client --success

We tested the cache behavior over the network. The cache_server handles all cache operations as prompted by cache_client via TCP connection and HTTP requests, and then communicate back the results to cache_client.

Lastly, we ran valgrind to ensure no memory leaks on both the client and server side.