Configure a grid node's runtime engine settings

This section explains how to configure the runtime engine settings on a grid node machine.

Overview

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.

Prerequisites

Configure the settings in the Settings dialog box

  1. Open the settings dialog box:

    Right-click the 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: <Installdir>/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. Modify the AI Object Detection settings described below to customize the behavior of AI-based testing. For more details, see AI-based testing.

  5. 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.

Considerations for configuring browser versions

  • If you do not configure specific browser versions, this browser is used from the default browser installation location and the browser version is unknown. 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 on which you specified browser versions. In this case, any of the available browsers may be used by the test.

Example

You have three nodes, configured as follows:

Node Browser Type Browser Version
A

Chrome

Default
B

Chrome

Chrome

Firefox

65.0.3

66.0.3

Default
C

Internet Explorer

Firefox

Default

60.1.0

The grid handles the following test runs:

Test's browser specification Node used by grid
Firefox (no version specified)

B or C, depending on availability
Chrome version 66.0.3 B
Chrome version 67.0.3

There grid finds no relevant node, even if the default Chrome version on node A is 67.0.3.
In this situation, you would need to specifically define Chrome 67.0.3 as an available browser version on node A.
Internet Explorer (no version specified) C
Internet Explorer 11 There grid finds no relevant node, even if the default version is 11.
In this situation, you would have to define the browser version as a custom capability. For details, see Custom capabilities.

Runtime settings

Configure settings related to test runs:

Setting Description

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 OpenText Functional Testing for Developers to run tests on a disconnected RDP computer

Select this checkbox if you are working 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.

AI Object-Detection settings

The AI Object Detection tab is available if you included the AI Object-Detection Service in the installation.

Configure the following settings in the AI Object Detection tab:

General AI settings

Setting Description
Enable AI Object Detection

OpenText Functional Testing for Developers's AI Object Detection features are enabled by default. You can clear the Enable AI Object Detection setting to deactivate these features.

Changes you make in this setting take effect only after you restart OpenText Functional Testing for Developers.
Enable caching for object identification

By default, a caching mechanism is used for AI object identification during test runs, to improve performance.

You can clear this setting to deactivate the caching mechanism if you don’t find it useful in your case.

Scroll Settings

Setting Description

Enable automatic scrolling

Select this setting to enable automatic scrolling. When running a test, if an object is not displayed in the application but the web page or mobile app is scrollable, the test automatically scrolls further in search of the object.

Default: Selected.

You can customize the direction and extent of the scrolling, using the settings below.
Direction The direction in which to scroll. Default: Down.
Max scrolls

The maximum number of pages or screens to scroll. Default: 2.

Tip: You can temporarily override these global settings in a test run, by adding AI run settings steps to your test. For details, see the AIRunSettings Class in the Java and JavaScript SDK references.

AI Text Recognition Settings

OCR is used when identifying text in the application, when using text to identify a specific object, and when retrieving text from the application.

Note: AI Text Recognition does not use the ABBYY OCR engine.

Define the list of languages to identify. Add languages to the list or remove them, and drag items up or down in the list to specify priority.

Supported languages: Afrikaans, Arabic, Basque, Bulgarian, Catalan, Chinese, Traditional Chinese, Croatian, Czech, Danish, Deutsch, Dutch, English, Esperanto, Estonian, Finnish, French, Greek, Hebrew, Hungarian, Icelandic, Italian, Irish, Japanese, Korean, Latin, Latvian, Lithuanian, Macedonian, Maltese, Norwegian, Polish, Portuguese, Romanian, Russian, Serbian, Slovenian, Slovak, Spanish, Swedish, Turkish, Ukrainian, Welsh

Tip: You can temporarily override these global settings in a test run, by adding AI run settings steps to your test. For details, see the AIRunSettings in the Java and JavaScript SDK references.

Remote AI Object-Detection Service settings

Supported on versions 26.3 and later

You can run AI object-detection using a remote service installed on a central machine. Configure the connection to the remote service to consume its AI object-detection services.

Option Description
Use remote service

Select to use the AI Object-Detection service you installed on a remote machine.

For details on installing a remote AI Object-Detection service, see the OpenText Functional TestingHelp Center.
Remote AI server details

Enter the IP address and port number for accessing the remote AI Object-Detection service.

  • Server address: The IP address of the machine on which you installed the remote AI Object-Detection service.

    Note: If the remote machine is in a domain, you can specify a hostname instead of the IP address. If the remote machine is in a workgroup, you must use the IP address.

  • Port number: The port number you defined during the service installation. The value ranges from 0 to 65535.
Ignore Certificate Errors

Select to ignore certificate errors.

If you are using a CA certificate, you do not have to select this option.
Use Proxy Settings

Select if the remote service is reached through a proxy server.

Address. The proxy server address and port number.Example: http://proxy_address:8080.

User name and password. The proxy credentials used to connect to the remote server, if necessary.

Note: Click Verify to make sure the configuration is correct.

The connection with the remote AI Object-Detection service is set up as soon as you save your changes in this dialog box.

Grid Connection Settings

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

Options Description
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 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).
Passphrase

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
Java

8
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.

See also