Running Exchange Load Generator Tasks


Topic Last Modified: 2008-02-05

The default task parameters for Microsoft® Exchange Load Generator are set up in the LoadGenConfig.xml file. This can be generated by using the command LoadGenCmd.exe /g. To customize the test tasks, you have to edit the configuration file and save it to a directory of your choice. You can also rename it if you choose.

Access the configuration file in either of the following two ways.

  • From the command-line tool: LoadGenCmd.exe /r /c <path>\<config.xml>

  • From the user interface: After you have started the user interface by clicking LoadGenWin.exe in the installation directory, select the file from the Start a new test screen.

This topic includes information about how to set up the task information from the command line (LoadGenCmd.exe) and from the user interface (LoadGenWin.exe).

After you run LoadGenCmd to generate a new configuration file, you then make any required changes in this generated file for the test simulation run.

You can edit the XML file by using an editor of your choice. To download XML Notepad 2007, go to the XML Downloads page at

A typical scenario for setting parameters is as follows:

  • Generate a new configuration file by using LoadGenCmd.exe /g.

  • Open the configuration file and change parameters as required. Important XML tags include <ActionProfile> and <ActionCount>.

    • There is an <ActionProfile> tag for each defined user group. This tag indicates the start of the XML that is related to tasks and their parameters, for a particular user group.

    • In the XML script, a task is of the format <tasknameActionCount>. Therefore, for the logon task, this would be <LogonActionCount>.

    • Additionally, <ActionProfile> has the Name attribute, which will have one of the following values: Light, Average, Heavy, Light, VeryHeavy, or Custom. If you select the Custom profile (<ActionProfile Name="Custom">), the task parameters can be changed according to the user requirements of the simulation.

      If you use one of the well known profile types (Light, Average, Heavy, or VeryHeavy), all the tasks and their parameters do not have to be specified under <ActionProfile>. This is because Exchange Load Generator internally defines the set of tasks and parameters for each of these well known profiles.
      We encourage you to use the above well-known profiles that are provided by Exchange Load Generator. Avoid creating a custom profile unless you are very familiar with Exchange Load Generator parameters, and you understand what type of difference your customization will make in terms of the load that is generated on the server.

When the action profile has been set, run LoadGenCmd.exe /r /c config.xml. This runs the simulation based on the configuration.

When you run LoadGenWin.exe, you are provided with the user interface with which to select the Action Profile type. As you step through the user interface, in the Specify test user groups page, under Action Profile, select Custom.

However, there is no user interface for editing task parameters so if you want a custom profile, do the following:

  1. On the Configuration summary page, save the configuration file.

  2. Close the Microsoft Exchange Load Generator tool.

  3. Open the saved configuration file in Notepad or a similar application, manually change the required task parameters, and then save the file when you are completed.

  4. Open the Microsoft Exchange Load Generator tool. (Locate LoadGenWin.exe and double-click it.)

  5. On the Welcome to Exchange Load Generator landing page, click Start a new test, provide the saved configuration file name on the next page, and then click Continue.

  6. Continue paging through until you reach the Configuration summary page, and then click Start the initialization phase (recommended before running the test).

The following are the tasks that can be run during simulation. To change the XML, search for the task and change the parameters to customize the file. See Customizing the Exchange Load Generator Test for information about the parameters.

  • BrowseCalendar

  • BrowseContacts

  • BrowsePublicFolder

  • BrowseTasks

  • CreateContact

  • CreateFolder

  • CreateTask

  • DeleteFolder

  • DeleteMail

  • DownloadOab

  • EditRules

  • EditSmartFolders

  • ExportMail

  • Logoff

  • Logon

  • MailboxStoreProfile

  • MakeAppointment

  • MoveMail

  • PostFreeBusy

  • PublicFolderPost

  • PublicStoreProfile

  • ReadAndProcessMessages

  • RequestMeeting

  • SendMail

  • Search