You have finished the following tutorials:
Tutorial: Getting Started with LoadGen
Tutorial: LoadGen Configurator first use
Please note
The LoadGen test infrastructure (LoadGen Director, LoadGen Launcher Agents, and the LoadGen AVD Agents) all communicate with each other (read more about network traffic here). You must either add the LoadGen Director and LoadGen Launcher Agents in Azure as Virtual Machines or make sure you make a Site-to-Site VPN between your Azure WVD VNET and the network on which your LoadGen Director and LoadGen Launcher Agents reside.
Windows Virtual Desktop (WVD) is renamed to Azure Virtual Desktop (AVD)
But not everything is yet renamed, so in some cases, we still use WVD instead of AVD.
Step 1: Download and install prerequisites
- Click the Download & Install button
- Make sure you have the VC Runtime libraries installed.
- Make sure you have read and understood the System Requirements of LoadGen.
- 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 2: Choose your Target Environment
LoadGen 2021-Q1 - 5.0.0.6800
Starting from LoadGen Release 2021-Q1 we support Azure Virtual Desktop. If you want to continue stop the LoadGen Configurator and start the LoadGen Director.
- Close the LoadGen Configurator.
- Go to the Windows Start Menu.
- Open the LoadGen Director.
Step 3: Create an Azure Active Directory App Registration
Go to https://portal.azure.com and log on with a user with the appropriate rights to create an App Registration.
- Click on the Azure Active Directory button
- Go to the App Registrations option
- Click New Registration
- Add the name of your App registration and press Register.
- Now the new App is registered, here you can find the Application (Client) Id and the Directory (Tenant) Id. These two GUIDs you will need later on configuring the Load Profile in the LoadGen Director.
- Now click on the Authentication option and set the Allow public client flows to Yes.
Azure Virtual Desktop - spring 2020 (ARM)
- Go to API permissions, and click Add Permission. Click the APIs my organization uses and search for Azure or Windows Virtual Desktop. Choose the Azure Virtual Desktop or Windows Virtual Desktop. The Application (client) ID will start with 9cdea.
- Choose the Delegated permissions tab and select the User.Access API.
- Click Add permissions.
- Now remove the default Microsoft Graph User.Read API Permission.
- If the User.Read is removed you only have the User.Access remaining.
- Now grant consent by clicking
Azure Virtual Desktop - Classic
- Go to API permissions, and click the Add Permission. Click the APIs my organization uses and search for Windows Virtual Desktop. Choose the Windows Virtual Desktop AME.
- Choose the Delegated permissions tab and select the user_impersonation API.
- Click Add permissions.
- Now remove the default Microsoft Graph User.Read API Permission.
- If the User.Read is removed you only have the user_impersonation remaining.
- Now grant consent by clicking
Step 4: Prepare LoadGen Agents
- You can host your LoadGen Agents on-premises or in another environment. Make sure you have a direct connection to the Network of the Azure Virtual Desktop environment. Also, the following ports must be opened on the Firewall or NSG, read more in this article.
- The LoadGen Agents must be plenty sized, as the (new) Remote Desktop client is using a lot of resources (msrdc.exe).
- Install the Microsoft Remote Desktop client (download) on the LoadGen Agents, as mentioned earlier the LoadGen Agents will launch the Azure Virtual Desktop sessions via the msrdc.exe application.
- Create a LoadGen Director Canvas
- Choose FAT Client (Windows 7 and up)
- Add a name, please note this is not your actual AVDtest profile, this is something we will do after the preparation of the LoadGen Agents.
- Now click on the Flows tab and choose Link to existing...
- Download this LoadGen Flow and use this Flow (this flow only works on English versions of Windows -> you can change the flow if you have another OS language installed). Download the Flow here. Read more about this Flow / Workload in this article.
- Now click the Test machines and add the LoadGen Agents which you want to use in your Azure Virtual Desktop later on. Read more about how to install LoadGen Agents in this article.
- Now click the Load Scenario tab, click the Manage button, and alter your Load Scenario or Schedule. Close the window and choose the Default Load Scenario.
- Click OK to save the canvas.
- Load the newly created canvas.
- Now open the canvas by double-clicking the Flow icon in the canvas.
Step 5: Prepare LoadGen Agents AVD user tokens
- Click the Flows tab page again and continue with the next steps.
- Click Edit.
- The LoadGen Studio will open now, you will see the following screen.
Add your Azure Directory Id and App Id
- Click the Custom Objects tab.
- In the Variables grid, you can see the Azure_TenantId and Azure_AppId, edit these variables with the information from step 3 item 6.
Check the version of AVD
Add your AVD Resource Name
- In the Variables grid, you must now add the name of the AVD Resource.
- Edit the variable WVD_ResourceName with the correct name of the resource you want to start (this is the name that users see in the Remote Desktop client).
Add your Azure Test users
- Click the Repository tab.
- Select the Azure Test Users Datasource and press Edit.
- Add your own Azure test users, and make sure these users are allowed to start an Azure Virtual Desktop resource.
Debug the Flow
- Now start the LoadGen Studio Recorder
- Select the correct Application Block.
- Start the Block to debug if this Flow works in your environment
- If you see the Azure Virtual Desktops starting up, then all is fine and you can continue.
The flow cannot be replayed because there is no LocalClient session available.
If you receive the following error message: The flow cannot be replayed because there is no LocalClient session available, make sure you have installed the Microsoft Visual C++ 2015, 2017, and 2019 (x64 and x86) download. Available after installation of LoadGen Suite in folder C:\Program Files\LoadGen\LoadGen Shared\Resources.
Run the Prepare Flow
- You can now go back to the LoadGen Director.
- Click the Run your test tab page.
- Press the Start button, the LoadGen Prepare AVD flow will now be replayed at your configured LoadGen Agents. When the LoadGen Agents are prepared you can continue with setting up the AVD test.
- Closely monitor your LoadGen Agents to see if every user has logged on successfully.