Connect to a terminal session

This task describes how to connect to an existing terminal session.

To learn about terminal sessions, see Terminal sessions overview.


  • You can enable terminal sessions when configuring performance tests with manual load generator distribution only.

  • The Terminal Services Manager does not support terminal sessions over a firewall.

  1. Prerequisites

  2. Run the Performance Center agent as a process

    1. On the load generator machine, run <Performance Center Host installation>\launch_service\bin\Magentconfig.exe. The Agent Runtime Settings dialog box opens.

    2. Select Manual log in to this machine.

      Note: You must run the Performance Center agent as a process for each terminal session that you are running.

  3. Configure the Performance Center agent on the load generator

    1. Select Start > All Programs > Micro Focus > Performance Center Host > Advanced Settings > Performance Center Agent Configuration. The Agent Configuration dialog box opens.

    2. Select Enable Terminal Services and click OK.

    3. When prompted to restart the agent, click OK.

  4. Add the load generator to the system

    Use the New Host dialog box to add the load generator to the system. For details, see Add a host.

  5. Launch a terminal session from the Controller

    Note: You must open a terminal session for each terminal that you want to run Vusers on during the performance test.

    1. Select Start > All Programs > Accessories > Communication > Remote Desktop Connection, or select Start > Run and run the mstsc command. The Remote Desktop Connection dialog box opens.

    2. Click Options.

    3. In the General tab, enter the name or IP address of a terminal server, or select a terminal server from the list of available servers.

    4. Enter you user name, password, and domain name (if required) for login onto the terminal server.

    5. Click Connect to open a Terminal Client window.

  6. Configure the terminal session

    You configure the terminal session from the Load Generator Management dialog box.

    1. From the Performance Center navigation toolbar, click and selectTest Management (under Testing).
    2. Select a performance test in the test management tree, and click Edit Test.
    3. In the Performance Test Designer window, click Groups & Workload.

    4. On the Groups pane toolbar, click LG Management, and select the load generators on which you want to enable terminal sessions (specific or automatch types only).

    5. Select Enable Terminal Services, enter the number of terminals to be opened on the selected load generators, and set the maximum number of Vusers to run in a terminal session.


      • The number of terminal services you can use depends on the Microsoft license for Remote Desktop Services.

      • The maximum number of Vusers depends on the Vuser type used in the script. For GUI Vusers, the maximum is one Vuser for each terminal session.

    6. Select Create new session, and specify the credentials required for automatic login. If you are using a custom user account, make sure you followRun terminal sessions with custom user account.

      You can also select the color depth of the session (15, 16, 24, or 32-bit level).

      Click OK to save your changes.


      • The settings for virtual load generator or actual load generator will take effect for every group that uses that load generator.

      • During runtime, you can set or change terminal services settings when the load generator is non-operational from the Terminal Settings dialog box. For details, see Terminal Services dialog box.

Back to top