This repo is based off of testground test plans from ipfs and contains test plans for ipfs, reed-solomon and alpha entanglement codes stored on Bitswap nodes. To run a test case, use
testground run single --plan=bitswap-restore --testcase=ipfs --builder=exec:go --runner=local:exec
There are currently three test cases available:
- ipfs
- reed-solomon
- entanglement
Some test parameters applicable to all the test cases are:
unavailable_count
- the number nodes that other nodes can not reach / with data loss. Default is 0file_size
- the size of the file in bytes. The default is 4194304timeout_secs
- time out until test records failure in seconds. Default is 300 seconds
To set the params, use the test-params
flag like so:
testground run single --plan=bitswap-restore --testcase=reed-solomon --test-param unavailable_count=1 --instances=5 --builder=docker:go --runner=local:docker
Some test params specific to the ipfs test case is:
replication_factor
- the number of times the whole file is duplicated. This broken intounixfs
data blocks distributed amoung instances. Default is full replication will all node containing a full copy of all data blocks