Configure the LeanFT host computer

Note: This procedure must be performed once for each LeanFT host computer before you can run LeanFT tests or business process tests in ALM.

It can be performed separately and ahead of time, as needed.

ALM Prerequisites

  1. Install the ALM Connectivity Add-in from ALM

    In ALM, select Help > ALM Tools > HP ALM Connectivity.

    Note: The add-in version must match the ALM version. Ensure that you download the add-in from the ALM server where you will be running your tests.

  2. Ensure that you have the required ALM permissions

    ALM users who need to run LeanFT tests must have the following ALM permissions:

    Action Permissions
    Run Create; Update
    Run Step Create; Update
    Result Create; Update
    Test Instance Update
  3. Register ALM client in Common mode

    To run business process tests with LeanFT components, register the ALM client in Common mode on the remote machine.

  4. Continue with Install LeanFT and store the required LeanFT test files on the host computer.

Back to top

Install LeanFT and store the required LeanFT test files on the host computer

  1. Ensure that all ALM Prerequisites are fulfilled.
  2. Ensure that you have LeanFT installed on each computer where you plan to run LeanFT tests in ALM.

    For details, see UFT Pro (LeanFT) installation.

  3. Set required DCOM permissions (not required for local hosts):

    If you are running your LeanFT test on a computer other than the local ALM machine, you must set the required permissions for the LeanFT Remote Agent, and open the DCOM port (port 153).

    To set these permissions, run the LFTDcomPermissions.exe utility:

    Note: If UAC is enabled, run the utility by selecting Run as Administrator.

    <LeanFT installation>\Tools\Remote Agent\LFTDcomPermissions.exe -set.
  4. Ensure that the .jar or .dll files containing your LeanFT tests, as well as any other required files, are stored on the LeanFT computer.

    Relative paths

    If the LeanFT tests in the ALM test plan are defined with a relative path, you can store the LeanFT tests in any root folder that you choose.

    Ensure that the sub-folder structure of each .jar or .dll file under your root folder matches the corresponding paths specified in ALM.

    Later, in the Remote Agent configuration file, you will specify the root folder where your tests are stored.

    Absolute paths

    If the LeanFT tests in the ALM test plan are defined with an absolute path, make sure you store the tests in the exact paths that are specified.

    You do not have to specify any value for the root folder in the Remote Agent configuration file.

    If your AUT is stored on a different computer than LeanFT:

    On the AUT computer

    Ensure that LeanFT is installed and licensed. For details, see UFT Pro (LeanFT) installation.

    On the LeanFT host computer
    • Store the .jar, .dll, or any other required files in the relevant locations

    • Deploy the Remote Agent:

      Copy the <LeanFT installation>\Tools\RemoteAgent folder from your LeanFT computer to the ALM host computer.

      From the copied folder, run registerRemoteAgent.bat

      For more details, see Configure the Remote Agent on the host computer.

    • Ensure that your environment is otherwise configured and set up to run tests remotely. For details, see Run tests remotely.

Back to top

Configure the Remote Agent on the host computer

On every computer where you will run LeanFT tests from ALM:

  1. Open the LeanFT Remote Agent settings file:

    <LeanFT installation folder>\Tools\RemoteAgent\LFTRemoteAgent.exe.config

  2. Define the following settings:

    • <remoteAgent allowRun >. To run ALM tests on this computer, set this attribute to true—even if you are running on the ALM local host computer.

    • Framework setting.

      Note for Java users:

      • The <javaAssets> node from previous LeanFT versions has been deprecated. Use the <junit> node for JUnit settings and the <testng> node for TestNG settings.
      • <javaAssets> is supported for backward compatibility.
    • <testAssetDir>. The full path of the root directory that contains the test assets.

      Relative paths

      If the JAR Path or DLL Path field values are defined as relative paths in the Test Plan module of your ALM tests, the value you specify for this element is used to resolve the relative paths.

      Absolute path

      If the JAR/DLL paths are defined in ALM with an absolute path (such as C:\...). This value is ignored. Make sure your tests are stored on this computer in the exact location specified in ALM.

      Note: LeanFT does not enforce any security restrictions when configuring this directory.

  3. Restart the Remote Agent to ensure that the updated settings are uploaded when ALM next runs a test on the computer.

  4. Continue with one of the following:

Back to top

Java tests: (Optional) Define the JRE location to use

By default, LeanFT references the JRE location defined in the registry on the computer where the test runs (HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\Java Runtime Environment).

If you want LeanFT to use another location, create an environment variable (user or system) called JAVA_HOME. Specify the relevant JRE location as the value.

Continue with Set up your tests to store results in ALM.

Back to top

Set up your tests to store results in ALM

To store the LeanFT HTML report containing the run results in ALM:

  • The report folder values must remain undefined in your test.

    C# In the App.config file of all relevant projects, make sure that under <report>, the <output> element is commented out.
    Java In the leanft.project file of all relevant projects, in the Report Settings section , make sure the targetDirectory, reportFolder and overrideExisting options are commented out.
  • Make sure that the parallels of these values are not set inside the tests using ReportConfiguration properties.

Back to top

Note: When you no longer need to run LeanFT tests from ALM, revert the DCOM permissions settings (that you set in Install LeanFT and store the required LeanFT test files on the host computer) to the computer defaults.

Use the following command:

<LeanFT installation>\Tools\Remote Agent\LFTDcomPermissions.exe -reset.

Next steps: