• Article

Stress and Performance Tool: Run LyncPerfTool.exe

 

Topic Last Modified: 2011-02-19

Before running the Microsoft Lync Server 2010 Stress and Performance Tool (LyncPerfTool.exe), you must create users, contacts, and scenarios. For details about using the tools to perform these actions, see Stress and Performance Tool: Create Users and Contacts and Stress and Performance Tool: Configure User Profile. Running these tools will also generate a file that will run LyncPerfStress.exe as part of a batch file with the required parameters included.

Running the Lync Server 2010 Stress and Performance Tool

If you are running Windows Server 2003 operating system and you want the client to be able to open more than 5000 TCP ports, you must also run the MaxUserPorts.reg file, which is located in the same directory as LyncPerfTool. After running this file you must restart the client computers. If you do not restart the computers, the MaxUserPort registry key will be missing and your clients may not be able to run properly because they will run out of TCP ports.

The UserProfileGenerator.exe tool creates a batch file that enables you to run LyncPerfTool.exe by registering the LyncPerfTool performance counters and loading the XML configuration file. The batch file runs one instance of LyncPerfTool.exe per configuration file. To run the batch file, do the following:

  1. Copy the folder that contains the configuration folders and files to the directory that contains LyncStressTool.exe on each client computer. (For example, if you generated the configuration files in the folder named 1.28_13.16.16, copy that folder to the folder containing LyncStressTool.exe on each client.)

  2. Navigate to the appropriately numbered client folder and run the RunClient batch script. You can simply double-click the batch file in Windows Explorer and it will run all of the configuration files for that client number. You can also run the script from the appropriate client folder by using the following syntax:

    RunClient<#>.bat < LyncPerfTool Directory>

    For example:

    RunClient0.bat C:\Program Files\Microsoft Lync Server 2010\LyncStressAndPerfTool\LyncStress

To run LyncPerfTool.exe directly, open a command prompt, and then type the following command at the command line:

LyncPerfTool.exe /file:<configXML>

For example:

LyncPerfTool.exe /file:IM_client0.xml

To have the tool display the values in the configuration file, include the /displayfile parameter on the preceding command, like this:

LyncPerfTool.exe /file:IM_client0.xml /displayfile

To end the process, press Ctrl+C.

Note

Before running LyncPerfTool directly, you must register the performance counters. Enter the following command to register performance counters:
regsvr32 /i /n /s LyncPerfToolPerf.dll

Note

Every instance of LyncPerfTool.exe you start will immediately start signing in users, usually at a rate of one user per second. The SQL Server Back End Server cannot support more than 20 users signing in concurrently. This means that in order to avoid overloading the SQL Server Back End Server, you should not start more than 20 LyncPerfTool instances at a time.