Stress and Performance Tool: Configure User Profile
Topic Last Modified: 2011-02-22
The tools included in the Microsoft Lync Server 2010 Stress and Performance Tool package enable you to create and configure test user accounts that you can use to run load simulations. Use the Lync Server 2010 User Creation tool to create the users. (For details, see Stress and Performance Tool: Create Users and Contacts.) After users are created, you must configure them by using the Lync Server 2010 Load Configuration Tool.
Running the Lync Server 2010 Load Configuration Tool
To configure user profiles, run the Lync Server 2010 Load Configuration Tool (UserProfileGenerator.exe) and fill out each of the tabs. UserProfileGenerator.exe generates a directory for each of the client computers that you need to run the simulation. Each client directory also comes with a script to start all of the instances of Lync Server 2010 Stress and Performance Tool (LyncPerfTool.exe).
Important
The values specified in UserProfileGenerator need to match the values specified in the Lync Server 2010 User Creation tool (StressConfig).
Fill in the fields on each tab of the Lync Server 2010 Load Configuration Tool as described in the following sections.
Common Configuration
The Common Configuration tab of the Lync Server 2010 Load Configuration Tool is shown in the following figure.
The Common Configuration tab of the Lync Server 2010 Load Configuration Tool
Fill in the fields of the Common Configuration tab as described in the following steps.
In Number of Available Machines, type or click the number of computers you want to use to run LyncPerfTool.exe. We recommend that you have one computer for every 2,500 users that you will be simulating. That number may vary if you reduce the load level or use only a subset of the available features. (Load levels are set on the General Scenarios tab.)
In Prefix for User Names, type the prefix for the user name of the users.
In User Start Index, click or type the index of the first user to be configured. You can configure different ranges for different types or levels of load, but you must run UserProfileGenerator.exe once per range that you want to configure.
In Number of Users, click or type the total number of users you are going to configure.
In User Domain, type the domain used for the SIP Uniform Resource Identifier (URI). This is what the users use to log on to the Lync Server 2010 Front End Server or Standard Edition server. It can be different from the account domain.
In Account Domain, type the Active Directory domain logon.
In MPOP Percentage, click or type the percentage of users that you want to have multiple points of presence (MPOP).
In Access Proxy or Pool FQDN, type the fully qualified domain name (FQDN) of the server that you want the clients to connect to. If the users are logging on externally, specify the access proxy. If the users are internal, specify the FQDN of their pool or Standard Edition server.
In Port, click or type the port you want users to use for SIP (the default is 5061).
General Scenarios
The General Scenarios tab of the Lync Server 2010 Load Configuration Tool is shown in the following figure.
The General Scenarios tab of the Lync Server 2010 Load Configuration Tool
Configure the load levels and parameters for each of the general scenarios.
In Instant Messaging, which includes peer-to-peer and conferencing, specify the appropriate value for the Load Level.
Note
Load level values for all fields (except Location Information Services) are Disabled, Low, Medium, High, and Custom.
In Audio Conferencing, which is audio conferencing only, specify the appropriate value for Load Level. Peer-to-peer calls are covered in the “Voice Scenarios” section later in this topic.
In Application Sharing, which includes peer-to-peer and conferencing, specify the appropriate value for Load Level.
In Data Collaboration, which includes data conferencing, specify the appropriate value for Load Level.
In Distribution List Expansion, specify the appropriate value for Load Level. You must also click the Advanced button, and then fill in the fields with the same values you configured on the Distribution List tab of the Lync Server User Creation tool (Stressconfig.exe). For details about these fields, see Stress and Performance Tool: Create Users and Contacts.
In Address Book Web Query, which is the address book lookup service (not the address book file download), specify the appropriate value for Load Level. To enable address book downloads, click the corresponding Advanced button, and then set EnableABSDownload to true.
In Response Group Service, specify the appropriate value for Load Level. You must also click the corresponding Advanced button, and then specify the URIs of the response groups you have already created. You must specify at least one response group. Use semicolons to separate multiple response groups.
In Location Information Services, select the appropriate value for Load Level. The load level for Location Information Services must be Enabled or Disabled.
Note
Each of the scenarios has an Advanced button located next to it. These buttons allow access to values specific to each scenario that will change the behavior of the Lync Server 2010 Stress and Performance Tool (LyncPerfTool) and allow for customization. For each scenario on the General Scenarios tab (except Location Information Services), if the value of Load Level is Custom, then the conversation rate will be calculated using the corresponding field in the Advanced dialog box. The field name differs depending on the scenario, but the field description will state “NOTE: This number will only be used if Custom is selected from the drop down menu.” In general, the values High, Medium, and Low will alter the conversation rates per modality in line with the User Model that was developed internally for Microsoft. If there is a need to change the load level per modality due to a difference in expected usage, using a Custom conversation rate is recommended.
Voice Scenarios
The Voice Scenarios tab of the Lync Server 2010 Load Configuration Tool is shown in the following figure.
The Voice Scenarios tab of the Lync Server 2010 Load Configuration Tool
Use the Voice Scenarios tab to configure all of the voice-related scenarios.
In VoIP, click the Advanced button, and then provide values for the PhoneAreaCode and LocationProfile (dial plan) fields. You must also specify a value for Load Level. If Load Level for VoIP and UC/PSTN Gateway is Enabled, then a public switched telephone network (PSTN) to unified communications (UC) configuration file will always be generated that will simulate external calls.
In UC/PSTN Gateway, specify a value for Load Level. If you select a load level other than Disabled, you must supply a value for PSTN Area Code by clicking the Add button under Mediation Server and PSTN. Verify that you have a voice route configured for that area code.
Note
You can use either the Lync Server Control Panel or the Lync Server Management Shell to verify voice route configuration.
In Conferencing Attendant, specify a value for Load Level. Selecting a load level (other than Disabled) will enable the Telephone Number field. Enter the number of the Auto Attendant you want to use. Also, click the Advanced button, and then specify a value for the LocationProfile field.
In Call Parking Service, specify the appropriate value for Load Level.
In Mediation Server and PSTN, for each Mediation Server you want to use, you need a separate PSTN simulator. After you have determined which client you are going to use as the simulator, you need to configure your Mediation Server to route calls to that computer on the PSTN Simulator port you configured. Click Add to configure the value for the Mediation Server.
Note
Each of the scenarios has an Advanced button located next to it. These buttons allow access to values specific to each scenario that will change the behavior of the Lync Server 2010 Stress and Performance Tool (LyncPerfTool) and allow for customization. For each scenario on the Voice Scenarios tab, if the value of Load Level is Custom, then the conversation rate will be calculated using the corresponding field in the Advanced dialog box. The field name differs depending on the scenario, but the field description will state “NOTE: This number will only be used if Custom is selected from the drop down menu.”
Reach
The Reach tab of the Lync Server 2010 Load Configuration Tool is shown in the following figure.
The Reach tab of the Lync Server 2010 Load Configuration Tool
Use the Reach tab to configure all of the reach-related scenarios.
Click the Advanced button next to General Reach Settings. Set the field ReachTargetServerUrl to the Director pool virtual IP (VIP) or the Front End pool VIP.
In Application Sharing, Data Collaboration, and IM, select the appropriate value for Load Level.
Note
Each of the scenarios has an Advanced button located next to it. These buttons allow access to values specific to each scenario that will change the behavior of the Lync Server 2010 Stress and Performance Tool (LyncPerfTool) and allow for customization. For each of the Reach scenarios, if the Load Level is Custom, then the value specified in ConversationsPerHour field is used instead of the default.
Summary
The Summary tab of the Lync Server 2010 Load Configuration Tool is shown in the following figure.
The Summary tab of the Lync Server 2010 Load Configuration Tool
The Summary tab indicates which users to use for each of the scenarios. It is possible to manually configure user number ranges by selecting the Enable Custom User Range Generation check box, and then double-clicking the scenario in the table that has the User Range you want to customize.
Click Generate Files. You will receive a dialog box similar to the following figure when your files have been successfully created.
Successful generation of load configuration files