Upgrade UFT One

You can upgrade directly to the most recent version of UFT One from any previous version of UFT One, or from Service Test 11.50.

Before you upgrade

If you are upgrading from a much earlier version, consider the following:

  • UFT One uses .NET Framework 4.8 (and optionally, 5.0.6). Earlier UFT versions used earlier .NET Framework versions.

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

  • If you are upgrading from version 12.54 or earlier, uninstall UFT and all relevant patches before installing UFT One.

Back to top

Perform your upgrade

Do the following to upgrade UFT One:

  1. Download the installation files for your new version: https://www.microfocus.com/en-us/products/uft-one/download.

  2. Restart your system to ensure complete configuration for the system.

  3. Run the UFT One_<VersionNumber>_Setup.exe file to upgrade using the installation wizard.

    Alternatively, update your silent installation scripts to use the newly downloaded files.

Note: Upgrades retain Run Session and Startup options only. Redefine all other settings as needed.

Back to top

UFT One configuration files location

Starting UFT One 2021, the UFT One configuration files are stored in new locations.

The first time you run UFT One after upgrading from a version earlier than 2021, all existing setting files are automatically migrated to the new locations. This enables you to continue using your existing UFT One settings in the new version.

If the UFT One Settings Migration fails to migrate all files, UFT One suggests that you move the files manually. Otherwise, UFT One uses default settings instead of your existing configuration.

The following table lists the folders that contain files to migrate. Copy all of the files under the folders in the left to the new folders in the right.

Old folder New folder
%APPDATA%\Hewlett-Packard\UFT %APPDATA%\Micro Focus\UFT
%APPDATA%\HP\QuickTest Professional %APPDATA%\Micro Focus\QuickTest Professional
%APPDATA%\HP\API Testing %APPDATA%\Micro Focus\API Testing

Note: If you downgrade from UFT One 2021 to an older version, the existing configuration will not be preserved and default settings of the older version are used.

Back to top

Notes for upgrading

The following items address issues when upgrading in specific situations. Read the instructions for any of the situations that are relevant for your upgrade.

Upgrade silent installation scripts

If you are upgrading your silent installation scripts and the current scripts, including the Help_Documents parameter, remove this parameter. Help documents are no longer installed with UFT One.

You can access our Help Center online, or download it to your local drive. Download the Help from the Options dialog box (Tools > OptionsGeneral tab > Help).

Upgrade licenses

You must get a new license if you are upgrading from QuickTest, Service Test, or a version of UFT One earlier than 12.50.

You can also upgrade your license to the new Functional Testing licenses: UFT Ultimate, UFT One, and UFT Developer. This step is not required.

For assistance, contact a regional licensing support center or your sales representative.

Upgrade with a concurrent license

UFT One supports the AutoPass License Server as its concurrent license server.

If you are upgrading to UFT One with a concurrent license, you must also upgrade your concurrent license server and install your licenses on the AutoPass License Server.

For details, see the AutoPass License Server online documentation.

Note: If you are installing UFT One from the compressed package for the Web, this link is not available. If you need to install UFT One and the License Server, you must install UFT One from the full installation package.

Upgrade with Web tests on Microsoft Edge

UFT One has changed the way that the Microsoft WebDriver program (required for the Micro Focus UFT Agent for Edge) is used. For details on the required steps to perform, see Use the Edge Agent for UFT.

Upgrade with Web tests on Safari

If you used a previous version of UFT One to test Web applications on Safari, you must reinstall the UFT Connection Agent on the Mac from the current version of UFT One.

The UFT Connection Agent preferences and the Unified Functional Testing Agent Safari extension preferences are reset to their defaults.

Upgrade with text recognition options in automation scripts

If you are running UFT One with an automation script and have added text recognition options to the script, the following properties are obsolete and must be updated:

Update To


TextRecognitionOrder TextRecognitionOcrMechanism

Upgrade after using UFT One and ALM

If you upgrade to UFT One from a version of UFT One earlier than 12.50 shortly after using UFT One to run GUI tests from ALM, make sure to stop the Remote Agent (if running) before running tests from ALM again.

To stop the previous Remote Agent process, in the Windows system tray, right-click the Remote Agent icon and select Exit.

Upgrade to UFT One 2021

The first time you run UFT One after upgrading from a version earlier than 2021, all existing setting files are automatically migrated to new locations. This means that if you install a different license immediately after the upgrade, the license is automatically overwritten the first time you launch UFT One, resulting in the launch failure.

To prevent the failure, after the upgrade, you must run UFT One first and then use the Functional Testing License Wizard to install the new license.

Back to top