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:
- Add the process name of your Java application to the end of the file using the following format:
- Restart the LeanFT runtime engine.
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:
- From the bin folder in your LeanFT installation folder, open a command line window.
Run the command:
The following error message confirms that the cause of the failure is the unrecognized
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
Edit your system PATH environment variable and add to it the path of the
Tip: The path to add is usually
Test this fix by typing
wmicin a new command line window. This should open the wmi command line interface, which prompts with: wmic:root\cli>
Enable LeanFT from your IDE.
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 127.0.0.1.
Eclipse: LeanFT plugin not working in Eclipse
For Eclipse Kepler/Luna users only:
To use the Eclipse IDE for Java EE Developers or Eclipse Standard editions with the LeanFT plugin, you must deploy the Google Gson plugin to your Eclipse folder:
Download the Google Gson plugin, version 2.1 or later, from MVN Repository.
- Copy the downloaded .jar file to your <Eclipse deployment>\plugins folder and reopen Eclipse.
For deployment on Mac:
You may not have read/write permissions to the following directory:
Apply the required permissions to this folder.
Solution: If Eclipse is configured to use a proxy server, make sure that the proxy bypass is enabled for localhost.
Solution: If you change the location of your Eclipse installation after installing the LeanFT plugin, the LeanFT plugin will not work. To rectify this, you need to uninstall the LeanFT plugin from Eclipse, and reinstall it using the path to the new location:
- On your computer, open Uninstall programs and run the HP Lean Functional Testing setup in Change mode.
- Clear the Eclipse check box, and click Change. This removes the LeanFT plugin from Eclipse.
- Run the HP Lean Functional Testing setup in Change mode again.
- Select Eclipseand click the Change button adjacent to the file path box to enter the new location of the Eclipse installation.
- Click Change to complete the installation.
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:
java.io.IOException: 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.
C:\Program Files (x86)\Java\jre1.8.0_91\bin
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.
Open Google Chrome Extensions (chrome://extensions)
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.
Restart the computer.
Restart the LeanFT runtime engine.
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).
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 127.0.0.1.
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:
Object Identification Center (OIC) not recognizing objects
- Close the IDE/OIC.
- Close browser.
- Open the IDE/OIC, and then open the browser.
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.
Solution: Uninstall UFT/LeanFT and reinstall using a path that contains no spaces.
Solution: Ensure that LeanFT is calling the correct JRE/JDK installed on your computer.
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
Application model in Visual Studio is showing a blank screen
In Visual Studio, the Application model window suddenly goes blank.
- Open PackagePreferences.json, located in %appdata%\LeanFT\Preferences.
Locate the EnableAppModelLargeAddressSpace parameter, and change the value from false to true.
It should look as follows:
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 leanft.properties file, or inside your test using the ReportConfiguration methods.
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.
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.
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.
Install and configure the ALM 12.53 patch.
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.
ALM: Cannot run test. I get a message about Remote Agent configuration
Possible cause: The Java assets may not be correctly defined in the Remote Agent configuration.
Solution: Make sure the classpath to your Java assets is correctly formatted.
Use the following syntax:
<javaAssets>%CLASSPATH%;$LEANFT_INSTALL_DIR\SDK\Java/*;<junit.jar path>;<hamcrest-core.jar path></javaAssets>
Important: Use a semi-colon (;) separated list for the classpath.
Example (including the hamcrest-core JAR):
For more details, see javaAssets in Configure the Remote Agent .
Possible cause: The default Remote Agent configuration does not to allow running ALM tests on a remote computer (allowRun = false).
Solution: In the Remote Agent configuration file on the host computer, the allowRun value must be set to true.
For full instructions, see Configure the Remote Agent .
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.
public void Test(string param)
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.
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:
- Run the LeanFT installer in Change mode and select to include IntelliJ IDEA as a plugin again. For details, see Maintaining and uninstalling LeanFT.
- Copy the plugin files from the LeanFT installation folder to IntelliJ IDEA's plugin folder.