Running tests with multiple remote desktop sessions

TestArchitect provides you the capability to execute tests with multiple remote desktop sessions.

Applies to TestArchitect 8.4 Update 3 and higher.


Supported platforms:

Support Deputy mode

  1. Open remote desktop sessions with different Windows accounts on the remote computer by using the Remote Desktop Connection dialog.

  2. On each of the remote sessions, start TestArchitect Controller and assign a unique port number to the Controller

    Although you can start TestArchitect Controller on multiple sessions, you can launch TestArchitect Client on only one session.

    There are three approaches to port number assignment.

    • From a command line interface: Utilize the -port argument in the command that starts TestArchitect Controller.

    • Using the environment variable: Create the CONTROLLER_PORT environment variable which holds a port number. When you start TestArchitect Controller on a session without assigning a specific port, TestArchitect automatically assigns CONTROLLER_PORT to the port of the controller.

      In case the port number stored in CONTROLLER_PORT is occupied, the port number assigned to the controller will automatically be increased by 1 each time until an available port is detected.

    • Get TestArchitect to choose a port number: you do not create the CONTROLLER_PORT environment variable. When you start TestArchitect Controller on a session without assigning a specific port, TestArchitect will automatically choose an available port number for the controller.

  3. Launch the TestArchitect Client on the local computer.

  4. In the TestArchitect tree explorer, select the preferred test module/suite and press Ctrl + F9 to invoke the Execute Test dialog box.

  5. Launch the Select Controller/Device dialog box and add the controllers of the remote sessions. Next, select the checkboxes for these controllers. (Learn more)

  6. Execute the test.

    During the test run,

    • Keep the remote computer unlocked as long as you perform GUI testing on any sessions.
    • Do not minimize any remote session window from the local computer.
    • You are unable to run in the debugging mode on more than one remote desktop sessions. (Learn more)
  7. Repeat steps 4 through 6 if you want to execute more tests on other remote sessions.

The Session Name and Session ID fields will be shown in the General information section of the test results.

Copyright © 2023 LogiGear Corporation. All rights reserved. LogiGear is a registered trademark, and Action Based Testing and TestArchitect are trademarks of LogiGear Corporation. All other trademarks contained herein are the property of their respective owners.

LogiGear Corporation

1730 S. Amphlett Blvd. Suite 200, San Mateo, CA 94402

Tel: +1(800) 322-0333