This topic provides troubleshooting for known issues when working with LeanFT.

Java applications do not run when I launch LeanFT

Problem: After I launch the LeanFT runtime engine, Java applications that usually run on my computer without any problem do not run.

Solution: Manually make the following change in the c:\Windows\mercury.ini file:

  1. Add the process name of your Java application to the end of the file using the following format: <processName>.exe=0
  2. Restart the LeanFT runtime engine.

Back to top

Fail to launch the LeanFT runtime engine from the IDE (Windows only)

Problem: When I try to enable LeanFT from my IDE, I get an error message that the LeanFT runtime engine could not be launched.

Possible cause: The wmic command used by the launcher is not recognized on your machine. This is usually because wmic is not included in your machine's path.

To verify this, do the following: 

  1. From the bin folder in your LeanFT installation folder, open a command line window.
  2. Run the command: leanft.bat start

The following error message confirms that the cause of the failure is the unrecognized wmic command.

failed to get list of processes. err: Error: Command failed: wmic process where "name='node.exe'" get ProcessId,CommandLine /Format:list
'wmic' is not recognized as an internal or external command, operable program or batch file


  1. Edit your system PATH environment variable and add to it the path of the wmic command.

    Tip: The path to add is usually %SystemRoot%\System32\Wbem;

  2. Test this fix by typing wmic in a new command line window. This should open the wmi command line interface, which prompts with: wmic:root\cli>

  3. Enable LeanFT from your IDE.

Back to top

Runtime: Test gets stuck after browser opens

Problem: When running a test, the test gets stuck after the browser opens, before navigation.

Solution: If you have a proxy set up, make sure it is not localhost or

Back to top

LeanFT plugin is not working in my IDE

Problem: I see the LeanFT menu in my IDE but its options are disabled and I can't enable it.

Solution: If your IDE is configured to use a proxy server, make sure that the proxy bypass is enabled for localhost.

Back to top

Eclipse: LeanFT plugin is not working in Eclipse

Back to top

Eclipse: "View Last Run Results" is disabled in the LeanFT menu after running a test

Problem: I get the following error in my Eclipse console output: Cannot run program "wmic": CreateProcess error=2, The system cannot find the file specified

Solution: Make sure that you have the Java JRE/JDK path configured in your PATH environment variable. The path should point to the location of java.exe.

Example: C:\Program Files (x86)\Java\jre1.8.0_91\bin

Back to top

Web is not recognized on Google Chrome

Possible cause: For LeanFT to work in Google Chrome, the Google Chrome extension needs to be installed. If LeanFT was installed before Google Chrome was installed, then the Google Chrome extension is missing in the LeanFT resources.


  1. Open Google Chrome Extensions (chrome://extensions)

  2. Drag and drop the following file onto the Extensions page:

    • Chrome v. 30 and earlier: <LeanFT installation folder>\Installations\Chrome\AgentLegacy.crx
    • Chrome v. 31 and later: <LeanFT installation folder>\Installations\Chrome\Agent.crx

    After the Functional Testing Agent extension is installed, it is displayed in the Chrome Extensions list.

  3. Restart the computer.

  4. Restart the LeanFT runtime engine.

Back to top

LeanFT is not recognizing the objects in my application

Problem: LeanFT is not recognizing the objects in my application. What should I do?


  • If you are testing Web objects, make sure you have followed the instructions for setting up your web browsers to work with LeanFT and that you open the web browser after the LeanFT runtime engine is active. For details, see Set up web browsers and controls.
  • Make sure your application was developed with a supported technology and version. For details, see the Product Availability Matrix.
  • If you need to test specific objects that are not supported out of the box, create Insight test objects to enable LeanFT to access your objects via image-based recognition. For details, see Insight image-based identification (Windows only).

Back to top

Object Identification Center (OIC) not identifying browser (design)

Problem: During design time, the OIC is not able to identify my browser.

Solution: If you have a proxy set up, make sure it is not localhost or

Back to top

Object Identification Center (OIC): Can't add objects to an application model

Problem: The OIC recognizes the objects in my application, but I cannot save objects from the OIC to an application model.

Possible cause: The Internet browser is set to use a proxy that blocks all connections. This is unnecessarily blocking local connections as well.

Solution: Configure the Internet Options to allow local connections:

  • In Local Area Network settings, select Bypass proxy server for local addresses.
  • In the advance proxy settings, enter the following addresses in the Exceptions list under Do not use proxy server for addresses beginning with: localhost;

Back to top

Object Identification Center (OIC) not recognizing objects

Back to top

Object Identification Center (OIC) in Eclipse not working after LeanFT upgrade

Problem: I just upgraded LeanFT. Now when I open the OIC in Eclipse, it flashes open but then disappears. I tried to invoke the OIC from command line, but the same thing happens. The log tells me that "C:\Program" failed to run.

Back to top

Cannot open the Object Identification Center (OIC) on Linux

Problem: The OIC is not opening (on Linux).

Possible cause: To work with the OIC on Linux, the libXss library must be installed on your machine.

Solution: Install the libXss library by running the following command: # yum install libXScrnSaver

Back to top

Application model in Visual Studio is showing a blank screen

In Visual Studio, the Application model window suddenly goes blank.


  1. Open PackagePreferences.json, located in %appdata%\LeanFT\Preferences.
  2. Locate the EnableAppModelLargeAddressSpace parameter, and change the value from false to true.

    It should look as follows:

    "EnableAppModelLargeAddressSpace": true

Back to top

Report not building after running test

Problem: The report is not being generated after the test runs

Solution: Make sure you have write permissions to the report output folder. The location may be specified in a LEANFT_REPORTS_TARGETDIR environment variable, in the test's App.config or file, or inside your test using the ReportConfiguration methods.

Back to top

Mobile: Device logs not showing up in run results report

Problem: I ran a test on a mobile device, but I don't see the device log in the HTML report.

Solution: To see device logs in the HTML report, you must include a Launch or Restart method to ensure that app opens on the device. For details, see Create mobile tests.

Back to top

ALM: "LEANFT-TEST" missing in test types

Problem: When I create a new test in my ALM test plan, I don't see LEANFT-TEST in the Type list.

Possible causes:

  • The ALM patch (12.53) that supports the LeanFT test type must be installed and configured.

  • After installing the 12.53, the test types may not have been manually updated. This is necessary for the new test types to appear in the Type list of existing projects.


  1. Close ALM.

  2. Install and configure the ALM 12.53 patch.

  3. Log into ALM >  Site Administration and update the test types (Tools> Update Test Types). All existing active ALM projects will be updated with the test type definition files that were added in the new ALM version, which include the LeanFT test type.

    For more details, see the ALM Help Center.

Back to top

ALM: Cannot run test. I get a message about Remote Agent configuration

Back to top

ALM: Cannot run a NUnit 3 test with parameters from ALM

Possible cause: You may be using the ALM data source that is meant for NUnit 2.6 tests. Instead, for NUnit 3 tests, you should be using the ALMStatic data source.

Solution: For NUnit 3 tests, use the ALMStatic data source.

For example:


public void Test(string param)




Back to top

LeanFT-BPT entities are corrupted after upgrade

Possible cause: LeanFT-BPT entities created in a previous version of ALM can become corrupted after upgrading to a version of ALM that does not support LeanFT, and then upgrading again to another version of ALM that does support LeanFT.

For example, if your upgrade path was: ALM 12.01 Patch 3 > ALM 12.50 > ALM 12.53, then your entities may become corrupted.

LeanFT-BPT entities include LeanFT components and BPT flows or tests with LeanFT components.

Solution: Perform a repair of the ALM project with corrupted entities, as described in the ALM Administrator Help.

Back to top

LeanFT plugin disappears after upgrading IntelliJ IDEA

Possible cause: The new version of IntelliJ IDEA was installed in a different location.

Solution: do one of the following:


  • Copy the plugin files from the LeanFT installation folder to IntelliJ IDEA's plugin folder.

Back to top

My old Cucumber project does not work

Problem: Cucumber projects created using LeanFT templates from versions 14.52 or earlier do not work with LeanFT versions 14.53 or later.

Solution: Perform the following steps to adjust your project to work with the new LeanFT versions: 

  1. Update your file:

    1. At the CucumberOptions annotation, change the feature parameter from: 

      features = "src/main/java/<name_of_the_package>"


      features = "classpath:< name_of_the_package>"

    2. Replace with

  2. In the pom.xml file, add the following dependency:






  3. Install and deploy the new LeanFT JARs in the Maven repository, including com.hp.lft.cucumberv1-14.53.0.jar. For details, see Prerequisites for Maven-based projects.

Back to top

See also: