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

In this topic:

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

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

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

## 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-in settings.

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

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

Example

You have two nodes, set up as follows:

Capabilities | Node A | Node B
--- | --- | ---
OS | Windows | Linux
Java | 8 | 7
Browser | Internet Explorer 11 Firefox | Chrome 67.0.3 Firefox

The grid handles the following test runs:

Test's environment description | Node used by grid
--- | ---
Windows OS and Internet Explorer | A
Linux machine with Java 7 | B
Firefox browser (no other capabilities specified) | A or B, depending on availability

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.

   If you set up multiple Chrome or Firefox versions, install the LeanFT extension on each browser, as described in Set up web browsers and controls.

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

   Windows | LeanFT > LeanFT Grid > LeanFT Runtime (Grid Node) | Start Menu
   Linux | Run `./leanft start --role=node` | <LeanFT installation>/bin (by default, /opt/leanft/bin)
   Mac | 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... | ...you 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

Configure the connection to the grid machine, the capabilities provided by this node, the technology add-ins to load and more. For details, see Configure a LeanFT node's runtime engine settings.

Back to top

See also:

- LeanFT Grid
- Set up a LeanFT grid machine
- Configure a LeanFT node's runtime engine settings
- Customize test settings

https://admhelp.microfocus.com LeanFT 8942
Tips to improve your search results...TOC Lean Functional Testing Help Center LeanFT Help Center 14.50 - 14.53 All View Local Help Center View Online Help Center back Go back in browser history forward Go forward in browser history Remove search highlights next topic Go to next topic previous topic Go to previous topic Print the current topic Version:(Undefined variable: _rscC_Basic_Variables.FloatingTocShow)