LoadGen Command Line Parameters

At LoadGen, we understand that each user has unique testing needs, and we strive to offer versatile solutions to meet these diverse requirements. One such flexibility feature in LoadGen is utilizing command line parameters to perform specific actions. These parameters provide users with direct control over their testing environments, enabling them to initiate and modify tests efficiently.

Getting Started with LoadGen Command Line Parameters

In this guide, we will outline the steps to use command line parameters with LoadGen. These steps will cover the basics of launching the command line, navigating to the LoadGen Director directory, and executing the "LoadGen Director.exe" file with the desired command line option.

  1. Start the Command Line: Press the Windows key + R on your keyboard to open the 'Run' dialog box. Type "cmd" and press Enter to launch the Command Prompt.
  2. Navigate to the LoadGen Directory: Within the Command Prompt, type "cd\" to navigate to the root directory.
  3. Next, type "cd 'C:\Program Files\LoadGen\LoadGen Director'" to change the directory to the LoadGen Director folder.
  4. Run LoadGen Director with Command Line Options: Now that you're in the correct directory, you can run the LoadGen Director executable file with your desired command line option. Type '"LoadGen Director.exe" [Your Command Line Option]' and press Enter to execute.

By following these steps, you can leverage LoadGen's command line parameters to enhance your control over your testing processes. Stay tuned for more tips and tricks to help you get the most out of LoadGen.

Versioning

Command Line
Description
/vc:{BuildNumber}
This will force LoadGen to downgrade or upgrade the LoadGen software to the specific build. It's necessary you have an Internet connection or a proxy server set up in your browser. Only use this option in accordance with LoadGen support.
Example: "LoadGen Director.exe" /vc:3999
/nvc
No version check, if you don't want to receive an update message.
/nvl:true
No Vacant Licenses check, if you don't want to receive an available license message.

Load & Performance mode scheduled start of a test

MANDATORY: you need a desktop session to host the LoadGen Director.

This command line parameter only works with the LoadGen Director in Load & Performance Testing mode. If you need to schedule tests without the need for a session/user logged in to host the LoadGen Director, take a look at the LoadGen Cloud, which is a fully API-driven way to start and schedule your tests.  

Command Line
Description
LoadGen Director.exe /nvc /start:{Date} /canvas:{Name}
This will schedule the test for a specific time. Use the yyyyMMdd-HHmm format: i.e. 2019-05-01-19:00. If you add a date and time in the past the test will start immediately.
LoadGen Director.exe /nvc /start:now /canvas:{Name}
This will start the test immediately.

Auto update LGS - Workload file

In LoadGen, one of the features designed to streamline your performance testing process is the auto-update functionality for LoadGen Studio Workload (LGS) files. With this feature, you can efficiently manage and update your workload files directly from the command line, saving valuable time and resources.

  1. Start the Command Line: Press the Windows key + R on your keyboard to open the 'Run' dialog box. Type "cmd" and press Enter to launch the Command Prompt.
  2. Navigate to the LoadGen Directory: Within the Command Prompt, type "cd\" to navigate to the root directory.
  3. Next, type "cd 'C:\Program Files\LoadGen\LoadGen Studio'" to change the directory to the LoadGen Director folder.
  4. Run LoadGen Director with Command Line Options: Now that you're in the correct directory, you can run the LoadGen Director executable file with your desired command line option. Type '"LoadGen Studio.exe" [Your Command Line Option]' and press Enter to execute.
Command Line Description
/upgradelgs:"Full path of LGS file 1";"Full path of LGS file 2"

 Please replace "Full path of LGS file 1" and "Full path of LGS file 2" with the actual full paths of the LGS files you wish to upgrade.

This command instructs LoadGen Studio to auto-update the LGS files located at the specified paths. You can include as many LGS file paths as needed, separated by semicolons. Remember to include the file paths within double quotes, especially if they contain spaces.

Was this article helpful?
5 out of 5 found this helpful