Run a test using UFT One installed on a remote computer

Relevant for: GUI tests and components and API testing

This task describes how to run UFT One tests using UFT One installed on a remote computer.

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

Running UFT One and UFT One tests in a remote session

You can run tests using UFT One installed on a remote Windows machine in the following ways:

Manually log in to the remote machine

Run UFT One and UFT One tests from a remote computer so that you can use your own local computer for other tasks.

You can then close the remote session or allow the remote computer's screen to lock. The test continues to run.

No manual log in to the machine

External tools connect to the UFT One computer remotely, start UFT One, and run tests, without any manual intervention.

This is helpful when running tests via tools such as ALM, Jenkins, or scheduled programs using the UFT One Automation Object Model (AOM).

Configure UFT One for remote connections

To enable you to run or continue to run tests using UFT One installed on a locked, logged off, or disconnected remote computer, do the following:

On the remote computer, open UFT One. You can access it directly on the computer where it is installed, or connect to that computer using a remote desktop client, such as Windows Remote Desktop Connection.
In the Options dialog box, open the Run Sessions pane (Tools > Options > General tab > Run Sessions node).
Select Enable testing on locked, logged off, or disconnected remote computers and save your changes.

Caution: This option also enables the ALM Lab Service to run tests on this UFT One computer. However, make sure ALM Lab Service's installation does not include the Auto Login module. For details, see Known issues - running test in ALM.
Enter the credentials to use for the remote session. These may be the same credentials you use to access the remote computer.

Scroll down and click Check Connection to verify that it works.

Note: If you enter credentials that are different from the credentials you used to log in to the UFT One computer, see Known issues.
Select a resolution to use on the remote computer after the session is disconnected.

This is only available in UFT One version 2021 R1 and later. For how to set a resolution on the remote computer in UFT One version 2021 and earlier, see Setting the resolution on the UFT One computer.
Select Use polling to detect a disconnected session when your tests fail to run on a disconnected session.

This option is available only in UFT One versions 2022 and later. It instructs UFT One to periodically poll the remote session instead of waiting for a disconnect event notification.

Set the polling frequency (default = 10 seconds). The value ranges from 10 to 60 seconds.

Tip: This option may be helpful when working with a remote connection using Citrix or Virtual Desktop Infrastructure (VDI).

UFT One uses the credentials you entered in the following situations:

You were connected and running tests when the screen locked or you closed the session.
When you disconnect, log off, or restart the UFT One machine, a Windows session is automatically started, using these credentials to log in. This enables other programs to run UFT One remotely without anyone manually logging in to the machine.

Run UFT One and UFT One tests in a remote session you open manually

To run tests on UFT One over a remote connection that you open manually:

Open a session on the remote computer using a remote desktop client, such as Windows Remote Desktop Connection.
On the remote computer, open UFT One and make sure UFT One is configured to Enable testing on locked, logged off, or disconnected remote computers (Tools > Options > General tab > Run Sessions node).
Run your test.

While running tests over a remote connection that you opened manually, you can allow the screen to lock or close your remote session. However, do not log out of the remote computer or close UFT One.

Automation using the Windows Task Scheduler

Once you configure UFT One to run over remote connections, you can automate test runs on the remote computer by using the Windows Task Scheduler. The Windows Task Scheduler task can run without anyone manually logged in to the remote machine. The task uses the Windows session that started using the credentials you defined in the UFT One configuration. It also starts UFT One and runs the tests.

Setting the resolution on the UFT One computer

If your test requires a specific resolution to be set on the computer, do not set the resolution during a Remote Desktop Connection and then disconnect. If you do this, the resolution settings are not used in the subsequent session.

Do one of the following instead:

UFT One versions 2021 R1 and later:

When configuring UFT One for remote connections, select the resolution to use after your remote session disconnects. See Configure UFT One for remote connections.

UFT One versions 2021 and earlier:

Configure UFT One for remote connections, set the computer's resolution using a Remote Desktop Connection, and restart the computer before disconnecting.
Log in directly to the UFT One computer and configure the resolution without using a remote connection.

Prerequisites for RDP 6.0 or later

If you are using an RDP client version 6.0 or later and want to run UFT One 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

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.

Set the data for this value to 2.
If you are already running a remote session, restart the session for this setting to take effect.