Micro Focus Expert
Micro Focus Expert

<LFT Support Tip> How to configure LeanFT Runtime Engine to run a test remotely

The instructions below describe how to set up your environment to run tests in a configuration where your test is located on a different computer than the AUT.

Note: In addition to these instructions, before you set up remote run configurations, make sure to review your network topology and read the LeanFT Security Reference, available in your <LeanFT>\help folder or from the HPE Self-Solve Knowledge Base (requires an HPE Passport).

There are four main steps in configuring LFT runtime engine to run a test remotely:

1. Prepare your test for a remote run

In this step open the test settings file you plan to use with your test. For example, the App.config file of your Visual Studio project or the leanft.properties file in your Eclipse/IntelliJ IDEA project. Uncomment and edit the connection address from ws://localhost:<port> to the remote host for example : wss://<RemoteServerAddress>:<port> 

2. Set up the test computer

Deploy all required testing files for example for 

for C#:

Deploy the compiled configuration file (*.config.dll) and all the LeanFT dlls found in your testing project output folder (for example bin\Debug) together with your testing project dll

for Java:

Copy the com.hp.lft.report-xx.xx.x.jar, com.hp.lft.sdk-xx.xx.x-standalone.jar, and com.hp.lft.unittesting-xx.xx.x.jar from <LeanFT installation>\SDK\Java to the folder where your test .jar files are located.

3. Set up the remote computer

This is the computer where where the AUT is installed. In order to run tests remotely only the LeanFT runtime engine is required to be installed in the remote machine.

  1. If not already installed, run the LeanFT installation. Only the LeanFT runtime engine is required.

  1. Open or create the LeanFT runtime engine connection configuration file, <LeanFT installation folder>\lwe\lightweight\config\config.json.

  2. Copy the following code into the file.

    'connection-mode': "remote-secured",
    'certificatePath': "c:/path/to/your/pfxFile.pfx",
    'encryptionProtocol': "tls"

4. Before beginning the run

  1. Manually launch the runtime engine from the Start menu.

  2. Make sure your AUT is available: 

    • For Web-based applications, make sure your test launches the browser and navigates to the application using BrowserFactory.Launch and Browser.Navigate steps.

    • For other applications, launch the application.

Related information and detailed steps can be found in the HPE LeanFT Help Center – Run Tests remotely topic
Labels (1)
Tags (1)
2 Replies
Contributor.. priya4 Contributor..

Re: <LFT Support Tip> How to configure LeanFT Runtime Engine to run a test remotely

Hi , 


The link provided is not opening . 

I am running leanft tests on my server using jenkins , but i am getting error "

 AUT launch is not allowed. Verify that the AUT is configured in autConfig.json.

" but i have set the config.json. 

what can i setup here ?

Micro Focus Expert
Micro Focus Expert

Re: <LFT Support Tip> How to configure LeanFT Runtime Engine to run a test remotely



In order to use the LaunchAUT functionality a white list file must be created.

Please see instructions here: https://admhelp.microfocus.com/leanft/en/14.51/HelpCenter/Content/HowTo/TestObjects_Manual.htm#mt-item-4

(Under Run desktop applications using LeanFT SDK)




The opinions expressed above are the personal opinions of the authors, not of Micro Focus. By using this site, you accept the Terms of Use and Rules of Participation. Certain versions of content ("Material") accessible here may contain branding from Hewlett-Packard Company (now HP Inc.) and Hewlett Packard Enterprise Company. As of September 1, 2017, the Material is now offered by Micro Focus, a separately owned and operated company. Any reference to the HP and Hewlett Packard Enterprise/HPE marks is historical in nature, and the HP and Hewlett Packard Enterprise/HPE marks are the property of their respective owners.