Customize LeanFT runtime engine settings

The LeanFT runtime engine is used for the Object Identification Center, the Application Model editor, and for running LeanFT tests.

For details on customizing these settings when using LeanFT in a grid configuration, see Set up a LeanFT grid machine or Configure a LeanFT node's runtime engine settings.


You can configure LeanFT runtime engine settings according to your needs: decide which technology add-ins to load, change the default engine port, configure the connection to Mobile Center and StormRunner Functional etc.

Note: If you are running LeanFT tests on remote computers, you must also set the relevant security connection options. These are set in an XML file as described in Run tests remotely.

To customize the engine settings

  1. Make sure the LeanFT runtime engine is running. See Start/Stop the runtime engine.
  2. Open the LeanFT settings dialog box:

    Right-click the LeanFT 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/leanft/Tools/settings-leanft

  3. Modify the Engine settings as described below.

  4. Modify the Object Identification settings as needed.

    See Customize how to identify objects.

  5. Modify the Lab settings described below if you want to use Mobile Center or StormRunner Functional for your tests.

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

Back to top

Engine settings

Configure the following options in the Engine tab:


By default, LeanFT loads the add-ins for all supported technologies. However, loading add-ins that you don't need can slow performance, or in some cases cause conflicts with object identification, so you should load only the add-ins needed for the technologies in your application.

The add-ins you select affect the technologies supported in the Object Identification Center as well as for tests that you run on the computer.

Note: For LeanFT to recognize Oracle application objects, you must select both the Oracle Add-in and the Web Add-in. Oracle is supported in LeanFT versions 14.52 or later.

Engine Connection

Configure the connection port and license options for the LeanFT runtime engine:

Default port

Default = 5095.

If another application is listening on port 5095, change this value to an available port.

This change applies only to the runtime engine settings. If you change the value here, make sure your tests are also set to use that value. For details, see Modify the port used by LeanFT.

To enable using LeanFT in a multi-session environment such as a Windows server or a Citrix server, set up ports on each client. For details, see Configure ports for using LeanFT in a multi-session environment.

Engine idle timeout

Default = 240 minutes.

When then timeout expires, the LeanFT license is released and the runtime engine closes. While the engine is running, it always consumes at least one license.

To prevent the timeout expiration, clear the Engine idle timeout check box.

Max license consumption

Default = 1.

The maximum number of concurrent licenses this runtime engine is allowed to consume. For details, see Parallel tests and license consumption.

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 LeanFT to run tests on a disconnected RDP computer

Select this check box if you are working with LeanFT on a remote desktop client and the RDP connection is disconnected. The LeanFT 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.

Usage Data Collection

Supported in LeanFT versions 14.52 and later

I want to help! Collect anonymous feature usage data. Configure whether or not to allow LeanFT to send anonymous feedback to Micro Focus about your LeanFT usage, as part of the LeanFT improvement program. The data you provide helps us understand which improvements matter most.

For details, see Help improve LeanFT.

Back to top

Lab settings

Configure the following options in the Labs tab:

Mobile Center Settings

Provide the credentials to connect to the Mobile Center server.

Server address

Your Mobile Center server IP address or host name. Format example: server IP:port. By default, the port is 8080. Check the port settings defined on your Mobile Center server.

If you are connecting to the LeanFT server through SSL, the server address must start with https. For example:

User name and Password

Your credentials for logging into the Mobile Center server.

In the User name, you can optionally specify a Mobile Center project, workspace, or both:

  • If you belong to a specific project in Mobile Center, enter your user name in the following way: username#projectID.

    For details on retrieving your project ID, see Mobile Center multi-projects.

  • If you want to limit your testing to devices and apps in a specific workspace, enter your user name in the following way: username#projectID/workspace or username/workspace.

    Specify Public workspace or the name of another workspace that you are assigned to. If you specify a workspace other than the public workspace, only the devices and apps in that workspace and in the Public workspace are available for recording, running, and device selection.

    For details on viewing the Mobile Center workspaces to which you have access and the devices and apps assigned to them, see Workspaces in the Mobile Center lab console.

The Password is encrypted automatically when you save the settings.

Click Verify to check that LeanFT can connect to the Mobile Center server.

If Mobile Center runs behind a proxy server, select Use proxy, and enter the information in Proxy Settings.

Do not validate certificate

By default, LeanFT employs Full SSL (Strict). However, you can select this option in order to ignore certificate errors.

Show remote access window when the test runs

Select to enable watching your test runs on the devices in the Mobile Center remote access window.

To improve test execution performance, clear this option to run tests silently. You can still watch the steps being performed on the device itself if it is located near you. You can also add Device.OpenViewer/CloseViewer steps to open or close the remote access window during a run.

StormRunner Functional Settings

Provide the credentials to connect to the StormRunner Functional server. For details, see Configure the connection to StormRunner Functional.

Proxy Settings

If either Mobile Center or StormRunner Functional are running behind a proxy server, then you must configure the proxy settings:

Address The IP address and the port of the proxy server.
User name

Credentials for the proxy server.

Password Credentials for the proxy server. The password is encrypted automatically when you save the settings.

Back to top

See also: