The bbb from linhnt31

bbb's Introduction

BBB: Boston Blockchain Benchmarking

Steps to Install & Use

populate a VM instance with Ubuntu 18.04 LTS, # of cpus >= # of Mininet hosts to be used + 1 (the extra core is for the Mininet's main process)

execute the following

sudo su # mininet requires the root priviledge
cd && git clone https://github.com/haochenpan/BBB.git
cd ~/BBB && . setup.sh # to install Go environment, Geth, and Mininet
cd ~/BBB && . run.sh 5 # to start evaluation with 5 miners, replace 5 with any other natural number
# when you run it for the first time, it may not generate some throughput numbers because 
# geth (Ethereum) is preparing the DAG files (check the logs under hosts folder). 
# After a few more runs, logs (and henchforth, throughput numbers) can then be generated.

Project Structure

data/: store all log files for the analysis program to calculate throughputs and latencies
hosts/: store all geth miner runtime data
keys/: store all pre generated keys (may deprecate in the future)
v2/
- v2_config.yaml: Config Mininet topology and link parameters. Explanation see here. Let # of Mininet hosts >= # of miners, i.e. the paramter after . run.sh
analysis.sh: the analysis program that calculates throughputs and latencies, called by run.sh
genesis.json: Etherum Genesis Block's definition
prerun2.sh: prepare Geth miners' folders, environment variables, called by run.sh
run.sh: the entry point of an evaluation
setup.sh: install this project

Recommend Projects