Benchmark engine for blockchains
Project description
MixBytes Tank
Requirements
- Python3
- Terraform 0.11.13
- Terraform-Inventory v0.8
Installation
Terraform & Terraform-Inventory
Can be done with tank/install-terraform.sh.
Optional: create virtualenv
Optionally, create and activate virtualenv
sudo apt-get install -y python3-virtualenv
python3 -m virtualenv -p python3 venv
After virtualenv creation and each time after opening a terminal, activate virtualenv to work with the tank:
. venv/bin/activate
Tank
pip3 install mixbytes-tank
Usage
1. Configure the user config
Configure ~/.tank.yml
. The example can be found at docs/config.yml.example.
Please configure at least one cloud provider. The essential steps are:
- providing (and possibly creating) a key pair;
- registering the public key with your cloud provider if needed;
- specifying a cloud provider access token or credentials.
2. Create or get a tank testcase
The example can be found at docs/testcase_example.yml.
3. Start a tank run
tank cluster deploy <testcase file>
4. Login into the monitoring
Locate the newly created instance which name ends with -monitoring
in your cloud, find the instance ip.
Open in browser http://{monitoring ip}:3000/dashboards
, username and password are tank
.
The dashboards can always be found at http://{monitoring ip}:3000/dashboards
5. List current active runs
There can be multiple tank runs at the same time. List and brief information can be seen via:
tank cluster list
6. Create synthetic load
tank cluster bench <run id> [--tps N] [--total-tx N]
<run id>
- id of the run
--tps
- global transactions per second generation rate,
--total-tx
- how many transactions to send (total).
7. Shutdown and remove the cluster
tank cluster destroy <run id>
Hacking
Alternative binding version
Bindings can be configured at ~/.tank/bindings.yml
(by default the predefined binding config is copied and used).
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for mixbytes-tank-0.1.2.dev20190704124001.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 387ff165ba36e12606981740b891e366d66e1ed585780b6e7d4bbebe6fa62f3a |
|
MD5 | ddfcca5d8a729b10d7b38e4be8b0f4c6 |
|
BLAKE2b-256 | e50fa3e18e8b9ae19d0ba9b664fe0d55eb482985d7e6b9d7d8624b489ee879d3 |
Hashes for mixbytes_tank-0.1.2.dev20190704124001-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2f82034d20eb72b6d1a547544bf8659e933373a8774f32543ccda587553ee4f3 |
|
MD5 | 8583a560d9f281d0cf2ff1721a2e4572 |
|
BLAKE2b-256 | db08b74e8e0cbdc48615a077bd208a1d22f941c8aeb21713fc020208ffed50ed |