This provides a four-node virtual cluster by docker to develop distributed systems in Mochi-Margo and Mochi-Thallium.

Container hostnames are c1, c2, c3, and c4. The workspace in a container is ~/workspace, which is shared among all containers.

This directory also includes sample programs in Mochi-Margo and Mochi-Thallium.

Margo is a C library that helps develop distributed services based on RPC and RDMA. Thallium is a complete object-oriented wrapper for Margo in C++.

Document [ Margo | Thallium ]
Repository [ Margo | Thallium ]

Install WSL

• https://learn.microsoft.com/en-us/windows/wsl/install

Install Docker Engine

• https://docs.docker.com/engine/install/ubuntu/ (for Ubuntu)
• https://docs.docker.com/engine/install/centos/ (for CentOS)

To allow docker compose to run with user privileges, add $USER to the docker group by sudo usermod -aG docker $USER

$ make build
$ make up
$ make

or

$ docker compose build --build-arg UID=$(id -u) c1
$ docker compose up -d
$ docker exec -u ${USER} -w /home/${USER}/workspace -it mochi-c1 bash

• Install VS Code and Remote Containers extension
• Open this directory
• Open a command palette by Ctrl+Shift+P and execute "Remote-Containers: Rebulid and Reopen in Container"

There are sample programs in Mochi-margo in the sample directory, and in Thallium in the thallium-sample directory.

$ ssh c2

$ sudo apt-get update
$ sudo apt-get install ...

or modify Dockerfile

(in a host)

$ make down

or

$ docker compose down

Enjoy!