Set up a LeanFT grid node

To run tests on applications in different environments or distribute your application testing among multiple machines, set each machine up as a LeanFT grid node.


What is a LeanFT grid node?

A LeanFT grid node is a machine connected to a LeanFT grid, providing an environment for running LeanFT test operations.

When running a test using a grid, the test requests an environment that provides certain capabilities. The grid finds a node machine with the requested capabilities, and uses that node for the test's LeanFT operations. For details, see LeanFT Grid.

To satisfy this role, a node must have the following:

  • The application you are testing
  • The LeanFT runtime engine, running as a node.
  • Any capabilities required for your test to run.
  • A connection to the grid, configured in the node's runtime engine settings. For details, see Grid Connection Settings.

What are capabilities?

Capabilities describe the environment on your node machine, as related to testing applications. These can be conditions that the test needs in order to run, as well as environment conditions in which you want to test your application. Capabilities can include operating systems, browser types and versions, memory requirements, available frameworks, and so on.

When running a test using a grid, the test includes a description of the environment to use. The description consists of capabilities, described in name-value pairs. The grid checks the capabilities provided by its nodes and selects one that matches the tests requirements.

A node's capabilities are made up of:

  • Operating system type and version, which LeanFT detects automatically.

  • Available browsers and versions, configured in the node settings. For details, see Add-ins.

  • The add-ins loaded on the node, configured in the node settings. For details, see Add-ins.

  • Additional capabilities provided by the node, that you describe in name-value pairs similar to the ones in a test's environment description. Describe these capabilities in the node settings. For details, see Custom Capabilities.

  • The node's name.

Back to top

Set up a LeanFT grid node machine

On each node machine, perform the following steps:

  1. Prepare your testing environment and the application you want to test.

  2. Run the LeanFT installation and install the LeanFT runtime engine only. For details, see LeanFT installation guide.

  3. Run the LeanFT run-time engine as a node.


    LeanFT > LeanFT Grid > LeanFT Runtime (Grid Node)

    Start Menu

    Linux Run ./leanft start --role=node

    <LeanFT installation>/bin
    (by default, /opt/leanft/bin)


    Run ./leanft start --role=node

    LeanFT installation directory
    (by default, /Applications/LeanFT)

    Note: At this point it does not matter if your LeanFT grid is running or not. The nodes connect to the grid when they and it are up and running.

  4. Configure the node's runtime engine settings. See Configure a LeanFT node's runtime engine settings, below.

  5. If the grid's connection mode is remote secured, make sure you have a trusted copy of the grid's encryption certificate set up on the node machine.

  6. Optional setup steps:

    If you plan to... need to How?
    Test Web-based applications

    Make sure the Functional Testing Agent extension is enabled in your browser.

    For details, see Set up web browsers and controls.

    Test desktop applications Configure your node to enable LeanFT tests to launch desktop applications.

    For details, see Run desktop applications using LeanFT SDK.

Back to top

Configure a LeanFT node's runtime engine settings

This section explains how to configure the connection to the grid machine, the capabilities provided by this node, the technology add-ins to load and more.

  1. Prerequisite: Run the LeanFT run-time engine as a node.
  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 needed.

  4. Modify the Object Identification settings as needed.

    See Customize how to identify objects

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

Back to top

See also: