CLI

Format

java [-Dseconds=N -Dread.ms=N -Dwrite.ms=N -Dexec=<1,2,3> -Dsample=N -Dprint=<0,1> -Ddebug=<0,1> -Dserver=<0,1> -Dtfactor=1.2 -Dtfactor0=1.1] -jar ultimate-stress-x.x.jar <host> <port> [<rps>]

Necessary Params

• <host> - target host where stress sends requests
• <port> - port of target host
• <rps> - (optional) number request per second to target host. If not set - stress will find a maximum rps

Example: java -jar ultimate-stress-x.x.jar targethost.com 80 10000

Extra Tuning params Params

These params are in form of jvm options so must come exactly after java and before -jar: java [extra params] -jar ...

• -Dseconds=N - duration of running the stress in seconds, e.g. ``
• -Dread.ms=N or Dwrite.ms=N - timeouts for reading answer from the server and wring request to the server respectively in milliseconds (default is 1 second)
• -Dexec=<1,2,3> - type of fixed-rate-timer implementation: 1 - hashedwheel (default) or 2 - jdk scheduled excutor or 3 - plain Thread.sleep version
• -Dsample=N - sample size for estimating a request generation time (should be >1M). If set - sampling is done before start
• -Dprint=<0,1> - should it print response to stdout (for trouble shooting purposes), default=0
• -Ddebug=<0,1> - should it print error stacktraces to stdout (for trouble shooting purposes), default=0
• -Dserver=<0,1> - should it run a simple server on localhost with request counting and responses with 50ms approx delay (default=0)
• -Dtfactor0=1.2 - initial tuning factor. Used when calculating rps number after first connection limit error (default=1.2)
• -Dtfactor=1.1 - tuning factor, used on subsequent connection limit errors for decreasing current rps value (default=1.1).