Set up FT Design

To test web applications in your browser, you must install the ValueEdge Functional Test Design Agent and the browser extension. The agent and extension enable FT Design to communicate with your application.

This topic describes how to install the agent and the browser extension.


To install the agent, review the following requirements first.

System requirements

Ensure you have the following installed:

  • A 64-bit operating system, Windows 8 or later.

  • The required Windows feature, depending on your Windows operating system:

    For the most up-to-date instructions on enabling Windows features, see the Microsoft documentation.

  • Node.js version between 16.14.0 and 17.9.1

    Go to the Node.js website, and download and install the 64-bit Windows version of the Node.js MSI installer.

    We recommend downloading the latest 17.9.1 MSI installer unless your company requires an earlier version.

    When installing Node.js using the installation wizard, you can skip installing the Tools for Native Modules.

Required permissions

Make sure the required permissions are defined on your computer. Read/write permissions to these folders must also enable permission to any subfolders.

Function Permission Item
Installation permissions Administrator permissions

Administrator permissions to install Microsoft Visual C++ 2022 Redistributable

Note: If you already installed Microsoft Visual C++ 2022 Redistributable on your computer, administrator permissions are not required.

File system permissions to work with

Full read and write permissions

  • C:\Temp folder (Optional)

  • %LOCALAPPDATA%\Programs\VEFTDesign folder

  • %LOCALAPPDATA%\VEFTDesign folder

  • %LOCALAPPDATA%\LeanFT folder

  • %PROGRAMDATA%\Micro Focus folder

Registry key permissions to work with Full read and write permissions
  • Keys under HKEY_CURRENT_USER\SOFTWARE\Classes\mf-codeless-agent

  • Keys under HKEY_CURRENT_USER\Software\Micro Focus

Back to top

Install the agent

This section describes how to install the agent.

Note: You need to install one agent for each Windows user.

To install the agent:

  1. Log in to the ValueEdge platform. Navigate to the workspace you are working on. From the platform homepage, select Functional Test > Design.

    A dialog box opens, prompting you to install the Agent.

  2. Click Download.
  3. Double-click the downloaded installer program to run the installation wizard.

    By default, the agent is installed in %LOCALAPPDATA%\Programs\VEFTDesign\CodelessAgent.

  4. In the installation wizard, select the Allow installing a web extension on Chrome, Chromium Edge option if you want to test web applications in Chrome and Chromium Edge.

    This option updates your browser policy and enables the browser extension to be automatically installed in Chrome and Chromium Edge during agent installation.

    On a Windows Server, perform additional steps before you can use this option. See Prerequisite for using the option on a Windows Server.

    Caution: Before you select this option, make sure that your company's security policies permit you to make this change.

  5. After the installation is completed, the agent automatically starts and connects to FT Design.
  6. If the agent fails to connect to FT Design or is not running, try the following:

    • Manually connect the agent: Click the Agent icon in the upper-right corner and select Connect Agent.

    • Check whether the port specified is available. To change the port, click the agent icon and select Change Port. The default port number is 20000.

    • Restart the agent. Run the RestartAgent.bat file in %localappdata%\Programs\VEFTDesign\CodelessAgent\bin or manually restart it from the Windows Task Manager.

Continue with the following:

Set up your browser

Back to top

Update the agent

The agent is periodically updated. Always keep your agent current. This section describes how to manually update the agent.

To update the agent:

  1. Open FT Design from the ValueEdge platform.

    When a new agent is available, a dialog box opens.

  2. Click Download Update.

    Alternatively, click the agent icon in the upper-right corner and select Download.

  3. Run the downloaded installer program. After the installation is completed, FT Design is automatically refreshed.

Back to top

Set up your browser

Testing web applications requires a browser extension. This section describes how to set up your browser for testing.

To set up your browser:

  1. Install the extension in your browser.

    Browser Install steps...
    Chrome and Chromium Edge

    The extension for Chrome or Chromium Edge is automatically installed or updated when you install or update the agent. See Install the agent.

    Note: Updating the agent installs the new extension but does not uninstall the older one. Before you use FT Design, manually remove or disable the older extension.


    Manually install the extension in Firefox:

    1. Open the <agent installation folder>\Installations\Firefox folder.

    2. Drag the WebExtension.xpi file into Firefox.

    Note: Make sure that your browser policy allows you to install browser extensions.

    If your browser doesn't allow extension installation, add the extension to the list of extensions to install. For details, see Mozilla policy readme.

    The path to add for this extension is: <agent installation folder>\Installations\Firefox\WebExtension.xpi.

  2. Enable the extension in your browser. Make sure the extension version enabled matches the version of FT Design.

Working with UFT One or UFT Developer:

UFT One, UFT Developer, and FT Design use the same browser extension to test web applications. Each product installs its version of the extension, and requires that version to be the only one enabled.

Before you use FT Design on a computer with UFT One or UFT Developer installed, make sure the extension version enabled matches the version of FT Design.

If you later need to use a different version for UFT One or UFT Developer, disable the current extension and enable the relevant one.

Back to top

Next steps: