PerfSDK and multiuser testing with Visual Studio Online

Take a tour of Performance SDK and multiuser testing with Visual Studio Online and learn how convert a scenario recorded with Task Recorder into a single user test and then a multiuser test.

Time: 30 minutes In this lab, you will take a tour of Performance SDK and multi user testing with Visual Studio Online. You will see how to convert a scenario recorded with Task Recorder and convert it to a single user test and then a multi user test. Note: This lab requires that you access the environment as an administrator. For more information, refer to the document named Access Instances. Prerequisites

  • Visual Studio 2015 Enterprise
  • Deployment with Volume Data
  • PerfSDK (look for a folder with that name in the C: or F: drive, depending on your environment)

Steps to create a single user C# test from an XML recording

A video about how to create a single user test can be found here: https://mix.office.com/watch/qtdlasy2rcf3

  1. Create a recording of a scenario that you want to test with Task Recorder.
  2. Run Visual Studio as Administrator. Build the PerfSDKSample project, which is in the PerfSDK folder. If you have already done this, skip this step.
  3. Open Dynamics 365 > Addins > C# perf test generator add-in from Visual Studio. Go to Dynamics 365 **> **Addins > Create C# perf test from recording.
  4. You should see the following dialog. Fill in the required details and click Import.

    perf103a

  5. You should see generated C# test in Generated folder in the project that you’ve selected.

Steps to run single user performance test with Perf SDK:

  • Make sure to copy download dll's to the following folder and add a reference to WebDriver.dll to your project

    perf103d

  • Generate certificate and install it. To generate a certificate file, run the following commands:

    generatecert

    When prompted for private key password, select None. You should see the following files:

    tempcertNotable pieces:

  • -n “CN=TestAuthCert” is giving a human-readable name to the cert, feel free to tweak for your scenario.
  • -eku 1.3.6.1.5.5.7.3.2 is certificate purpose. This is a client authentication cert, as opposed to code signing, encryption or something else. Next, install *.pfx file (make sure to select Local Machine when you install it) and copy this certificate file to PerfSDK folder.

Open powershell window as Administator and run the following command to get a thumbprint of installed certificate:

get-thumbprint

Put this thumbprint value in CloudEnvironment.Config file:

config-thumbprint

The next step is to update wif.config to make AOS trust this certificate. To do that, open IIS and find Microsoft Dynamics 365 for Finance and Operations, Enterprise edition in the list of sites. Click Explore to open and find a file wif.config.

wifconfig

Update this file by putting your certificate and authority name:

wif-updated

And restart IIS. Open Sample project in Visual Studio and edit the file PurchaseReq.cs, which is a sample single user test. Comment the following lines in this file:

perf103e

Modify your CloudEnvironment.Config file by entering your admin username. The following code is a example. Note: The ConfigName must be DEVFABRIC.

perf103f

Enter your endpoint in CloudEnvironment.Config. Note: If you have an ARR-enabled environment, i.e. you have 2 endpoints like this:

  • apr-arr8aossoap.axcloud.test.dynamics.com
  • apr-arr8aos.axcloud.test.dynamics.com

You would need to enter both endpoints in CloudEnvironment.Config:

perf103upd

Go to Test > Test settings > Default processor architecture and set it to x64. Build the solution. Go to Test > Windows > Test Explorer Note: Sometimes Visual Studio may not update the list of tests. In this case, restart Visual Studio and re-open the test Explorer. Note: Your newly created test will be named TestMethod. If you change the method name of TestMethod your test will get an individual name. Now you can run the test. You should see Internet Explorer starting and replaying the scenario that you've recorded.

Steps to create a multiuser test from a singleuser test

To convert a single-user test generated in the previous section to multi-user test, add MS.Dynamics.TestTools.UIHelpers.Core; to your test script and replace the following line in TestSetup method.

Client = DispatchedClient.DefaultInstance;
With
DispatchedClientHelper helper = new DispatchedClientHelper();
Client = helper.GetClient();

Make sure the values that you have entered during task recording are randomized. You may need to use the Data Expansion Tool first to generate test data.

Setup Visual Studio Online for multiuser testing

For this example ProcureToPay.cs will be used. You need to go to log in to Visual Studio Online portal and launch Visual Studio from there. Note: you need to do this only once. Once you have logged in in VSO, those settings are saved.

