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.
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.
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.
You have two nodes, set up as follows:
|Capabilities||Node A||Node B|
Internet Explorer 11
The grid handles the following test runs:
|Test's environment description||Node used by grid|
|Windows OS and Internet Explorer||
|Linux machine with Java 7||B|
|Firefox browser (no other capabilities specified)||
A or B, depending on availability
On each node machine, perform the following steps:
Prepare your testing environment and the application you want to test.
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.
LeanFT > LeanFT Grid > LeanFT Runtime (Grid Node)
./leanft start --role=node
(by default, /opt/leanft/bin)
./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.
Configure the node's runtime engine settings. See Configure a LeanFT node's runtime engine settings, below.
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.
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.
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.