Run a Test

How to run your first load test.

Setup a Test Execution

Ok, so now you have the demo shop running on your machine and you have set up the demo testsuite. To run a test, first tell your setup (<posters-simple-loadtest-suite>/config/project.properties) which test configuration to use and where to find your Posters demo shop instance:

com.xceptance.xlt.testPropertiesFile = my-test.properties

store-url = https://localhost:8443/posters/

Then you can configure the basic properties of the test suite and the load profile (in <posters-simple-loadtest-suite>/config/my-test.properties). Our demo test suite comes with basic test.properties which you can use as a starting point for whatever you are planning.

com.xceptance.xlt.loadtests = TVisit
com.xceptance.xlt.loadtests.default.rampUpPeriod = 5m
com.xceptance.xlt.loadtests.default.measurementPeriod = 1h
com.xceptance.xlt.loadtests.default.shutdownPeriod = 1m

## Test case specific configuration.
com.xceptance.xlt.loadtests.TVisit.users = 1
com.xceptance.xlt.loadtests.TVisit.arrivalRate = 500

In this case we run a test for 1 hour with a 5 minute ramp-up period, and a 1 minute shutdown period. The shutdown phase will not turn up in our measurements, but ramp-up does. You can exclude it later if desired. Total runtime is 1h 5min ( measurement period + shutdown period).

Run the Test Execution

To run the test execution, tell the mastercontroller where the test suite is (in <xlt>/config/mastercontroller.properties):

com.xceptance.xlt.mastercontroller.testSuitePath = <posters-simple-loadtest-suite>

Then navigate to <xlt>/bin and start the mastercontroller (MC) in auto mode with an embedded agentcontroller (so the load generators come up on your local machine without any extra configuration work).

$ ./mastercontroller.sh -auto -embedded -comment "My first test run"
Last modified March 4, 2022