The standalone version uses the following command-line interface (CLI):
StresStimulus.Application.EXE [/ssload | /ss | /noui] <config> [/ssclose] [/report <reportDir> [single]] [/run-profile] <test-profile-name> [/run-name] <test-run-name> [/run-description] <test-run-description>
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. Specify a full path, or the default directory %My Documents%/Fiddler/StresStimulus will be used.
/ssclose Close StresStimulus when the test completes. Only with /ss flag.
/report Create a report when the test completes. Only with /ss or /noui flag.
<reportDir> The directory to save the external report. If this value is not set or the directory does not exist, then use the test directory. Only with /report flag
single Create a single-page report. If not set, then create a multi-page report. Only with /report flag.
/run-profile The profile name specified by the <test-profile-name> to be used for running the load test. (This flag is not supported for distributed tests using load agents)
/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
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
