MindPalace

MindPalace is a full-system framework that developed to study the architectural behavior of large middleware serverless systems. MindPalace contains a simulation infrastructure and a pre-configured virtual machine (VM) to assist FaaS architecture research. The simulation tool leverages QEMU and ChampSim. It extends QEMU to generate detailed instruction and data access traces with corresponding processor states. These traces are passed to a modified ChampSim to simulate the desired architecture. The VM contains a full Ubuntu image with preinstalled OpenWhisk, together with checkpoints for ready-to-run serverless applications.

Contacts

This project is developed by Princeton Parallel Group. If you have any questions, please contact Kaifeng Xu at kaifengx@princeton.edu

Getting Started

git clone https://github.com/PrincetonUniversity/MindPalace.git

Build QEMU

cd qemu
mkdir build
cd build
../configure --prefix=PATH/to/sysroot --enable-trace-backends=simple --target-list=x86_64-softmmu,x86_64-linux-user --enable-kvm --disable-vnc --disable-gtk --enable-plugins
make
make install
cd ..

Build TCG plugins

cd tests/plugin/
make

Download VM for MindPalace

Comming soon, or you want the VM image directly please contact us.

Run QEMU to generate traces

First we need to add QEMU binary location "PATH/to/sysroot" to your .bashrc file.

export PATH=/PATH/to/sysroot/bin:$PATH

Source .bashrc if you just added this line.

source ~/.bashrc

Modify scripts/launch_qemu.sh and set parameters to your path. Launch QEMU full system emulation.

bash scripts/launch_qemu.sh

You might want to type enter again to see when it finishes loading the snapshot. Invoke functions in QEMU to generate traces by OpenWhisk operations. Functionbench is already set up, here is an example:

./bin/wsk action invoke chameleon -p num_of_rows 20 -p num_of_cols 20 -p metadata deadbeef  --result -iv

Run ChampSim

Build ChampSim

cd champsim
./config.sh <configuration file>
make
cd ..

Modify champsim.sh to set paths and configurations. Launch ChampSim simulation.

bash scripts/champsim.sh