Install Rust, jq, Python (with pip and virtualenv), clang, llvm, cmake and protoc.
On an Ubuntu machine you can just run sudo make install-deps-ubuntu to install all dependencies.
To build, just run make.
To run a setup, you need to have a nodelist.txt with a tab separated value of node names and IP addresses as follows:
clientpool_vm0 10.2.7.5
clientpool_vm1 10.2.7.4
nodepool_vm0 10.2.6.7
nodepool_vm1 10.2.6.4
nodepool_vm2 10.2.6.5
nodepool_vm3 10.2.6.6Machines whose name starts with client will be used as client machines and nodes whose name starts with node will be used a consensus nodes.
These IP addresses NEED NOT be unique.
If you want to reuse a machine to simulate more number of nodes (or want to perform local testing),
feel free to copy the IP addresses of existing machines (or use 127.0.0.1) and use a new name.
To be compliant with the terraform script that I generally use to create test VMs,
you need to have an user called pftadmin in each of these VMs.
Further, one must be able to SSH into pftadmin@ip using a common SSH key.
Generate and save this key as cluster_key.pem.
Save the nodelist.txt and cluster_key.pem and copy the path onto scripts/run_all_protocols.sh.
Now you can an experiment with all protocols using:
virtualenv scripts/venv
source scripts/venv/bin/activate
pip install -r scripts/requirements.txt
sh scripts/run_all_protocols.sh