Install the Design Agent

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

Prerequisites

To install the Design Agent, make sure you meet the following requirements and permissions: 

  • System requirements are listed in the Support Matrix.

  • Make sure you have the following permissions.

    Function Permission Item
    Installation Administrator permissions

    Administrator permissions are required if you plan to do either of the following: 

    • Install the Microsoft Visual C++ Redistributable prerequisite. For the required version, see the Support Matrix.

    • Install the Design Agent for all users on the computer.

    Installation Installation permissions

    Permission to install the Design Agent.

    File system

    Full read and write permissions

    Permissions for the following folders and their subfolders:

    • C:\Temp (Optional)

    • %LOCALAPPDATA%\Programs\VEFTDesign

    • %LOCALAPPDATA%\VEFTDesign

    • %LOCALAPPDATA%\LeanFT

    • %PROGRAMDATA%\OpenText

    Registry keys Full read and write permissions

    Permissions for the following keys:

    • Keys under HKEY_CURRENT_USER\SOFTWARE\Classes\mf-codeless-agent

    • Keys under HKEY_CURRENT_USER\Software\OpenText

Download the agent

Download the installation program from FT Design.

To download the agent:

  1. Log in to OpenText Core Software Delivery Platform.

    Go to the workspace you are working on.

  2. From the platform menu, select Functional Testing > Design.

    A pop-up opens, prompting you to install the agent.

    Note: This functionality requires that your browser settings allow the pop-up to open.

  3. Click Download.

Install for a single Windows user account

Install one agent for each Windows user.

To install the Design Agent for the current Windows user only:

  1. Double-click the downloaded installer program to run the installation wizard.

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

  2. In the installation wizard, select the Allow installing a web extension on Chrome, Chromium Edge to enable testing web applications in Chrome and Edge browsers.

    This option updates your browser policy and enables the agent installation to also install the browser extension on Chrome and Edge.

    Caution: Make sure that your company's security policies permit you to allow installing the extension.

    Prerequisite on Windows Server before you allow installing the extension:

    1. Enable Windows Installer Service.

      Type gpedit.msc in the Start menu to open the Local Group Policy Editor. In the Local Group Policy Editor, select Computer Configuration > Administrative Templates > Windows Components > Windows Installer.

      Edit Turn off Windows Installer. Select the Enabled option and set Disable Windows Installer to Never.

    2. If your browser policy does not permit extension installation, manually enable the installation of this extension. See Enable extension installation in the OpenText Functional Testing Help Center.

Install for all users

For administrators, use the command-line installation to install the agent for all users at once.

To install the Design Agent for all users on the computer:

Note: Administrator permissions are required.

  1. Extract the files from the downloaded installer program.

    In the folder containing the installer program, run the installer only to extract its content.

    Copy code
    DesignAgentSetup.exe -y  -nr -InstallPath="<folder name>"

    You can specify the target folder for the extraction in the InstallPath argument. By default, the files are extracted to c:\temp\DesignAgent.

  2. Set up prerequisites.

    In the extracted folder, run setup.exe to make sure all prerequisites are installed.

    Copy code
    setup.exe /InstallOnlyPrerequisite /s 
  3. Run the installation program to install the agent for all users.

    You can use a command line to run the wizard or to run the installation silently.

To run the installation wizard:

In the extracted folder, run the following command:

Copy code
msiexec -i agent.msi ALLUSERS=1

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

In the installation wizard, select the Allow installing a web extension on Chrome, Chromium Edge to enable testing web applications in Chrome and Edge browsers.

This option updates your browser policy and enables the agent installation to also install the browser extension on Chrome and Edge.

Caution: Make sure that your company's security policies permit you to allow installing the extension.

Prerequisite on Windows Server before you allow installing the extension:

  1. Enable Windows Installer Service.

    Type gpedit.msc in the Start menu to open the Local Group Policy Editor. In the Local Group Policy Editor, select Computer Configuration > Administrative Templates > Windows Components > Windows Installer.

    Edit Turn off Windows Installer. Select the Enabled option and set Disable Windows Installer to Never.

  2. If your browser policy does not permit extension installation, manually enable the installation of this extension. See Enable extension installation in the OpenText Functional Testing Help Center.

To run the installation silently:

Copy code
msiexec /qb -i agent.msi ALLUSERS=1 INSTALLDIR="<Installation Folder>"

The installation folder argument is optional.

The Allow installing a web extension... option is selected automatically.

User interface languages

The Design user interface is available in the following languages: English (default), Japanese, Chinese, French, German, Portuguese, Spanish.

The user interface is displayed in your configured language. If you select a language not supported in Design, English is used. For details on configuring your user interface language, see the OpenText Core Software Delivery Platform Help Center.

Test results are still displayed in English only.

Next steps

After installing the agent, see Set up FT Design to connect the agent and set up the browser extension.