Known issues when installing

This topic describes troubleshooting and limitations for installing OpenText Functional Testing.

Files in use

If the OpenText Functional Testing Files in Use dialog box is displayed during the installation process, select Close the application and attempt to restart them.

OpenText Functional Testing automatically closes the applications and continues the installation.

If after restarting, the OpenText Functional Testing Files in Use dialog box lists Explorer as the open application, do one of the following:

Close the applications and attempt to restart them

Instructs OpenText Functional Testing to automatically close the applications that are needed for the installation.

Do not close application

Instructs OpenText Functional Testing to continue the installation. You must restart your computer after the installation if you select this option.

Back to top

Component registration failed

If a message is displayed during installation about component registration failing, do not click OK to continue.

Instead, check the issue in the VC2015Prerequisite_yyyymmdd_XXXXXX.log file in the %TEMP% directory. If the log shows that a service did not start correctly, restart the service manually, and start your installation again.

Back to top

Change or repair the OpenText Functional Testing installation

Changing or repairing the OpenText Functional Testing installation requires write permissions to certain registry keys.

Repairing the installation from the control panel without these permissions behaves as follows:

The installation wizard stops and displays an error message.

  • Log in to Windows as an administrator and Change or Repair the OpenText Functional Testing installation from the Control Panel.

  • Run the OpenText Functional Testing MSI installation program from the OpenText Functional Testing installation package and select the Change or Repair option.

Back to top

OpenText Functional Testing installations and other ADM software

The following describes troubleshooting and limitations for installing other ADM software with OpenText Functional Testing.

Sprinter If you are using both OpenText Functional Testing and Sprinter on the same computer, and you modify either OpenText Functional Testing or Sprinter, you must run a Repair for the installation of the other product.
ALM

When an ALM client is installed on the same computer as OpenText Functional Testing, uninstalling OpenText Functional Testing may remove the association of movie (.fbr) files.

This may prevent you from viewing movies associated with defects in ALM using the Micro Player application.

Workaround: Re-associate the movie files with the Micro Player application from the Windows File Options dialog box.

OpenText Functional Testing for Developers
  • In the Custom Setup screen, it is possible to select the OpenText Functional Testing for Developers Visual Studio or Eclipse plugins even if you do not have the relevant IDE installed at the time of the installation.

    If you install the IDE later, you will not have the OpenText Functional Testing for Developers plugin available.

    Workaround: After installing the required IDE, run a Repair for the installation.

  • Make sure to use the new syntax when silently installing OpenText Functional Testing for Developers as part of the OpenText Functional Testing installation.

    For details, see ADDLOCAL values for OpenText Functional Testing for Developers components.

    If you encounter an error similar to this one, make sure you did not use the old LeanFT silent installation command syntax:

    Error: The installer has encountered an unexpected error installing this package. This may indicate a problem with this package. The error code is 2711. The arguments are: LeanFT

Back to top

OpenText Functional Testing installations and Microsoft software

The following describes the troubleshooting and limitation for installing OpenText Functional Testing on Windows or using OpenText Functional Testing with other Microsoft software.

Software OpenText Functional Testing instructions
Windows 10 and 11
  • When installing OpenText Functional Testing on a Windows 10 or 11 operating system, you must close Cortana and the Action Center before performing the OpenText Functional Testing installation.

  • You must have administrative permissions to connect to ALM from OpenText Functional Testing on Windows 10 or 11.

    Connect to ALM with Administrator permissions immediately after installing OpenText Functional Testing.

pdm.dll

To debug GUI tests in OpenText Functional Testing, ensure that you have the pdm.dll file installed and registered.

The pdm.dll file is installed and registered with Microsoft Visual Studio and Microsoft Office, and installed (but not registered) with Microsoft Internet Explorer.

Alternatively, install the Microsoft Script Debugger provided with the OpenText Functional Testing installation, which provides the pdm.dll.

To register the pdm.dll file installed with Microsoft Internet Explorer:

  1. Ensure that you have administrator privileges.
  2. Locate the pdm.dll file, usually located either in c:\program files(x86)\internet explorer\ or c:\program files\internet explorer.
  3. Move the pdm.dll file and the msdbg2.dll file from the same folder to a different location.

  4. Run the following commands:

    regsvr32 <full path to pdm.dll>\pdm.dll

    regsvr32 <full path to pdm.dll>\msdbg2.dll

If your currently registered pdm.dll version is lower than 9:

  1. Uninstall the Microsoft Script Debugger (if installed).

  2. Install the Microsoft Script Debugger using the OpenText Functional Testing Additional Installation Requirements utility.

    Open the OpenText Functional Testing Additional Installation Requirements utility from the Windows Start menu or by running <Installdir>\bin\UFTInstallReqs.exe.

Microsoft Office 64-bit

Using OpenText Functional Testing and Microsoft Office 64-bit on the same machine requires some intervention. This is due to a conflict between the Microsoft Access Database Engine versions used by these two programs.

Do one of the following: 

  • Install OpenText Functional Testing before you install Microsoft Office 64-bit.

  • Before you install OpenText Functional Testing, install Microsoft Access Database Engine 2016 32-bit from an administrator command line, using the /quiet argument. For details, see Install Microsoft Access Database Engine 2016.

  • Install OpenText Functional Testing with the SKIP_MSADE_CHECK flag. This installs OpenText Functional Testing without requiring the Microsoft Access Database Engine 2016 Redistributable to be installed.

    Silently: 

    cmd /c MsiExec /norestart /qn /i "<OpenText Functional Testing MSI Path>\Unified_Functional_Testing_x64.msi" /l*xv "<log file path>.log" SKIP_MSADE_CHECK=1

    Using the installation wizard:

    cmd /c MsiExec /norestart /qf /i "<OpenText Functional Testing MSI Path>\Unified_Functional_Testing_x64.msi" /l*xv "<log file path>.log" SKIP_MSADE_CHECK=1

    You can install the redistributable engine as described above, if you find later that you need it for API database activities.

Windows Server 2012 R2

When using OpenText Functional Testing on Windows Server 2012 R2, if you want to use API tests and components, make sure that you have MSU (Microsoft Update) KB2887595 installed.

Back to top

Installing the OpenText UFT Agent browser extension

The following provides instructions on installing OpenText UFT Agent extension in browsers.

Browser OpenText Functional Testing instructions
Google Chrome

If you are testing applications in Google Chrome version 68 or later, Chrome automatically downloads and installs the OpenText UFT Agent for Google Chrome the first time you open Chrome after OpenText Functional Testing is installed.

In the following cases, you must manually install the OpenText UFT Agent Chrome extension:

  • You have no Internet connection.

  • You have not enabled the automatic updates for Google Chrome.

  • You are using Google Chrome version 67 or earlier.

  • You are using Google Chrome version 95 or earlier.

For details on manually installing the extension, see Enable the OpenText UFT Agent extension on Google Chrome.

Mozilla Firefox

The first time you open Firefox after OpenText Functional Testing is installed, accept the prompt to install the OpenText UFT Agent for Firefox.

General

To use the latest OpenText UFT Agent browser extension, make sure its older version, the Functional Testing Agent extension is not installed. If both extensions are installed, manually remove the older before enabling the new.

Back to top

OpenText Functional Testing installations and 64-bit applications

Installing with administrator privileges

OpenText Functional Testing loses support for 64-bit applications if a user with administrator privileges installs the UFT One Add-in for ALM, or performs a Repair operation on the Run Results Viewer, and then a user runs OpenText Functional Testing on that same computer without administrator privileges.

Workaround: Log in as an administrator and do one of the following:

  • Repair OpenText Functional Testing

  • Run <Installdir>\bin64\Mediator64.exe.

32-bit and 64-bit applications

If your computer has two versions of an application, where one is 32-bit and the other is 64-bit, OpenText Functional Testing always opens the 32-bit version.

This occurs when the operating system performs a redirect from the Program Files folder to the Program Files (x86) folder, and from the System32 folder to the SysWow64 folder.

Workaround: To specify a 64-bit version, make sure that the step explicitly states the path to the 64-bit application.

.NET / WPF Add-in extensibility When working with .NET or WPF Add-in extensibility for a 64-bit Windows Forms process, the custom server DLLs must be built using the Any CPU option.

Back to top

OpenText Functional Testing installations and Java

When re-installing or upgrading the JRE on a machine with OpenText Functional Testing installed, you might encounter error 1603 preventing the JRE installation to complete.

This can be caused by an interference between the OpenText Functional Testing Java environment variables and the Java installer.

To successfully complete the installation, rename the OpenText Functional Testing Java environment variables, perform the JRE installation and restore the variable names.

To temporarily rename the OpenText Functional Testing Java environment variables: 

  1. On your Windows Desktop, right-click My Computer or This PC and select Properties.

  2. Select the Advanced tab.

  3. Click the Environment Variables... button.

  4. Look for the following environment variables both under the user variable list and the system variables list and edit their names:

    • _JAVA_OPTIONS

    • Java_Tool_Options

    • IBM_Java_Options

  5. Install the JRE.

  6. After the installation is completed, change the environment variables names back to their original names.

Back to top

Installing in languages other than English

When installing OpenText Functional Testing in languages other than English, the TTF16.ocx file is not registered by default. To avoid errors in these cases, do the following before beginning your installation:

  1. Browse to the Windows Welcome screen and new user account settings. You may be able to find this in your Windows Region or Region and Language control panel settings.

  2. Click Copy settings… and select to copy your current settings to the Welcome screen and system accounts.

Back to top

See also: