How to Configure the Test Properties


Topic Last Modified: 2007-09-14

The procedure explains how to configure the test properties by generating a configuration file and then editing it. Tasks include setting up user credentials and specifying parameters such as the length of time that the test should run.

  1. Log on to the client computer by using domain credentials. If you have not joined the client computer to a domain, log on with a local administrator account. We recommend that you use a domain account to enhance the user experience.

  2. Open a Command Prompt window and locate the Exchange Load Generator installation directory.

  3. Run the command LoadGenCmd.exe /g which will generate a generic configuration file that is named LoadGenConfig.xml in the current directory.

  4. Open the LoadGenConfig.xml file by using Notepad or a similar editor. The section in the XML Configuration File Internals, describes the meaning and purpose of each parameter listed in the configuration file.

  5. Search for the LdapSearchFilter parameter. This parameter is used to restrict the set of users who will be included in the test run. By default, it includes all mail-enabled users in the directory at or below the base domain name that is specified in the LdapBaseDn parameter, which immediately follows LdapSearchFilter. You will notice that LdapBaseDn has already been set to the correct value if you are running LoadGenCmd while logged in with domain credentials. If the LdapBaseDn parameter does not correctly specify the base location of your test users, you will need to manually adjust this parameter.

  6. Search for the TargetForest parameter. This parameter specifies which forest should be used to find users and Exchange topology information. The value can be any of the following: a NetBIOS or fully qualified domain name representing a global catalog server, domain controller, domain in the forest, or root of the forest. This parameter has already been set to an acceptable value if you are running LoadGenCmd when logged on with domain credentials. If the value must be changed for any reason, you can edit it at this point. An example of the xml script is as follows, with an accompanying discussion of the parameters.








    • The DirectoryUsername, DirectoryPassword, and DirectoryDomain parameters specify the credentials that will be used to access Active Directory during the test. You will minimally need to adjust the DirectoryPassword parameter.

    • The MasterPassword and MasterDomain parameters specify the domain and password that can be used to authenticate with each test account. You will minimally need to set the MasterPassword parameter equal to the password that you specified when you created the test accounts.

    • The RunLengthDuration parameter specifies how long a test will run before stopping. By default, this is equal to 1 hour. The parameter is specified by using the ISO 8601 extended format of PaYbMcDTdHeMfS where a equals the number of years, b equals the number of months, c equals the number of days, d equals the number of hours, e equals the number of minutes, and f equals the number of seconds. A value of P0Y0M0DT1H0M0S means 1 hour, as does PT1H. To change this to an 8-hour test, you could use P8HS as the value. If you want the test to run with an infinite duration, specify a duration of 0, for example PT0S.

      To define RunLengthDuration at each user group, specify this global RunLengthDuration as 0.

  7. Save your configuration file.