Configure a grid node's runtime engine settings

This section explains how to configure the UFT Developer runtime engine settings on UFT Developer node machine.


You can configure various settings for each node. For example, you can configure the node's connection to the grid machine, the capabilities provided by this node, and the technology add-ins to load.


Configure the settings in the UFT Developer settings dialog box

  1. Open the settings dialog box:

    Right-click the UFT Developer runtime engine icon in the task bar and select Settings.

    Note: On Linux machines, if the icon is not available in the task bar, run the following command to open the dialog box: /opt/uftdeveloper/Tools/settings-leanft

  2. Modify the Engine settings as needed.

    The areas of this tab are described in the sections below.

  3. Modify the Object Identification settings as needed.

    See Customize how to identify objects

  4. When you save your changes, the runtime engine automatically closes and restarts with your new settings loaded.

Add-in settings

Select the add-ins needed for the technologies in the application you are testing. Leaving unnecessary add-ins selected can slow performance, or in some cases, cause conflicts with object identification.

Note: To recognize Oracle application objects, you must select both the Oracle Add-in and the Web Add-in.

If the Web add-in is selected, select the browsers available for testing on this node.

Multiple Chrome and Firefox versions

For Chrome and Firefox, you can specify multiple available browser versions. Click the Edit button for the relevant browser to enter the available versions.

For each version, specify the browser's installation location, and optionally, the browser's Profile:

  • FireFox: Provide the name of the profile that you configured when installing the browser.

  • Chrome: Provide the path to the user data directory that you configured when installing the browser.


PhantomJS does not have a default installation location. You must specify the browser version and where it is installed.

Considerations for configuring browser versions

  • If you do not configure specific browser versions, UFT Developer uses this browser from the default browser installation location and does not know the browser version. The grid does not use this node for tests that request a specific browser version.
  • If you specify browser versions and want the default version to be used for testing as well, specifically list that version as one of the available ones.
  • If a tests requests a specific browser type and does not specify a version, the grid uses either nodes with Default browser version selected, or nodes where you specified browser versions. In this case, any of the available browsers may be used by the test.

Runtime settings

Configure options related to test runs:

Object synchronization timeout.

Default = 20 seconds.

This setting controls the maximum time (in seconds) that the runtime engine waits for an object to load before trying to run a step on it. When debugging tests, you may want to shorten this timeout.

Allow UFT Developer to run tests on a disconnected RDP computer

Select this check box if you are working with UFT Developer on a remote desktop client and the RDP connection is disconnected. The runtime engine supplies the credentials required to keep the remote machine active.

Enter your credentials and click Verify. The password you enter is stored in an encrypted format that is relevant only on the current computer.

Grid Connection Settings

Configure options related to the node's connection to the grid, and the grid's use of this node:

Node name

Provide a unique name for the grid to use for this node. By default, a name is suggested based on the machine's computer name. Modify this name if it is not unique among all nodes that connect to the same grid.

Note: In a test run's environment description, you can list the node's name as a capability to select a specific node. Use name as the capability name and the configured node name as the value.

Grid address

Enter the data needed for the node to connect to the UFT Developer grid machine.

Use the following format: wss|ws://server-address:port number.

  • wss or ws, depending on the grid's Connection mode. wss for remote secured, ws for remote unsecured.
  • server-address. The address of the grid machine.
  • port number. The Engine port number defined by the grid (default=5095).

The grid's Passphrase (case-sensitive).

Click Verify to test the connection. The Passphrase you enter is stored in an encrypted format that is relevant only on the current computer.

Maximum locks

(Default = 4)

The maximum number of simultaneous times the grid can choose this node for running a test. For details, see Lock node machines.

To obtain the information required for the settings in this section, see the Node Connection Settings in the grid's runtime engine settings. For details, see Configure the grid's runtime engine settings.

Custom capabilities

Create a list describing the additional test environment capabilities this node provides. For each capability, provide a name and value (not case-sensitive).

For example:

Name Value


DiskCapacity 1T

Do not specify the operating system type or version, which are detected automatically, or the web browser versions, which you specified in the Add-ins section.

Back to top

See also: