The goal of the repo is to provide a sample of the Gatling DSE Stress Framework's usage. Feel free to submit a pull request with example simulations.
To build a jar run sbt clean assembly. The compiled jar will be found in gatling-dse-simcatalog_2.12-1.2.3-SNAPSHOT.jar and the executable app will be at target/scala-2.12/gatling-dse-sims
First build the executable app using sbt clean compile then run the app with the path or name of wanted sim name gatling-dse-sims run {SimName}.
Example: target/scala-2.12/gatling-dse-sims run WriteOrderSimulation
Project configs can be found in the src/main/resources the application.conf is the file to set the Simulation and Cassandra settings.
During run you can override part or all of the application settings by using -Dconfig.file={filePath}. If you want to override a single setting only just use the path of the config ie -Dcassandra.hosts=127.0.0.1. This single setting can be used for any value in the gatling.conf file as well.
To change configurations on the fly with excutable use the following format:
JAVA_OPTS="-Dcassandra.hosts=127.0.0.1" gatling-dse-sims run WriteOrderSimulation
To view all loaded and overridden configurations run the follow:
gatling-dse-sims showConf <all, general, cassandra, simulations, gatling>
See: Gatling DSE Stress Wiki for more specific docs for usage.
Run target/scala-2.12/gatling-dse-sims listSims or `build/libs/gat
Run target/scala-2.12/gatling-dse-sims showConf <all, general, cassandra, simulations, gatling>
- Java 1.8+
- SBT
Running sbt assembly will download all of the needed libraries including Scala to your local machine.
Please use the Issues section to add any questions on usage or requests
Use #gatling-dse Slack channel to ask questions.
The easiest way to contribute is to:
- Clone this project
- Create a new branch w/ your name and simple desc. Example: username-oauth
- Push your branch to the repo
- Create a new pull request against master
The new pull request will be reviewed, tested and if verified will be merged with the master branch.
Please include the table creation in the Actions class for your under createTables() or initGraphSchema to let other users ramp up quickly with using you simulations. A short description of the simlation in the doc comments is also welcomed.
It has been developped by Brad Vernon (ibspoof) and improved by the following contributors:
- Matt Overstreet (omnifroodle)
- Chris Bradford (bradfordcp)