Run a GUI test with a disconnected or locked remote computer

Relevant for: GUI tests only

This task describes how to continue a GUI test run even after disconnecting from a remote computer, or if the remote computer's screen is locked.

This frees up your local computer for other tasks, allows you to close your local computer, or leave the screen in the remote session to lock.

Note: This feature is not supported in the Microsoft Windows® XP environment or the Hyper-V virtualization server.

Run UFT and UFT tests in a remote session

Run UFT and UFT tests from a remote computer so that you can use your own local computer for other tasks, close the remote session, or allow the remote computer's screen to lock.

Run UFT and UFT tests in a remote session

  1. Open a session on the remote computer using a remote desktop client, such as Windows Remote Desktop Connection.

  2. On the remote computer, open UFT and configure the remote testing options:

    1. In the Options dialog box, open the Run Sessions pane (Tools > Options > General tab > Run Sessions node).

    2. Select Enable continued testing on locked/disconnected remote computers.

    3. Enter the credentials used to access the remote session. Scroll down and click Check Connection to verify that it works.

      UFT will use these credentials in case the screen locks or you close the session. These might be the same credentials you use to access the remote computer.

  3. Run your test.

    Caution: While allowing the screen to lock or closing your remote session is supported, do not actually log out of the remote computer or close UFT.

    You must remain logged in, and UFT must continue to run in order for your test run to complete.

If the remote computer is restarted, restart UFT as well.

Back to top

Automation using the Windows Task Scheduler

If you are automating the test run using the Windows Task Scheduler on the remote computer, ensure that the task is run only when you are logged in to the computer.

For example, in the Windows Task Schedule General tab, select Run only when user is logged on.

Back to top

Prerequisites for RDP 6.0 or later

If you are using an RDP client version 6.0 or later and want to run UFT in a minimized RDP session, you must first update a registry value on your local computer (the machine running the Remote Desktop client).

Update the registry key value

  1. Open the Registry Editor and access the RemoteDesktop_SuppressWhenMinimized registry key in one of the following locations:

    32-bit operating systems <HKEY_CURRENT_USER or HKEY_LOCAL_MACHINE>\Software\Microsoft\Terminal Server Client
    64-bit operating systems <HKEY_CURRENT_USER>\Software\Microsoft\Terminal Server Client

    If the key does not yet exist, create it, and give it a DWORD value type.

  2. Set the data for this value to 2.

  3. If you are already running a remote session, restart the session for this setting to take effect.

Back to top

See also: