The standalone version uses the following command-line interface (CLI):
StresStimulus.Application.EXE [/ssload | /ss | /noui] <config> [/ssclose] [/report] <reportDir> [/report-archive] <archivePath> [/report-single] [/run-profile] <test-profile-name> [/run-name] <test-run-name> [/run-description] <test-run-description> [/result-db] <result-db-path>
Where:
/ssload Load the test from the <config> file.
/ss (Default) Run the test from the <config> file.
/noui Run the test from the <config> file in no GUI mode.
Default:
If no flag is specified, then /ss is assumed.
<config> is a StresStimulus test configuration file.
/ssclose Close StresStimulus when the test completes. Only with /ss flag.
/report Create an external report when the test is completed. Only with /ss or /noui flag.
<reportDir> The directory to save the external report. It can be relative to the configuration file. Use the test directory if this value is not set or the directory does not exist. Only with /report flag.
/report-archive Create a .zip archive of the external report. Only with /noui flag. It can be used together with the /report flag.
<archivePath> The path of the .zip archive to create. It can be relative to the configuration file. Only with /report-archive flag.
/report-single Create a single-page report. If not set, then create a multi-page report. Only with /report and /report-archive flag.
/result-db Use the specified path for the embedded database file. Only with /noui flag
<result-db-path> The embedded database file. Only with /result-db flag.
/run-profile The profile name specified by the <test-profile-name> to be used for running the load test.
/run-name The test run name specified by the <test-run-name> argument that will go on the report.
/run-description The test run description is specified by the <test-run-description> argument that will go on the report.
Exit code: The process will return the exit code if the test fails the test quality criteria.
No-UI mode
StresStimulus will execute the test as a console application when running in no UI mode. Use this option to execute tests via a scheduler or in a CI/CD pipeline.
The test progress will be reported in the console as follows:
All performance counters and graphs will not be shown in real-time. However, they will be available on the report after the test is over. On the other hand, the test machine will have more resources available so it can execute more VUs.
Stopping the test
During a test, press Ctrl+C or Ctrl+Break to stop the current test gracefully and calculate the report. Press Ctrl+C or Ctrl+Break again to terminate the process.
Exit Codes
The no UI mode will return the following exit codes:
- 0 when the test successfully started and passes the test pass criteria
- 1 when the test successfully started but fails the test pass criteria
- 2 when the test does not start. The Console.Out will contain the error message
No GUI error log
To create an error log for no-ui test runs, add the suffix 2>{log-file-file} to the argument list of the command line.
For example: StresStimulus.Application.exe /noui c:\mytest.ssconfig 2>c:\myerrorlog.txt
Examples:
StresStimulus.Application.EXE /ssload "My Test.ssconifg"
Opens StresStimulus and loads the test located in %My Documents%/Fiddler/StresStimulus/My Test.ssconifg
%ProgramFiles(x86)%\StresStimulus\StresStimulus.Application.EXE /ss "c:\Tests\My Test.ssconifg" /ssclose
Opens StresStimulus and begins running the test located in c:\Tests\My Test.ssconifg after the test is over, StresStimulus will close.
"C:\Program Files (x86)\StresStimulus\StresStimulus.Application.EXE" /ss "c:\Tests\My Test.ssconifg" /report "c:\external_reports"
Opens StresStimulus and begins running the test located in c:\Tests\My Test.ssconifg after the test is over, StresStimulus creates an external report and saves it c:\external_reports folder.
%ProgramFiles(x86)%\StresStimulus\StresStimulus.Application.EXE /noui "c:\Tests\My Test.ssconifg"
Runs the test located in c:\Tests\My Test.ssconifg in command line mode.
Overview
Content Tools
