Framework for user-level compositional storage systems development. See wiki for more information.
NOTE: Comanche is in its early stages of development and while we welcome collaboration from the open source community, this effort is not for the faint hearted and requires a certain level of systems expertise.
( cd deps
sudo ./install-apts.sh # use ./install-yum.sh for fedora
)
git submodule update --init --recursive
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX:PATH=`pwd`/dist ..
make bootstrap # build the core and dependencies
make # build comanche components & tests, etc
make install
Load modules (XMS) and attach NVMe devices to SPDK
sudo ./load-module.sh
sudo ./tools/nvme_setup.sh /* optionally attach ALL Nvme devices to VFIO */
cmake .
make bootstrap
make
Build components in debug mode (e.g., with asan)
cmake -DCMAKE_BUILD_TYPE=Debug .
Other build options:
cmake -DCMAKE_BUILD_TYPE=ASAN .
cmake -DCMAKE_BUILD_TYPE=Release .
cmake -DCMAKE_BUILD_TYPE=NOOPT .
Prepare to run (use tools scripts)
SPDK/DPDK requires huge pages e.g. # echo 2000 > /proc/sys/vm/nr_hugepages
Software
Hardware
Change compiler preference on Ubuntu with:
'sudo update-alternatives --config c++'
'sudo update-alternatives --config cc'
DPDK
export EXTRA_CFLAGS='-O0 -g'
SPDK
CONFIG_DEBUG=y (command line or CONFIG file)
C++ style guide - https://genode.org/documentation/developer-resources/coding_style