Stress and Performance Tool: Configure Lync Server 2010 for Scenarios
Topic Last Modified: 2011-03-28
In order to run the Lync Server 2010 Stress and Performance Tool (LyncPerfTool), the Lync Server 2010 topology must first be configured for the scenarios. If Lync Server 2010 is not configured or is configured improperly, load simulation will fail in most cases. With the Lync Server 2010 Stress and Performance Tool package we have provided example Lync Server Windows PowerShell scripts and basic resource files that can be used as a starting point for configuring Lync Server 2010. This section describes the Windows PowerShell examples provided. Note that it is not the goal of this section or document to describe how to configure Lync Server in general. For details about working with Windows PowerShell in Lync Server, see the Lync Server Management Shell documentation at https://go.microsoft.com/fwlink/?linkid=193460.
About Running Lync Server Management Shell Scripts
We have provided example scripts that may be used in preparation for running load simulation. Because the scripts are intended for load simulation, they are simple, permissive and as such may not be appropriate for production. All scripts are examples and must be modified to reflect your topology.
Warning
Take care in reviewing and understanding the examples provided. Some scripts will overwrite any existing settings in the topology.
Note
For details about using Windows PowerShell and the Lync Server Management Shell, see the Lync Server 2010 Windows PowerShell Blog at https://go.microsoft.com/fwlink/?LinkId=203150.
Stress and Performance Tool Client Version Monikers
You may need to enable the following client versions depending on your Client Version Check policy if you have changed the settings from the default values. For details, see “Client Version Check” at https://go.microsoft.com/fwlink/?LinkId=212623. LyncPerfTool uses the following Client Versions when communicating with Lync Server:
OCSStress-OC/4.0.7000.0
OCPHONE/1.0.522
Provisioning the Topology to Run Load
Depending on your existing settings and the way you plan on configuring Lync Server 2010, you may need to set the Windows PowerShell execution policy to Unrestricted. To check your execution policy settings, run the following command from the Lync Server Management Shell:
Get-ExecutionPolicyIf this command does not return the value Unrestricted, run this command:
Set-ExecutionPolicy UnrestrictedYou will need to gather information and have familiarity with the following:
The Lync Server 2010 topology (for example, computer names, service instances, site names, and policies).
Some of the users that were created to be assigned to groups, such as Response Group hunt groups (for example, SIP URIs).
You will need to know the Service ID instances for Lync Server Call Park service, Conferencing Attendant application, and Lync Server Response Group service if you will be running load on them. You can find the service instance by running the following command:
Get-CsService | Where-Object { $_.ServiceId.ToString() -like "*Application*"}
To run the script from the command line you may use:
powershell.exe -file <path to the edit file>
Typically after one of the scripts in this package runs, all the logs from the script will be stored on the %SystemDrive% in the format %SystemDrive%\<scriptname>$h$m$s.txt. For example, running ArchivingPolicy.ps1 at 12:15 P.M. will generate a log file such as C:\ArchivingPolicy121500.txt.
Finally, note that while we have provided examples to configure the server, you are responsible for modifying or deleting the configuration after you are done running the load.
Configuring the Simple URL Policy
See the example script SimpleUrlPolicy.ps1. Note that the certificates you use for authenticating Web Services through HTTPS depend on the URLs you specify in this policy. For details, see the Lync Server 2010 documentation and the cmdlet help for Web Server and Services Cmdlets.
Configuring the Archiving Policy
See the example script ArchivingPolicy.ps1. You need to use this script only if an Archiving Server is deployed in your topology. For details, see the Lync Server 2010 documentation and the cmdlet help for Archiving and Monitoring Cmdlets.
Configuring the Conferencing Policy
See the example script MeetingPolicy.ps1. For details, see the Lync Server 2010 documentation and the cmdlet help for Web Conferencing Cmdlets.
Configuring the Contacts Policy
See the example ContactsPolicy.ps1. For details, see the Lync Server 2010 documentation and the cmdlet help for IM and Presence Cmdlets.
Configuring the Federation Policy
See the example FederationPolicy.ps1. For details, see the Lync Server 2010 documentation and the cmdlet help for Edge Server Cmdlets and Federation and External Access Cmdlets.
Configuring the Call Admission Control Policy
See the example BandwidthPolicy.ps1. For details, see the Lync Server 2010 documentation Overview of Call Admission Control and the cmdlet help for Call Admission Control Cmdlets.
Configuring the Voice Routing Rules
See the example RoutingRules.ps1. When configuring the voice routing rules, you should take note of the Phone Context/Location Profile/SimpleName and Internal/External Area Codes so that you can specify them when creating users and during LyncPerfTool configuration (specifically for Conferencing Auto Attendant, PSTN-UC and UC-PSTN). The value of these fields should be the same as the value for the SimpleName parameter in the call to New-CsDialPlan in the RoutingRules.ps1 example. For example, the LocationProfile value in the following figure should match the value of the SimpleName parameter.
LocationProfile value in a voice scenario
.jpg "Advanced configuration location profile")
For details, see the Lync Server 2010 documentation and the cmdlet help for Enterprise Voice Cmdlets.
Configuring Conferencing Attendant application
See the example ConferenceAutoAttendantConfiguration.ps1. Take note of the ConferencingAutoAttendant phone number to input it into the LyncPerf Tool configuration. For details, see the Lync Server 2010 documentation and the cmdlet help for Web Conferencing Cmdlets and Dial-In Conferencing Cmdlets.
Configuring Lync Server Call Park service
See the example CallParkConfiguration.ps1. For details, see the Lync Server 2010 documentation and the cmdlet help for Call Park Application Cmdlets.
Configuring Emergency Calls
Perform the following steps to configure stress and performance testing for emergency calls.
Set up a voice route for emergency calls. See the RoutingRules.ps1 script under the comment “Route E911 to PSTN” for an example of setting up this voice route.
Warning
The example command in RoutingRules.ps1 has a number pattern that includes the number 119 rather than 911. You should avoid using 911 (or your actual local emergency number) to prevent accidental calls to your local emergency operators during load testing. This configuration is for simulation purposes only.
Configure addresses by filling in the values on the LIS tab in the StressConfig tool, as shown in the following figure.
LIS tab of the Lync Server User Creation tool
.jpg "Create Location Information service configuration")
Click Create LIS Config.
CSV files for ports, subnets, switches, and wireless access points (WAPs), and an XML file for Lync Server 2010 Stress and Performance Tool are generated. The CSV files are to be used as inputs when configuring Location Information service (LIS) with the LisConfiguration.ps1 script. Move the Locations0.xml file to the same folder as the Lync Server 2010 Stress and Performance Tool executable (LyncPerfTool.exe), which will run location profile (dial plan) scenarios.
Creating, Enabling, Configuring, and Disabling Users
You should create all your users before running the following scripts. Follow the instructions in Stress and Performance Tool: Create Users and Contacts to create users. For details, see the Lync Server 2010 cmdlet documentation for Get-CsUser, Set-CsUser, and Disable-CsUser.
Configuring Response Group application
See the example ResponseGroupConfiguration.ps1. For details, see the Lync Server 2010 documentation and the cmdlet help for Response Group Application Cmdlets.
To review the Response Group application configuration, see https://<poolfqdn>.com/RgsConfig/, as shown in the following figure.
Response Group Configuration Tool
.jpg "Response Group configuration")