Auto-Bencher

Prerequisite

The node version should be greater than 12.16.1.

We suggest users use nvm (node version manager) to manage and switch among the different node version. It would be stable to use LTS.

Usage

• Clone AutoBench

  git clone https://github.com/elasql/auto-bencher.git

• Check into the directory

  `cd auto-bencher`

• Install the dependencies

  npm install

  npm is a package manager of nodeJS.

• To see how to run

  node src/main.js -h

Actions

• Intialize and verify all machines

  node src/main.js [-c config.toml] init

  • -c is an optional field

• Execute the shell commands on all machines

  node src/main.js [-c config.toml] exec --command [CMD]

  • -c is an optional field

• Load data on all machines

  node src/main.js [-c config.toml] load --parameter [parameter file] -d [db name]

  • --properties is an optional field

• Benchmark the DBMS

  node src/main.js [-c config.toml] benchmark --parameter [parameter file] -d [db name]

  • --properties is an optional field

• Grab the data according to the search pattern

  node src/main.js [-c config.toml] pull --pattern [search pattern]

  • -c is an optional field

Debug

To run authbencher in debug mode, please add --debug before the main action.

For example

node src/main.js -c config.toml [--debug] benchmark --parameter [parameter file] -d [db name]

How to contribute this project

1. Create a pull request and state the fixed issues
   • it would be better to add some test cases
2. Pass eslint (formatting)

   npm run eslint

3. Pass unittests

   npm run test