Tutorial: Set up LoadGen Load & Performance Testing for Citrix environments

Step 1: Choose the LoadGen Load & Performance Testing option

  1. Choose LoadGen Load & Performance Testing on the tab page LoadGen Testmode within the LoadGen Configurator.
  2. Chose Next to continue.

Step 2: Download and install prerequisites

  1. Click the Download & Install button
  2. Make sure you have the VC Runtime libraries installed.
  3. Make sure you have read and understood the System Requirements of LoadGen.
  4. Make sure you have a SQL Database available if you want to try LoadGen you can also choose to install SQL Express for the time being.

Step 3: Choose your Target Environment

LoadGen 2020-Q3 -

Starting from LoadGen Release 2020-Q3 we have introduced the Citrix Basic and Enhanced Load Profiles, read more about the difference between both profiles in this article. If you want to use the Basic Load Profile continue with the steps below. If you want to use the Enhanced Load Profile stop the LoadGen Configurator and continue reading this article.

  1. Select Citrix Virtual Apps and Desktops.
  2. Enter the name of your test below the question How do you want to call this test?
  3. Choose Next to continue.

Step 4: Add your Active Directory test users

  1. The next step is to add the test users that you will use during your test. You need to use existing users from Active Directory, find more information here
  2. Click Add

Add one or multiple users

  1. You are able to add one or multiple users at once.
  2. Fill in the Username, Password, and NetBIOS Domain (for test users we advise you to have the same password for the complete series).
  3. Choose OK.
  4. After you have pressed OK you will see the Testusers tab page in the LoadGen Configurator, press Next.

Adding multiple consecutive users at once

When adding multiple consecutive users at once you can add a generating statement in the Username field, the below example explained:

The static part is LoadTest, the start index is 1, we will create 100 users and the number of digits we will use is 4.

Users LoadTest0001 to LoadTest0100 are added to your test (these users must exist in the Active Directory).

Trial version:

The maximum amount of test users that you can add depends on what license you have chosen (for the free trial you can add 5 users).

Step 5: Connect to your Citrix Environment

  1. In the Target Environment tab page, you need to define how you would like to connect to your Citrix environment. LoadGen provides you with three options read more about connecting to your Citrix environment in this article.
  2. Add the Citrix StoreFront server, find more information on how to find your Citrix StoreFront URL in this article.

Choose the Citrix Published Application to use in your test

  1. Press thebutton to create a connection to the Citrix environment and retrieve the resources available for the testuser selected in the Use this testuser to retrieve the Published Applications.
  2. In the Choose the StoreFront resource window, choose the Published Application to use in your test.
  3. If you have chosen your resource, choose OK.
  4. After you have pressed OK you will see the Target Environment tab page in the LoadGen Configurator, press Next.

Citrix advanced connection settings

  1. When you check Citrix's advanced settings you can change the settings of your Citrix session.
  2. The default session will be set up as 1024 x 768 with color depth High Color (16 bit).

Step 6: Useraction Flow (User simulation / Test script)

  1. In the Useraction Flow tab page, you can select which Useraction Flow to use in your test. Read more about the Useraction Flow in this article.
  2. You have two options, either use the example user simulation flow from LoadGen or use a blank user simulation flow (this option will guide you through the LoadGen Studio setup flow wizard, where you can create your personal Useraction flow, after completion of your configuration).
  3. We advise you to use the example user simulation flow from LoadGen.
  4. Choose Next.

Step 7: Create your LoadGen Agents

  1. In this step you need to set up your LoadGen Agents, you can add any machine in your IT environment, read more about LoadGen Agents in this article.
  2. We advise you to add your local machine just to get familiar with LoadGen Agents and add more LoadGen Agents from the LoadGen Director at a later moment.

Add your local machine as a LoadGen Agent

  1. Click on Add this machine
  2. Add your Password.
  3. Choose OK.

Install the LoadGen Agent on your local machine

  1. Choose Install
  2. The LoadGen Configurator will now install the LoadGen Agent on the machine you have added.
  3. The installation of the LoadGen Agent is completed when you see the following message and the Next button is activated:
  4. Choose the Next button to continue.

Step 8: Set up your Load Scenario

  1. With the Load Scenario, you can determine how many users can log in at the same time and how long the gap is between two login sessions. Read more about the Load Scenario in this article.
  2. We advise you to choose the default settings of 1 log-in with an interval of 30 seconds (for 5 users’ the total log-in duration will be 2 minutes). You can always change the Load Scenario at a later moment in the LoadGen Director.
  3. Choose Next.

Step 9: Connect to or create a Microsoft SQL database

  1. LoadGen stores all of its test measurements and performance counters (Sytems under Test data) into a Microsoft SQL database. Read more about the SQL database in this article.
  2. Enter the Name and Instance of your SQL database, for example, LocalHost\SQLExpress.
  3. You press the Test Connection button to see if you can create a successful connection to the SQL server.
  4. Choose a SQL database to store your test results, or create one by pressing

Create a new SQL database

  1. You can create a new SQL database from scratch after you have pressed the button to follow the next steps:
  2. Add the Name of your database and click on the Data file tab page:
  3. Check your settings and click on the Log file tab page:
  4. Click OK, to continue.
  5. After you have pressed OK you will see the SQL Server Database tab page in the LoadGen Configurator, press Next.

Step 10: Add your Sytems under Test machines

  1. With LoadGen you can monitor your whole IT environment and get insight into how applications perform in correlation with the performance of machines. Read more about Systems under Tests in this article.
  2. After you have added Systems under Test machines and Performance Counters, click Next.

Step 11: Launch the LoadGen Load & Performance Director

  1. When you click on thebutton, the LoadGen Director will open and you can start working on your first Load & Performance test!
Was this article helpful?
0 out of 0 found this helpful