https://github.com/jepsen-io/tendermint

Jepsen tests for the Tendermint distributed byzantine consensus system
https://github.com/jepsen-io/tendermint

Last synced: about 1 month ago
JSON representation

Jepsen tests for the Tendermint distributed byzantine consensus system

• Host: GitHub
• URL: https://github.com/jepsen-io/tendermint
• Owner: jepsen-io
• License: epl-1.0
• Created: 2017-06-08T23:40:16.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2017-09-05T14:49:44.000Z (over 7 years ago)
• Last Synced: 2024-07-10T22:44:34.441Z (6 months ago)
• Language: Clojure
• Size: 63.5 KB
• Stars: 25
• Watchers: 6
• Forks: 10
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# jepsen.tendermint

Jepsen tests for the Tendermint distributed consensus system.

## Building

- Clone this repo

- Install JDK8 or higher

- Install [Leiningen](https://leiningen.org/)

- Optional: install gnuplot

- In the tendermint repository, run `lein run test`

To build a fat JAR file that you can run independently of leiningen, run `lein

uberjar`.

## Usage

`lein run serve` runs a web server for browsing test results.

`lein run test` runs a test. Use `lein run test --help` to see options: you'll

likely want to set `--node some.hostname ...` or `--nodes-file some_file`, and

adjust `--username` as desired.

For instance, to test a shifting cluster membership, with two clients per node,

for 3000 seconds, over a group of compare-and-set registers, you'd run

```

lein run test --nemesis changing-validators --concurrency 2n --time-limit 3000 --workload cas-register

```

Or to show that a duplicated validator with just shy of 2/3 of the vote can split the blockchain during a partition, leading to the loss of acknowledged writes:

```

lein run test --node n1 --node n2 --node n3 --node n4 --node n5 --node n6 --node n7 --dup-validators --super-byzantine-validators --nemesis split-dup-validators --workload set --concurrency 5n --test-count 15 --time-limit 30

```

## License

Copyright © 2017 Jepsen, LLC

Distributed under the Apache Public License 2.0.