Upgrade

You can upgrade directly to the most recent version of OpenText Functional Testing for Developers from any previous version.

Upgrading is a simple procedure of installing OpenText Functional Testing for Developers and a few additional tasks.

Before you upgrade

Versions 15.0 and later use a newer version of the .NET Framework (4.8) than LeanFT used.

If you are upgrading from an earlier version, consult the Support Matrix to make sure that your operating system is compatible with the new version.

Back to top

Perform the upgrade

Depending on the platform you are installing on, follow the instructions in Install on Windows, Install on Linux or Install on Mac.

Caution: If you are performing a silent installation on Windows, make sure that no Java processes are running in the background during the installation.

Back to top

After you upgrade

After upgrading, you must perform the following steps:

  1. If you have maven-based projects, do the following:

    1. Install or deploy the new OpenText Functional Testing for Developers JARs in the Maven repository. For details, see Prerequisites for Maven-based projects.

    2. Update the version number in the pom.xml files in your Maven projects.

  2. If you have application models, regenerate their code. For details, see Generate application model code.

  3. If you are running tests remotely on this computer, configure the runtime engine settings file. For details, see Set up the remote computer.

  4. If your JavaScript tests include LFT.Reporter.getStatus() steps created in versions earlier than 2021 R1, you must adjust these steps.

    Starting in version 2021 R1, the getStatus return type is a promise that is fulfilled with a string representing the runtime status of the OpenText Functional Testing for Developers report. For an example of how to adjust your steps accordingly, see Report code samples (JavaScript SDK).

  5. If your tests were created in versions 23.4 or earlier, check the behavior of the GetTextLocation and GetVisibleText methods. Upgrades made to the ABBYY OCR engine in versions 23.4 and 24.2 might affect their results.

  6. If you have .NET test projects based on .NET Framework versions earlier than 4.8, you need to retarget them to .NET Framework 4.8 before you can build them with the new .NET SDK. In 24.4, the .NET SDK was upgraded to .NET Framework 4.8.

Back to top

Configuration file location

In versions 24.2 and 2021, the location used to store some configuration files changed.

The first time you run OpenText Functional Testing for Developers after upgrading to a version that uses a new file location, the files are automatically migrated to the new locations. This happens when you upgrade to version 24.2 or later, from a version earlier that 24.2, or upgrade to version 2021 or later, from a version earlier than 2021.

  • In versions earlier than 2021, files were stored in %AppData% or %ProgramData% or HP or Hewlett-Packard folders.

  • In versions 2021-23.4, files are stored in %AppData% or %ProgramData% or Micro Focus folders.

  • In versions 24.2 and later, files are stored in %AppData% or %ProgramData% or OpenText folders.

If the Settings Migration fails to migrate all files, you are prompted to move the files manually.

The following table lists the folders that contain files to migrate. Copy all of the files from the folders used in your previous version to the folders listed for your current version.

Version 24.2 or 24.4 Versions 2021-23.4 Vversions earlier than 2021
%APPDATA%\OpenText\UFT %APPDATA%\Micro Focus\UFT %APPDATA%\Hewlett-Packard\UFT
%APPDATA%\OpenText\QuickTest Professional %APPDATA%\Micro Focus\QuickTest Professional %APPDATA%\HP\QuickTest Professional
%APPDATA%\OpenText\API Testing %APPDATA%\Micro Focus\API Testing %APPDATA%\HP\API Testing
%PROGRAMDATA%\OpenText\UFT %PROGRAMDATA%\Micro Focus\UFT %PROGRAMDATA%\Hewlett-Packard\UFT
%LOCALAPPDATA%\OpenText\UFT %LOCALAPPDATA%\Micro Focus\UFT %LOCALAPPDATA%\HP\UFT

Note: If you downgrade as follows, the existing configuration will not be preserved and default settings of the older version are used:

Downgrade from 24.2 or later to 23.4 or earlier.

Downgrade from 2021 or later to 15.0.2 or earlier.

Back to top