Set up a LeanFT grid machine

A LeanFT grid machine matches grid nodes to tests, based on the node's capabilities and the test's environment description. This topic explains how to set up a LeanFT grid machine.

For more details, see LeanFT Grid.

Set up a LeanFT grid machine

To set up a LeanFT grid machine, perform the following steps:

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

  2. Install a concurrent license on the grid machine. For details, see Install LeanFT license on Windows and Install LeanFT license on Linux/Mac.

    If you use a Seat license, the grid can handle up to four LeanFT operations simultaneously.

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


    LeanFT > LeanFT Grid > LeanFT Runtime (Grid)

    Start Menu

    Linux Run ./leanft start --role=grid

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


    Run ./leanft start --role=grid

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

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

  4. Configure the grid's runtime engine settings. See Configure the grid's runtime engine settings.

Back to top

Configure the grid's runtime engine settings

This section explains how to configure the connections to and from the grid:

  • Define the way nodes connect to this grid machine.
  • Change the default engine port if needed.
  • Configure LeanFT's connection to Mobile Center and StormRunner Functional if you need to use them to run tests.

To configure the engine settings

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

    Add-ins for Mobile

    When testing on mobile devices, LeanFT always loads the Mobile add-in.

    Depending on the applications you plan to test, specify whether to also load the Web or SAPUI5 add-ins.

    Engine Connection

    Engine 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, which is used to run your test steps. 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 multiple LeanFT sessions, set up ports on each client. For details, see Configure ports for multiple LeanFT sessions.

    Grid management port. Default = 8080.

    This is the port used to access the LeanFT Grid Management console. For details, see View grid management data. Modify this number if you need it to be available for another application.

    License idle timeout. Default = 30 minutes.

    When the timeout expires, the LeanFT license is released but the runtime engine remains active and ready to receive requests.

    Max license consumption. Default = 5.

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

    Node Connection Settings

    Connection mode. Specify whether connections to this grid should be Remote secured (recommended) or Remote unsecured. This setting affects nodes connecting to this grid, as well as the machines running tests that use this grid.

    If you select Remote secured, specify the certificate .pfx file and the protocol to use for authenticating connections to this grid.

    Important: Make sure you have a trusted copy of the grid's encryption certificate set up on your grid nodes and on the machines running the tests.

    Passphrase. The passphrase for the node to use when connecting to the grid (case-sensitive).

    When configuring the Passphrase in the node's runtime engine settings, enter the same string. For details, see Grid Connection Settings.

    Node-wait timeout. Default = 300 seconds.

    The maximum number of seconds to wait for one of the locks on a relevant node to be released, if all nodes are currently in use and reached their lock maximum.

  4. Modify the Lab settings if you want to use Mobile Center or StormRunner Functional for your tests:

    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.

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

    You don't need to restart any nodes that were connected to this grid. The LeanFT nodes will reconnect after the grid restarts.

Back to top

See also: