Run scenarios from the command line

You can set up scenario run automation by invoking Controller from the command line, without the need to manually define run settings using the UI.

When invoked, Controller checks all of the received arguments and sets its start-up environment accordingly.

For example, you can instruct Controller to connect to the load generator, start up, save results to a folder other than the folder defined in the scenario, and invoke Analysis upon completion of the scenario run.

The following options are available to invoke Controller scenarios and processes from the CLI:

  • CLI tool. The CLI tool installed with Controller enables you to run a scenario from the command line, using an XML input file or a scenario (.lrs) file. For details, see Run scenarios using the CLI tool.

  • wlrun. You can run a scenario (.lrs) from the command line using the wlrun command. For details, see Run scenarios with wlrun command.

  • Controller Service. The Controller Service provides a modernized version of Controller, using a separate Controller engine. The engine is run from the CLI, enabling you to run and manage load tests using existing scenario .lrs files, or by creating .yml files, or running manual commands. For details, see Run the Controller Service from the CLI. (Private Beta release)

Back to top