vsonline-5

Open PerfSDK sample project. Make sure to update UserFormat entry in CloudEnvironment.Config file to reflect admin user url. Example: for admin@example.com use TST_{0}@example.com as user format. Also make sure to change the UserCount to the amount of users you want to have in your performance test.

vsonline-12

Run this command in PerfSDK folder: MS.Dynamics.Performance.CreateUsers.exe to create test users for your environment. You may create as many users as you want to, for this example 150 is used. Example: **MS.Dynamics.Performance.CreateUsers.exe 150 USMF* will create 150 test users for company USMF.* Make sure that users were created in the system. Login to your endpoint as admin user and check.

Testing sandbox

This step assumes you have a developer topology. Please follow the instructions from previous paragraph. There is one additional step you need to do in order to establish trust between your developer topology and/or Visual Studio Online test agent to communicate to sandbox machines: You would need to remote desktop to your AOS machine, copy over .cer file, install it by double-clicking on the file. When prompted for certificate store select Personal:

personalstore

And update file wif.config. To update file wif.config, open IIS, find AOSService among websites and click Explore

vsonline-23

This action would open Explorer, you should be able to find wif.config in the opened folder. Update this file by putting certificate thumbprint and CN values (use the values from certificate you've generated on previous steps):

wif-updated

And restart IIS. Now you can run performance tests against this topology. Note: if your topology has multiple AOS machines, you need to install certificate and update wif.config on each of those machines.

Run performance test

Open ProcureToPay.cs in Visual Studio editor and append the following lines in TestSetup method:

var testroot = System.Environment.GetEnvironmentVariable("DeploymentDir"); 
if (string.IsNullOrEmpty(testroot)) 
{
    testroot = System.IO.Directory.GetCurrentDirectory(); 
} 
Environment.SetEnvironmentVariable("testroot", testroot);

Double click on file vsonline.testsettings in your solution files, use the following settings (your PerfSDK folder may be different):

vsonline-29

In Setup and Cleanup Scripts select setup.cmd located in %testroot%Visual Studio Onlinesetup.cmd. Notable pieces: you may need to update your deployment configuration to reflect your certificate name (for this demo *CsuClient.pfx **is used) and password. Make sure add \.pfx file you've generated previously and update the following files:

  • setup.cmd with %DeploymentDirectory%CloudCtuFakeACSInstall.cmd %DeploymentDirectory%YourCertificate.pfx
  • CloudCtuFakeACSInstall.cmd with the password of your cert (that should be an empty string)

In Additional Settings select Run tests in 64 bit process on 64 bit machine. To run the test, open the SampleLoadTest.loadtest file and select Run Load Test.

perf103u

When the test finishes, you should see a summary with transaction results.

perf103v

You can switch to Graphs view to view different indicators for the test controller and test scenario. Note: Information about your System under Test is not available in this view. To access this information you would have to use LCS to monitor your AOS CPU and memory usage, or set up perfmon directly on the AOS and set up the SQL/Windows Azure portal to monitor SQL DTU usage.

perf103w

Troubleshooting

System.TypeInitializationException

If you see an error message like this:

System.TypeInitializationException: System.TypeInitializationException: The type initializer for
'MS.Dynamics.TestTools.CloudCommonTestUtilities.Authentication.UserManagement' threw an exception. --->
System.ServiceModel.CommunicationException: An error occurred while making the HTTP request to
https://sandbox.ax.dynamics.com/Services/AxUserManagement/Service.svc/ws2007FedHttp. This could be due to the fact 
that the server certificate is not configured properly with HTTP.SYS in the HTTPS case. This could also be caused 
by a mismatch of the security binding between the client and the server.** ---> System.Net.WebException: 
The underlying connection was closed: An unexpected error occurred on a send. ---> System.IO.IOException: 
Unable to read data from the transport connection: An existing connection was forcibly closed by the remote host. ---> 
System.Net.Sockets.SocketException: An existing connection was forcibly closed by the remote host. 

Solution

You would need to run the following powershell script on your development machine:

Set-ItemProperty HKLM:SOFTWAREMicrosoft.NETFrameworkv4.0.30319 -Name SchUseStrongCrypto -Value 1 -Type dword -Force -Confirm:$false
if ((Test-Path HKLM:SOFTWAREWow6432NodeMicrosoft.NETFrameworkv4.0.30319)) 
{ 
    Set-ItemProperty HKLM:SOFTWAREWow6432NodeMicrosoft.NETFrameworkv4.0.30319 -Name SchUseStrongCrypto -Value 1 -Type dword -Force -Confirm:$false 
}

Certificate thumbprint errors

Error example

Result StackTrace:          

at MS.Dynamics.TestTools.CloudCommonTestUtilities.Authentication.SelfMintedTokenAuthenticator.MintToken(String email, 
String nameId, String identityProvider, String audience, String certThumbprint)
at MS.Dynamics.TestTools.CloudCommonTestUtilities.Authentication.SelfMintedTokenAuthenticator.SignIn()
at MS.Dynamics.TestTools.CloudCommonTestUtilities.Authentication.UserManagement.get_Service()
at MS.Dynamics.TestTools.CloudCommonTestUtilities.Authentication.UserManagement.PopulateAxUsers()
at MS.Dynamics.TestTools.CloudCommonTestUtilities.Authentication.UserManagement..cctor()
--- End of inner exception stack trace ---
at MS.Dynamics.TestTools.CloudCommonTestUtilities.Authentication.UserManagement.get_AdminUser()
    at MS.Dynamics.Performance.Application.TaskRecorder.TestRecord1Base.TestSetup() in 
        J:PerfSDKPerfSDKLocalDirectorySampleProjectPerfSDKSampleGeneratedTestRecord1Base.cs:line 45
Result Message:             

Initialization method MS.Dynamics.Performance.Application.TaskRecorder.TestRecord1Base.TestSetup threw exception. 
System.TypeInitializationException: System.TypeInitializationException: The type initializer for 
'MS.Dynamics.TestTools.CloudCommonTestUtilities.Authentication.UserManagement' threw an exception. --> 
MS.Dynamics.TestTools.CloudCommonTestUtilities.Exceptions.WebAuthenticationException: 
Failed finding the certificate for minting tokens by thumbprint: b4f01d2fc42718198852cd23957fc60a3e4bca2e

Solution:

Make sure the thumbprint in CloudEnvironment.Config doesn't have invisible Unicode characters. To do that paste your error message into a tool that would show invisible Unicode characters. An example is Unicode code converter.

Unicode code converter

Zoom factor

Sometimes you get the error related to IE zoom factor.

Error example

Result StackTrace:          
at OpenQA.Selenium.Remote.RemoteWebDriver.UnpackAndThrowOnError(Response errorResponse) in c:\Projects\webdriver\dotnet\src\webdriver\Remote\RemoteWebDriver.cs:line 1108
   at OpenQA.Selenium.Remote.RemoteWebDriver.Execute(String driverCommandToExecute, Dictionary`2 parameters) in c:\Projects\webdriver\dotnet\src\webdriver\Remote\RemoteWebDriver.cs:line 862
   at OpenQA.Selenium.Remote.RemoteWebDriver.StartSession(ICapabilities desiredCapabilities) in c:\Projects\webdriver\dotnet\src\webdriver\Remote\RemoteWebDriver.cs:line 830
   at OpenQA.Selenium.Remote.RemoteWebDriver..ctor(ICommandExecutor commandExecutor, ICapabilities desiredCapabilities) in c:\Projects\webdriver\dotnet\src\webdriver\Remote\RemoteWebDriver.cs:line 89
   at OpenQA.Selenium.IE.InternetExplorerDriver..ctor(InternetExplorerDriverService service, InternetExplorerOptions options) in c:\Projects\webdriver\dotnet\src\webdriver\IE\InternetExplorerDriver.cs:line 127
   at MS.Dynamics.TestTools.CloudCommonTestUtilities.Authentication.Browser.InternetExplorerBrowser.GetWebDriver(Uri initialUri)
   at MS.Dynamics.TestTools.CloudCommonTestUtilities.Authentication.Browser.SeleniumBrowser.LaunchWithAuthentication(Uri targetUri)
   at MS.Dynamics.TestTools.CloudCommonTestUtilities.Authentication.Browser.AuthenticatedBrowser.CreateSession(SupportedBrowser browser, IAuthenticator authenticator, Uri launchUri)
   at Microsoft.Dynamics.TestTools.Dispatcher.JsDispatcher.OpenPipeline()
   at Microsoft.Dynamics.TestTools.Dispatcher.JsDispatcher.OpenClient(ClientState initialState, ClientBehavior behavior)
   at Microsoft.Dynamics.TestTools.Dispatcher.Client.DispatchedClient.SetClientState(ClientState state)
   at Microsoft.Dynamics.TestTools.Dispatcher.Client.DispatchedClient.set_Company(String value)
   at MS.Dynamics.Performance.Application.TaskRecorder.Free_Text_InvoiceBase.TestSetup() in C:\PerfSDK\Scripts\SampleProject\PerfSDKSample\Generated\Free_Text_InvoiceBase.cs:line 50
Result Message:              Initialization method MS.Dynamics.Performance.Application.TaskRecorder.Free_Text_InvoiceBase.TestSetup threw exception. System.InvalidOperationException: System.InvalidOperationException: Unexpected error launching Internet Explorer. Browser zoom level was set to 200%. It should be set to 100% (NoSuchDriver).

Solution

The IE zoom factor can be set to 100% by changing the following keys:

  • Computer\HKEY_CURRENT_USER\SOFTWARE\Microsoft\Internet Explorer\Zoom\ResetZoomOnStartup = 0
  • Computer\HKEY_CURRENT_USER\SOFTWARE\Microsoft\Internet Explorer\Zoom\ResetZoomOnStartup2 = 0
  • Computer\HKEY_CURRENT_USER\SOFTWARE\Microsoft\Internet Explorer\Zoom\Zoomfactor = 80000

Depending on the version of the local machine that is being used, before starting the RDP session it may be necessary to “Change the size of text, apps and other items”. This field is available by right-clicking on your display and selecting Display settings.

Missing configuration file

Result Stack Trace:
System.ServiceModel.Description.ConfigLoader.LoadChannelBehaviors(ServiceEndpoint serviceEndpoint, String configurationName)
System.ServiceModel.ChannelFactory.ApplyConfiguration(String configurationName, Configuration configuration)
System.ServiceModel.ChannelFactory.InitializeEndpoint(String configurationName, EndpointAddress address, Configuration configuration)
System.ServiceModel.Configuration.ConfigurationChannelFactory`1..ctor(String endpointConfigurationName, Configuration configuration, EndpointAddress remoteAddress)
MS.Dynamics.TestTools.CloudCommonTestUtilities.Services.ConfigurationClientBase`1.InitConfigurationChannelFactory(Configuration config, String endpointConfigurationName, EndpointAddress remoteAddress)
MS.Dynamics.Test.Team.Foundation.WebClient.Common.InteractionService.ReliableCommunicationManagerProxy..ctor(String endpointConfigurationName, EndpointAddress remoteAddress)
MS.Dynamics.Test.Team.Foundation.WebClient.Common.InteractionService.ClientCommunicationManager..ctor(String endpointConfigurationName)
MS.Dynamics.Test.Team.Foundation.WebClient.Common.InteractionService.ClientCommunicationManager..ctor()
Microsoft.Dynamics.TestTools.Dispatcher.ISDispatcher.ISDispatcher.OpenClient(ClientState initialState, ClientBehavior behavior)
Microsoft.Dynamics.TestTools.Dispatcher.Client.DispatchedClient.SetClientState(ClientState state)
Microsoft.Dynamics.TestTools.Dispatcher.Client.DispatchedClient.set_Company(String value)
MS.Dynamics.Performance.Application.GFM.PDLTrend.ProcureToPayTrend.ProcureToPaymentTrend() in 

Debug Trace:
Default: DateTime="09/20/2016 23:53:42" "Changing company from  to USMF"
Default: DateTime="09/20/2016 23:53:43" "Opening ISDispatcher client."
Default: DateTime="09/20/2016 23:53:43" "Reliable communication manager proxy pointing to URL: https://<BaseURL>/Services/ReliableCommunicationManager.svc"

Solution

This error message indicates that you’re missing MS.Dynamics.Test.Team.Foundation.WebClient.InteractionService.dll.config. Check that this file has been added to vsonline.testsettings, note there are two files with similar names except one is a *.dll and the other is *dll.config.