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:

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 aIso 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 might 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 different from the ones you used to log in to the UFT One computer, see known issues.

UFT One uses these credentials 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 for remote connections, you can automate test runs using the Windows Task Scheduler on the remote computer. The Windows Task Scheduler task can run even when no one is manually logged in to the remote machine. The task uses the Windows session that was started using the credentials you defined in the UFT One configuration, 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, keep the following in mind.

If you set a specific resolution using a Remote Desktop Connection and then disconnect, the resolution settings are not used in subsequent session.

Do one of the following instead:

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.