UFT Installation Guide - UFT Help Center

HPE Unified Functional Testing
Software Version: 14.00
Installation Guide
Go to HELP CENTER ONLINE
http://uft-help.saas.hpe.com/
Document Release Date: January 2017 | Software Release Date: January 2017
Installation Guide
HPE Unified Functional Testing
Legal Notices
Warranty
The only warranties for Hewlett Packard Enterprise Development LP products and services are set forth in the
express warranty statements accompanying such products and services. Nothing herein should be construed as
constituting an additional warranty. HPE shall not be liable for technical or editorial errors or omissions contained
herein.
The information contained herein is subject to change without notice.
Restricted Rights Legend
Confidential computer software. Valid license from HPE required for possession, use or copying. Consistent with
FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data
for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.
Copyright Notice
© Copyright 1992 - 2017 Hewlett Packard Enterprise Development LP
Trademark Notices
Adobe® is a trademark of Adobe Systems Incorporated.
Microsoft® and Windows® are U.S. registered trademarks of Microsoft Corporation.
UNIX® is a registered trademark of The Open Group.
Documentation Updates
The title page of this document contains the following identifying information:
l
l
l
Software Version number, which indicates the software version.
Document Release Date, which changes each time the document is updated.
Software Release Date, which indicates the release date of this version of the software.
To check for recent updates or to verify that you are using the most recent edition of a document, go to:
https://softwaresupport.hpe.com.
This site requires that you register for an HPE Passport and sign in. To register for an HPE Passport ID, go to
https://softwaresupport.hpe.com and click Register.
HPE Unified Functional Testing (14.00)
Page 2 of 60
Installation Guide
HPE Unified Functional Testing
Contents
HPE Unified Functional Testing
1
UFT installation overview
5
Required access permissions
8
Required permissions for UFT
8
Required permissions for ALM
9
Required permissions for BPT
9
Enterprise deployment
11
UFT and User Account Control (UAC)
11
Stingray or Terminal Emulator Add-ins
11
Upgrade UFT
13
Install UFT
16
Installation prerequisites
16
Install UFT with the install wizard
17
UFT silent installation
22
Verify the installation
32
Known issues with installation
33
UFT licensing
40
Demo license
40
Seat licenses
40
Concurrent licenses
40
Commuter licenses
41
License editions
41
Supported license editions
41
Upgrading licenses from before UFT 14.00
42
Licensing fallback mechanism
43
Define license usage behavior
44
Install licenses
46
Install licenses from the command line
49
UFT licensing FAQs
51
Can I use my old license (from before UFT 12.50) with the new License Server?
52
How do I get a new license?
52
Which license should I install?
53
How do I install the Autopass License Server?
53
HPE Unified Functional Testing (14.00)
Page 3 of 60
Installation Guide
HPE Unified Functional Testing
If I am using concurrent licenses, how do I get UFT to work with the License Server?
53
How do I install licenses if I am deploying UFT across an enterprise network?
54
How do I manage the concurrent licenses on the License Server?
54
Can I configure license behavior myself?
54
Can I set up my License Server to work with a redundant (backup) License Server?
55
Can I use the Autopass License Server with a proxy?
55
What is a cleanup license?
55
My demo license is expiring early. What can I do?
55
Known issues with UFT licensing
55
Before connecting to ALM
57
Send Us Feedback
59
HPE Unified Functional Testing (14.00)
Page 4 of 60
Installation Guide
UFT installation overview
UFT installation overview
This guide provides details about how to install UFT from the full installation package,
as well as a compressed, lighter installation package downloadable from the Web.
In either package, installing UFT provides core UFT features, the Run Results Viewer,
and the following mandatory GUI testing add-ins:
Web
l Standard Windows
l Mobile
l Windows Runtime (when installing on computers with Windows 8.x and higher, and
Windows Server 2012)
You can select additional add-ins during installation.
l
Web 2.0 add-ins and extensibility toolkits must be installed separately from the full
installation package, after the UFT installation is complete.
The lighter installation package provides the UFT setup program only.
The full installation package provides the UFT setup program, as well as additional setup
programs for UFT components. To install an additional component, select it from the
UFT installation wizard Startup screen.
Additional UFT components include:
Component
Description
UFT Add-in
for ALM
Enables UFT to communicate with ALM and run tests or components
from ALM.
Install the standalone version only if UFT is not installed on the
computer.
To install this together with UFT, select to install it while installing UFT.
If you did not install this originally with UFT, and want to later on, run
the installation wizard again. Select Change, and then select ALM
Plugin in the Custom Setup screen.
Extensibility Enable you to develop support for Java, .NET, WPF, Silverlight, or
Web object not supported by UFT by default.
SDKs
HPE Unified Functional Testing (14.00)
Page 5 of 60
Installation Guide
UFT installation overview
Component
Description
Web 2.0
Toolkit
Support
Enable you to recognize and use objects in your test from Web 2.0
technologies, including:
License
server
setup
Enables you to install the AutoPass License Server, which is used to
install and manage UFT concurrent and commuter licenses.
Run
Results
Viewer
setup
Enables you to install a standalone version of the Run Results Viewer.
LeanFT
setup
Enables you to install Lean Functional Testing, a functional testing tool
that enables you to code tests directly from your developer IDE.
ASP .NET Ajax
l Dojo
l GWT (Google Web Toolkit)
l jQueryUI
l SiebelOpenUI
l EXT-JS
l YahooUI
Web 2.0 Toolkits appear in UFT as GUI Add-ins.
l
For details, see "UFT licensing" on page 40 and the Autopass License
Server User Guide.
Install the standalone version only if UFT is not installed on the
computer.
l
l
l
Install the standalone version only if UFT is not installed on the
computer.
To install this together with UFT, select to install it while installing
UFT. If you did not install this originally with UFT, and want to later
on, run the installation wizard again. Select Change, and then select
the LeanFT in the Custom Setup screen.
You must install Node.js 4.1.2 before installing LeanFT:
https://nodejs.org/en/download/
For more details, see the LeanFT Readme.
Note: Unless otherwise specified, references to Application Lifecycle
Management or ALM apply to all currently supported versions of ALM and Quality
Center.
HPE Unified Functional Testing (14.00)
Page 6 of 60
Installation Guide
UFT installation overview
Some features and options may not be supported in the specific edition of ALM or
Quality Center that you are using.
Before installing:
Ensure that you have required permissions, as listed in "Required access
permissions" on the next page
l Review any known issues, as listed in "Known issues with installation" on page 33
and "Known issues with UFT licensing" on page 55.
If you are installing in an enterprise environment, review "Enterprise deployment" on
page 11.
l
If you are upgrading, review "Upgrade UFT" on page 13 for specific steps that may apply
to you.
HPE Unified Functional Testing (14.00)
Page 7 of 60
Installation Guide
Required access permissions
Required access permissions
Verify the following access permissions before you start running UFT, or working with
UFT and ALM or BPT.
This chapter includes:
•
•
•
8
9
9
Required permissions for UFT
Required permissions for ALM
Required permissions for BPT
Required permissions for UFT
Required file system permissions
Read/write You must have read/write permissions to the following files and folders,
permissions as well as any sub-folders:
l
l
l
l
l
l
l
The Temp folder
The folder containing UFT solutions, tests, or run results
The <Program Files>\Common Files\Mercury Interactive folder
The <Program Data>\HPE folder (Windows 7 or Windows Server
2008 systems)
User Profile folders
The <Windows>\mercury.ini file
The following AppData folders:
%userprofile%\AppData\Local\HPE
%appdata%\Hewlett-Packard\UFT
%appdata%\HPE\API Testing
You must have read permissions to the following folders:
Read
permissions
l The Windows folder
l The System folder
HPE Unified Functional Testing (14.00)
Page 8 of 60
Installation Guide
Required access permissions
Required registry key permissions
Read/write All keys under:
permissions
l HKEY_CURRENT_USER\Software\Mercury Interactive
or
[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\HewlettPackard]
l HKEY_CURRENT_USER\SOFTWARE\Hewlett Packard
Read and
Query
Value
permissions
l
HKEY_LOCAL_MACHINE keys
l
HKEY_CLASSES_ROOT keys
Required permissions for ALM
Read/write permissions
Administrative permissions
l
ALM cache folder
l
<Program Data>\HPE folder
l
UFT Add-in for ALM installation folder
For the first connection to ALM
Required permissions for BPT
Ensure that you have the required ALM permissions before working with business
components and application areas.
Component steps
To work with component steps in ALM, you must have the appropriate Add Step, Modify
Step, or Delete Step permissions set.
You do not need Modify Component permission to work with component steps.
The Modify Component permission enables you to work with component properties (the
fields in the component Details tab).
Parameters in ALM or other testing tools
To work with parameters in ALM or in a testing tool, you must have all the parameter
task permissions set in ALM.
HPE Unified Functional Testing (14.00)
Page 9 of 60
Installation Guide
Required access permissions
Application areas
To modify application areas, you must have the separate permissions for resources
required for modifying components, and adding, modifying, and deleting steps.
All four permissions are required.
If one of these permissions is not assigned, you can open application areas only in
read-only format.
HPE Unified Functional Testing (14.00)
Page 10 of 60
Installation Guide
Enterprise deployment
Enterprise deployment
When installing UFT in an enterprise business model across many computers in a
network or company, ensure that you have administrator permissions on each computer.
This section includes:
"UFT and User Account Control (UAC)" below
l "Stingray or Terminal Emulator Add-ins" below
UFT also supports silent installations. For details, see:
l
l
l
"UFT silent installation" on page 22
"Install licenses from the command line" on page 49
UFT and User Account Control (UAC)
You do not need to turn off the computer's User Account Control (UAC).
For users to connect to ALM from UFT for the first time without turning off UAC, you must
also install the ALM client MSI file on each machine.
Generate a custom MSI for all your users with the ALM Client MSI Generator. This tool
enables you to configure the settings for your ALM servers before installing the clientside MSI.
Download the ALM Client MSI Generator and User Guide from https://
marketplace.saas.hpe.com/appdelivery/content/hp-alm-client-msi-generator-add
Instructions for configuring the settings for a custom MSI are provided in the user guide.
Note: When configuring the settings, you must select the Check Include Component
Registration and Use Shared Deployment Mode options.
Stingray or Terminal Emulator Add-ins
If your users are using either the Stingray or Terminal Emulator add-ins, there are
additional configurations you or the user must perform after installing UFT
Both the Stingray and Terminal Emulator Add-ins
Run the Additional Installation Requirements after the main installation on each
computer.
This tool is found in the Start menu (Start > All Programs > HPE Software > HPE Unified
Functional Testing > Tools > Additional Installation Requirements ).
HPE Unified Functional Testing (14.00)
Page 11 of 60
Installation Guide
Enterprise deployment
In the Additional Installation Requirements, select the Run Stingray Wizard and/or Run
Terminal Emulator Wizard options, and follow the configuration wizard steps to set up the
add-ins.
Stingray Add-in
After installing UFT, users must run the Stingray Support Configuration Wizard from
inside UFT: Tools > Options > GUI Testing tab > Stingray pane > Select Version.
This configuration requires no administrative permissions.
Terminal Emulator Add-in
After installing UFT, users must run the Terminal Emulator configuration wizard from
inside UFT: Tools > Options > GUI Testing tab > Terminal Emulator pane > Open Wizard
Users must have administrator permissions to run this wizard.
You can also run the wizard once, and then save the settings to a registry file that can
be deployed on all computers, as follows:
1. In the final screen of the Terminal Emulator Wizard, select the Save terminal emulator
settings to file option.
Note: Ensure that you record the vendor name and emulator name assigned
to the configuration, as wel as the exact location of the .reg file.
2. Copy the file to the <UFT installation folder>\dat folder on your computer.
3. Double-click the registry file to open the Registry Editor message box.
4. Click Yes to add the information into the registry. A message opens confirming that
the information has been copied into the registry.
5. Click OK. The emulator name assigned to this configuration is added to the list of
available terminal emulators for your UFT installation.
HPE Unified Functional Testing (14.00)
Page 12 of 60
Installation Guide
Upgrade UFT
Upgrade UFT
You can upgrade directly to the most recent version of UFT from any previous version of
UFT, or from Service Test 11.50.
For other upgrades, including versions of QuickTest or Service Test versions earlier
than 11.50, manually uninstall QuickTest or Service Test, and then install UFT.
Upgrades retain Run Session and Startup options only.
Ensure that you restart your system before performing the upgrade to ensure complete
configuration fo the system.
This topic includes:
l
l
l
l
l
l
l
l
l
l
"Upgrade silent installation scripts" below
"Upgrade licenses" below
"Upgrade with a concurrent license" on the next page
"Upgrade with Web tests on Microsoft Edge" on the next page
"Upgrade with Web tests on Safari" on the next page
"Upgrade with API tests" on the next page
"Upgrade with text recognition options in automation scripts" on page 15
"Upgrade after using UFT and ALM" on page 15
"Upgrade with the QTPNET_00015 patch" on page 15
"Upgrade from QuickTest Professional 11.00" on page 15
Upgrade silent installation scripts
Due to the removal of the Help documentation from the UFT installation, the Help_
Documents parameter for msi silent installation is no longer supported. If your installation
scripts use this parameter, update the scripts to remove the parameter.
If you still need a local copy of the Help, you can download it directly from the Help tab of
the Options dialog (Tools > Options > General tab > Help node).
Upgrade licenses
If you are upgrading from QuickTest, Service Test, or a version of UFT earlier than
12.50, you must get a new license.
Do this from the HPE Software Licenses and Downloads portal, where you can access
entitlements to software activations and downloads.
You will need the original Order Number (not the SAID) to access the entitlements in
this Portal.
HPE Unified Functional Testing (14.00)
Page 13 of 60
Installation Guide
Upgrade UFT
In addition, you can also upgrade your license to the new Functional Testing
licenses: UFT Ultimate, UFT Enterprise, and UFT Pro. This step is not required.
For assistance, contact a regional licensing support center or your sales representative.
Upgrade with a concurrent license
UFT supports the Autopass License Server as its concurrent license server.
If you are upgrading to UFT with a concurrent license, you must also upgrade your
concurrent license server and install your licenses on the Autopass License Server.
For full details, see the Autopass License Server User Guide.
Note: If you are installing UFT from the compressed package for the Web, this link
is not available. If you need to install UFT and the License Server, you must
install UFT from the full installation package.
Upgrade with Web tests on Microsoft Edge
UFT has changed the way that the Microsoft WebDriver program (required for the
Functional Testing Agent for Edge) is used. For details on the required steps to perform,
see the topic on using the Edge extension.
Upgrade with Web tests on Safari
If you used a previous version of UFT to test Web applications on Safari, you must
reinstall the UFT Connection Agent on the Mac from the current version of UFT.
The UFT Connection Agent preferences and the Unified Functional Testing Agent
Safari extension preferences are reset to their defaults.
Upgrade with API tests
If you plan to run tests of a Web Service using security created using Service Test or
UFT 11.53 or earlier, you must have the .NET Framework 3.5, WSE 2.0sp3 package,
and WSE 3.0 package installed on your computer.
These prerequisites are not provided with the UFT installation. If they are not installed
on your computer, you can install them from the following locations on the DVD:
NET 3.5 Framework
DVD/prerequisites/dotnet35_sp1/donetfx35_sp1.exe
WSE 2.0 sp3
DVD/prerequisites/wse20sp3/MicrosoftWSE2.0SP3Runtime.msi
WSE 3.0
DVD/prerequisites/wse30/MicrosoftWSE3.0Runtime.msis
HPE Unified Functional Testing (14.00)
Page 14 of 60
Installation Guide
Upgrade UFT
Upgrade with text recognition options in automation scripts
If you are running UFT with an automation script and have added text recognition
options to the script, the following properties are obsolete and must be updated:
l
l
Update TextRecognitionLanguages to AbbyOcrLanguages
Update TextRecognitionOrder to TextRecognitionOcrMechanism
Upgrade after using UFT and ALM
If you upgrade to UFT from an version of UFT earlier than 12.50 shortly after using UFT
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 with the QTPNET_00015 patch
If you install UFT while the QTPNET_00015 patch (a QuickTest 10.00 patch) is installed
on your computer, UFT may behave unexpectedly.
Before installing UFT, remove the patch from the Windows Control Panel Add/Remove
Programs dialog box.
Upgrade from QuickTest Professional 11.00
When upgrading from QuickTest Professional 11.00 and installing UFT into the same
directory as QuickTest, certain files will be missing from the installation.
After the upgrade, run the UFT installation again and select the Repair Installation option.
HPE Unified Functional Testing (14.00)
Page 15 of 60
Installation Guide
Install UFT
Install UFT
This chapter includes:
l
l
l
l
l
"Installation prerequisites" below
"Install UFT with the install wizard" on the next page
"UFT silent installation" on page 22
"Verify the installation" on page 32
"Known issues with installation" on page 33
Installation prerequisites
Before installing, verify the following prerequisites:
Permissions
Verify that you are logged on with the relevant access permissions.
For details, see "Required access permissions" on page 8.
Install
location
Select the location where you want to install UFT.
Do not install UFT on a network drive.
The installation path, and the path to the installation files, must
include English characters only.
Computer
state
Ensure that your computer does not need to be restarted.
Ensure that your computer meets all minimum system requirements
System
requirements listed here: http://uft-help.saas.hpe.com/en/14.00/Readme.htm
Internet
access
If you are installing the UFT Installation Package for the Web, ensure
that you have internet access.
Upgrades
If you are upgrading, check any relevant prerequisites described in
"Upgrade UFT" on page 13.
Licenses
Know which type of license you are using.
If you are using a concurrent license, have the license server URL
available.
For more details, see "UFT licensing" on page 40.
Add-ins
Know which add-ins you want to use for GUI testing. We recommend
installing only those you expect to use.
HPE Unified Functional Testing (14.00)
Page 16 of 60
Installation Guide
Install UFT
Note: If you install the UFT Add-in for ALM as part of the installation and you plan
to work with ALM 11.52 patch 4 or earlier, you must also install the Microsoft
Visual C++ 2005 SP1 Redistributable Package on your computer.
You can download this file from http://www.microsoft.com/enus/download/details.aspx?id=5638.
Install UFT with the install wizard
The UFT install wizard guides you through the installation process.
If you are installing UFT on a computer using a language other than English, your
installation setup and wizard automatically runs in the language of your computer.
Before the installation, restart your computer to ensure complete configuration of the
system.
When the Startup screen opens, select Unified Functional Testing Setup. If you do not
see this screen, run the setup.exe file in the UFT installation directory.
Follow the steps in the wizard to complete your installation.
This topic also includes additional details about the install wizard:
"License Agreement screen" below
l "Custom Setup screen" on the next page
l "UFT Configuration screen" on page 20
When the UFT installation is complete, you are prompted to view the Readme and
installation log.
l
You may also be prompted to restart your computer. If you are, we recommend restarting
as soon as possible. Delaying the system restart may result in unexpected UFT
behavior.
If you are using Web 2.0 add-ins or extensibility toolkits, perform additional installations.
For details, see "Install Web 2.0 add-ins or extensibility toolkits" on page 21.
License Agreement screen
By default, UFT is installed in English.
If you want to install UFT in the language of your operating system, select the language
option at the bottom of this screen.
HPE Unified Functional Testing (14.00)
Page 17 of 60
Installation Guide
Install UFT
Custom Setup screen
Select the features that you want to install:
HPE Unified Functional Testing (14.00)
Page 18 of 60
Installation Guide
Install UFT
Feature
Description
Runtime
Engine
Mandatory. Enables you to run UFT or LeanFT tests.
UI Designer
and IDE
Enables you to edit UFT tests.
Run Results
Viewer
Enables you to view UFT or LeanFT run results.
Samples
Demo applications used in the UFT tutorials.
ALM Plugin
Enables you to run and edit UFT tests directly from ALM.
LeanFT
Enables you to create functional tests directly from your developer
IDE.
GUI Testing
Add-ins
Provide the support which enable you to test applications using
supported technology versions.
Alternately, you can view run results in a browser window without
the Run Results Viewer.
You must install the Web Add-in to test applications based on Web
2.0 technologies.
For each feature, select one of the following installation options:
Will be installed on local hard drive.
Installs the selected feature on your local hard drive. Sub-features of the
selected feature are not installed.
Entire feature will be installed on local hard drive.
Installs the entire selected feature and its sub-features on your local hard drive.
For example, you can instruct UFT to install the .NET Add-in with its sub addins, Silverlight and Windows Presentation Foundation.
HPE Unified Functional Testing (14.00)
Page 19 of 60
Installation Guide
Install UFT
Selecting Entire feature will be unavailable. excludes the feature from the installation. It
will not be available in UFT.
UFT Configuration screen
Select any required items you want to configure automatically with the UFT installation.
Configure Internet
Explorer settings
Enables UFT to use the Microsoft Script Debugger application
during test runs.
Alternately, configure these settings manually before running
UFT. In Internet Options > Advanced, select the following
options:
Enable running UFT
remotely from ALM
l
Disable script debugging
l
Enable third-party browser extensions
Changes DCOM permissions and security settings and opens
a firewall port on your UFT computer.
Required if you are running UFT on Windows 7, and want to
run UFT tests remotely from ALM.
To set these options manually later on, see
https://softwaresupport.hpe.com/group/softwaresupport/searchresult/-/facetsearch/document/KM02239325
HPE Unified Functional Testing (14.00)
Page 20 of 60
Installation Guide
Install UFT
Enable running UFT
remotely from
Automation Scripts
Changes DCOM permissions and security settings to enable
other computers to remotely control UFT using automation
scripts.
Caution: Selecting this option enables remote users to
control UFT on this machine, exposing the UFT
computer to security risks.
To set these options manually later on, see
https://softwaresupport.hpe.com/group/softwaresupport/searchresult/-/facetsearch/document/KM02239325
Install Web 2.0 add-ins or extensibility toolkits
You must perform an additional installation to use Web 2.0 add-ins or extensiblity
toolkits. Extensibility toolkits enable you to develop support for add-in objects not
currently supported by UFT add-ins.
Do one of the following, depending on the type of UFT installation you performed:
UFT
installation
package
Web 2.0 / extensibility installation
Full installation
package
1. Run the UFT installation wizard.
In the UFT installation start screen, select the Add-in Extensibility
and Web 2.0 Toolkits option.
2. In the Unified Functional Testing Add-in Extensibility and Web
2.0 Toolkit support page, select the Extensibility SDK or Web 2.0
Toolkits installation option that you want.
3. Follow the steps in the wizard to complete your installation.
Lighter
installation
package for
the Web
1. After performing the UFT installation, navigate to the <UFT
installation>\Installations\Web2AddinSetup folder.
2. In the Web2AddinSetup folder, run the Web2AddinSetup.exe file.
3. Follow the steps in the wizard to complete your installation.
After your installation, the toolkit files and Extensibility SDKs are found in the
<UFT installation>\dat\Extensibility folder.
Web 2.0 add-ins are displayed as child add-ins to the Web Add-in in the Add-in
Manager when starting UFT.
HPE Unified Functional Testing (14.00)
Page 21 of 60
Installation Guide
Install UFT
UFT silent installation
You can install UFT and the ALM Add-in silently on your computer or a remote
computer.
Before installing silently:
l
Verify that you have administrator privileges.
l
Save any open files and close all open applications.
Note that silent installation commands are case-sensitive and should be entered
exactly as listed.
l If you are installing the lighter installation package from the web, in the silent
installation commands, change <UFT installation directory> to the download directory
you used.
The following is an example of a standard silent UFT installation:
l
msiexec /i "<UFT installation directory>\Unified Functional Testing\MSI\Unified_
Functional_Testing_x64.msi" /qb
See also: "Install licenses from the command line" on page 49
Ensure that you restart your system before performing the installation to ensure
complete configuration of the system.
Silent installation command reference
Prerequisites
"Install all UFT prerequisites" on the next page
"Install specific UFT prerequisites" on the next
page
"Install UFT Add-in for ALM prerequisites" on
page 25
"Install Run Results Viewer prerequisites " on
page 25
Install UFT
"Install UFT silently" on page 26
HPE Unified Functional Testing (14.00)
Page 22 of 60
Installation Guide
Install UFT
Install individual UFT features
"Install individual UFT features" on page 26
"Mandatory commands" on page 27
"Optional commands, for UFT core components"
on page 27
"Optional commands for UFT Add-ins" on page
28
"Commands for LeanFT components" on page 27
Standalone UFT Add-in for ALM
"Install a standalone UFT Add-in for ALM" on
page 29
Localization
"Install localized versions of UFT" on page 29
Remote configuration options
"Set UFT remote configuration options" on page
30
Additional commands
"Additional silent installation commands" on page
31
Lighter installation package for
the Web
"Install a lighter version of UFT" on page 32
Install all UFT prerequisites
<UFT installation directory>\Unified Functional Testing\EN\setup.exe
/InstallOnlyPrerequisite /s
back to top
Install specific UFT prerequisites
Some items have different commands for different systems. Run the command most
appropriate for your system.
Silent Command Line Syntax
.NET Fra
mework
4.5
<UFT installation directory>\prerequisites\dotnet45\dotnetfx45_full_x86_
x64.exe /q /norestart
HPE Unified Functional Testing (14.00)
Page 23 of 60
Installation Guide
Install UFT
Microsoft
Access
database
engine
2010
<UFT installation
directory>\prerequisites\msade2010\AccessDatabaseEngine.exe /quiet
Microsoft
WSE 2.0
SP3
Runtime
<UFT installation
directory>\prerequisites\wse20sp3\MicrosoftWSE2.0SP3Runtime.msi /quiet
/norestart ALLUSERS=1
Microsoft
WSE 3.0
Runtime
<UFT installation
directory>\prerequisites\wse30\MicrosoftWSE3.0Runtime.msi /quiet
/norestart ALLUSERS=1
Microsoft
Visual
C++ 2010
Run-time
Compone
nts for
32/64 bit
Operating
Systems
<UFT installation directory>\prerequisites\vc2010_redist\vcredist_x86.exe
/q
Microsoft
Visual
C++ 2012
Redistribu
table
<UFT installation directory>\prerequisites\vc2012_redist_x86\vcredist_
x86.exe /quiet /norestart
Microsoft
Visual
C++ 2015
Redistribu
table
<UFT installation directory>\prerequisites\vc2015_redist_x86\vcredist_
x86.exe /quiet /norestart
Microsoft
PDM insta
ller
<UFT installation directory>\prerequisites\pdm\ScriptDebugging_x86.msi
/quiet /norestart
<UFT installation directory>\prerequisites\vc2010_X64_redist\vcredist_
x86.exe /q
<UFT installation directory>\prerequisites\vc2012_redist_x64\vcredist_
x64.exe /quiet /norestart
<UFT installation directory>\prerequisites\vc2015_redist_x64\vcredist_
x64.exe /quiet /norestart
<UFT installation directory>\prerequisites\pdm\ScriptDebugging_x64.msi
/quiet /norestart
Note: The Microsoft Visual C++ 2015 Redistributable requires a Microsoft update:
For Windows 7: https://support.microsoft.com/en-us/kb/2999226.
HPE Unified Functional Testing (14.00)
Page 24 of 60
Installation Guide
Install UFT
For Windows 8 and 8.1, and Windows Server
2012: https://support.microsoft.com/en-us/kb/2975061, or the
following: https://support.microsoft.com/en-us/kb/2919442,
https://support.microsoft.com/en-us/kb/2919355, https://support.microsoft.com/enus/kb/2932046, https://support.microsoft.com/en-us/kb/2937592,
https://support.microsoft.com/en-us/kb/2938439 , https://support.microsoft.com/enus/kb/2934018, and https://support.microsoft.com/en-us/kb/2999226
If the installation does not start due to some missing KB files, you can view the
VC2015Prerequisite_yyyymmdd_XXXXXX.log file in the %TEMP% directory.
back to top
Install UFT Add-in for ALM prerequisites
Silent Command Line Syntax
.NET Frame
work 4.5
<UFT installation directory>\prerequisites\dotnet45\dotnetfx45_full_x86_
x64.exe /q /norestart
Microsoft
Visual C++
2012
Redistributa
ble
<UFT installation directory>\prerequisites\vc2012_redist_x86\vcredist_
x86.exe /quiet /norestart
Microsoft
Visual C++
2015
Redistributa
ble
<UFT installation directory>\prerequisites\vc2015_redist_x86\vcredist_
x86.exe /quiet /norestart
<UFT installation directory>\prerequisites\vc2012_redist_x64\vcredist_
x64.exe /quiet /norestart
<UFT installation directory>\prerequisites\vc2015_redist_x64\vcredist_
x64.exe /quiet /norestart
You must also have the following update installed to install the Microsoft
Visual C++ 2015 Redistribute: https://support.microsoft.com/enus/kb/2999226
back to top
Install Run Results Viewer prerequisites
Silent Command Line Syntax
.NET Frame
work 4.5
<UFT installation directory>\prerequisites\dotnet45\dotnetfx45_full_x86_
x64.exe /q /norestart
HPE Unified Functional Testing (14.00)
Page 25 of 60
Installation Guide
Install UFT
Microsoft
Visual C++
2012
Redistributa
ble
<UFT installation directory>\prerequisites\vc2012_redist_x86\vcredist_
x86.exe /quiet /norestart
Microsoft
Visual C++
2015
Redistributa
ble
<UFT installation directory>\prerequisites\vc2015_redist_x86\vcredist_
x86.exe /quiet /norestart
<UFT installation directory>\prerequisites\vc2012_redist_x64\vcredist_
x64.exe /quiet /norestart
<UFT installation directory>\prerequisites\vc2015_redist_x64\vcredist_
x64.exe /quiet /norestart
You must also have the following update installed to install the Microsoft
Visual C++ 2015 Redistribute: https://support.microsoft.com/enus/kb/2999226
back to top
Install UFT silently
Run the msiexec command to install UFT using the following syntax.
If you do not specify an installation folder, UFT is installed in the default installation
folder.
64 bit
msiexec /i "<UFT installation directory>\Unified Functional Testing\MSI\Unified_
Functional_Testing_x64.msi" /qb
86 bit
msiexec /i "<UFT installation directory>\Unified Functional Testing\MSI\Unified_
Functional_Testing_x86.msi" /qb
See also: "Additional silent installation commands" on page 31
back to top
Install individual UFT features
Use the ADDLOCAL MSI property in the silent installation command line to specify the
UFT features and add-ins that you want to install.
If you want to install only the UFT core components, you do not need to use this option.
Note: When installing a feature using the ADDLOCAL property, its parent always
is installed as well.
HPE Unified Functional Testing (14.00)
Page 26 of 60
Installation Guide
Install UFT
The following example installs UFTRuntime Engine only.
msiexec /i "<UFT installation directory>\Unified Functional Testing\MSI\Unified_
Functional_Testing_x64.msi" /qb ADDLOCAL="Core_Components" TARGETDIR="<UFT_Folder>"
ALLOW_OTHERSRUNTESTS=1
The following example performs a standard installation with the Java Add-in
msiexec /i "<UFT installation directory>\Unified Functional Testing\MSI\Unified_
Functional_Testing_x64.msi" /qb ADDLOCAL="Core_Components,IDE,Test_Results_
Viewer,Samples,Java_Add_in" TARGETDIR="<UFT_Folder>">"
The following example performs a standard installation with Web and Java Add-ins and
he DCOM configurations set.
msiexec /i "<installation_download_directory>\Unified Functional Testing\MSI\Unified_
Functional_Testing_x64.msi" /qb ADDLOCAL="Core_Components,Samples,Java_Add_in" CONF_
DICOM=1 TARGETDIR="<UFT_Folder>"
Mandatory commands
Command Syntax
Description
Core_Components
Installs the UFT Runtime Engine.
back to top
Optional commands, for UFT core components
Command Syntax
Description
IDE
Installs the UFT user interface.
Test_Results_
Viewer
Installs the Run Results Viewer.
Samples
Installs the sample applications included with the UFT
installation.
ALM_Plugin
Installs the UFT Add-in for ALM.
back to top
Commands for LeanFT components
Command Syntax
Description
HPE Unified Functional Testing (14.00)
Page 27 of 60
Installation Guide
Install UFT
LeanFT_Engine
Installs the LeanFT run-time engine.
LeanFT_Client
Installs the LeanFT client.
Vs2012Addin
Installs the LeanFT Plugin for Microsoft Visual Studio 2012.
Vs2013Addin
Installs the LeanFT Plugin for Microsoft Visual Studio 2013.
EclipseAddin
Installs the LeanFT Plugin for Eclipse.
ECLIPSE_INSTALLDIR
The path to your Eclipse IDE.
back to top
Optional commands for UFT Add-ins
Installs various UFT add-ins:
l
ActiveX_Add_in
l
Visual_Basic_Add_in
l
Web_Add_in
l
Delphi_Add_in
l
Flex_Add_in
l
Java_Add_in
l
_Net_Add_in
l
Silverlight_Add_in
l
WPF_Add_in
l
Oracle_Add_in
l
PeopleSoft_Add_in
l
PowerBuilder_Add_in
l
Qt_Add_in
l
SAP_Solutions_Add_in
l
SAP_eCATT_integration
l
Siebel_Add_in
l
Stingray_Add_in
l
TE_Add_in
l
VisualAge_Add_in
back to top
HPE Unified Functional Testing (14.00)
Page 28 of 60
Installation Guide
Install UFT
Install a standalone UFT Add-in for ALM
If you are installing UFT, you cannot use this command to install the UFT Add-in for
ALM. Instead, see "Install individual UFT features" on page 26.
In the command line, run the msiexec command to install the UFT Add-in for ALM, using
the following syntax:
msiexec /i "<UFT installation directory>\ALMPlugin\MSI\<ALM_Plugin_File>"
/qn
For example:
msiexec /i "<UFT installation directory>\ALMPlugin\MSI>\Unified_
Functional_Testing_Add-in_for_ALM.msi" /qn
See also: "Additional silent installation commands" on page 31.
back to top
Install localized versions of UFT
In the command line, add the PRODUCT_LOCALE property to the msiexec command to
install the following localized versions:
Language
Command
Chinese
PRODUCT_LOCALE="CHS"
French
PRODUCT_LOCALE="FRA"
German
PRODUCT_LOCALE="DEU"
Japanese
PRODUCT_LOCALE="JPN"
Russian
PRODUCT_LOCALE="RUS"
The following example installs the Chinese version of UFT with the .NET Add-in:
msiexec /i "<UFT installation directory>\Unified Functional Testing\MSI\Unified_
Functional_Testing_x64.msi" /qb ADDLOCAL="Core_Components,Samples,_Net_Add_in"
PRODUCT_LOCALE="CHS" TARGETDIR="<UFT_Folder>"
back to top
HPE Unified Functional Testing (14.00)
Page 29 of 60
Installation Guide
Install UFT
Set UFT remote configuration options
By default, the Allow running UFT remotely from ALM and Allow running UFT remotely
from Automation Scripts options are not included. To set this option for a silent
installation, set the value of each option to =1
Option
Command
Configure Internet Explorer settings
CONF_MSIE
Allow running UFT remotely from ALM
ALLOW_RUN_FROM_ALM
Allow running UFT remotely from Automation
Scripts *
ALLOW_RUN_FROM_
SCRIPTS
By default, the silent installation does not configure DCOM settings required for remotely
controlling UFT using automation scripts.
To configure the DCOM settings for automation scripts, use the following synax in your
silent installation command:
ALLOW_RUN_FROM_ALM=1
ALLOW_RUN_FROM_SCRIPTS=1
Caution: Setting this option enables remote users to control UFT on this machine,
exposing the UFT computer to security risks.
back to top
HPE Unified Functional Testing (14.00)
Page 30 of 60
Installation Guide
Install UFT
Additional silent installation commands
Command /
Argument
ADDLOCAL
Description
(Optional) Instructs the silent installation to install specific UFT
features and add-ins. For more details and a list of available
features, see "Install individual UFT features" on page 26.
Note:
l
l
l
l
This command is relevant for the UFT core installation only.
If you do not use this argument, UFT is installed with the default
add-ins.
You must include Core_Components in the ADDLOCAL command.
Values must be separated by commas and must not contain
spaces.
LICSVR=<server
name>
(Mandatory) The name or IP address of the license server to specify
when installing UFT licenses.
MsiFlags
(Optional) Any MSI options, flags, and other instructions that are not
included in the MsiProperties arguments, such as logging
commands.
MsiProperties
(Optional) Any MSI properties or parameters, such as TARGETDIR.
Each MSI property and its definition must be contained in quotes
("") and must not contain spaces.
ALM_Plugin
(Mandatory) The name of the MSI installation file.
There is a different MSI file for each available user interface
language.
Note: This command is relevant for the UFT Add-in for ALM
installation only.
<UFT installation
directory>
The path to the full installation UFT package
<installation_
download_
directory>
The path to the UFT Installation executable that you downloaded.
back to top
HPE Unified Functional Testing (14.00)
Page 31 of 60
Installation Guide
Install UFT
Install a lighter version of UFT
Command Syntax
Description
UFTSetup.exe -y
Installs the lighter version of UFT using a simple UI (a single
dialog box with a progress bar only).
UFTSetup.exe -y -gm2
Installs the lighter version of UFT completely silently.
UFTSetup.exe InstallPath="c:\<path>"
Installs the lighter version of UFT with a specific target
directory instead of the default.
UFTSetup.exe -!
<parameter list>
Installs the lighter version of UFT, passing the defined
parameter values.
UFTSetup.exe ExecuteFile=""
Extracts the installation package without running the UFT
installation.
Examples:
l
Extract the package to the default location (c:\temp), but do not start the UFT
installation:
UFTSetup.exe -y -ExecuteFile=""
l
Extract the package to the specified location (c:\UFTinstall ) in silent mode, but do not
start the UFT installation:
UFTSetup.exe -y -gm2 -InstallPath="c:\UFTinstall" -ExecuteFile=""
l
Extract the package silently and start installing UFT using the simple UI:
UFTSetup.exe -y
l
Extract the package and start installing UFT silently:
UFTSetup.exe -y -gm2 -! /s
back to top
Verify the installation
Use the Installation Check Tool to verify the status of your installation.
After installing UFT, run the Additional Installation Requirements utility to access the
Installation Check tool. Then open the tool from the Start menu or Program Files.
HPE Unified Functional Testing (14.00)
Page 32 of 60
Installation Guide
Install UFT
In some cases, the Installation Check Tool validates the state of settings against their
expected values. If UFT returns the expected value, the setting is marked in green. If the
value is not the same as the expected value, the setting is marked in red.
Note: The Installation Validation tool does not return the data on Remote Agent
Settings dialog unless the Remote Agent is run in administrator mode.
Click View Report to view the report as an .htm file. Click Send Email to send the report to
another user.
Known issues with installation
This section describes troubleshooting and limitations for installing UFT and includes:
l
l
l
l
l
l
"Previous UFT versions" below
"Files in use" on the next page
"UFT installations and other HPE software" on the next page
"UFT installations and Microsoft software" on page 35
"UFT installations and the Functional Testing Agent (browser support)" on page 37
"UFT installation in languages other than English" on page 39
Previous UFT versions
l
Ensure that you have the Microsoft update https://support.microsoft.com/enus/kb/2999226 installed before installing UFT.
HPE Unified Functional Testing (14.00)
Page 33 of 60
Installation Guide
Install UFT
l
If the installation fails, repair the Microsoft C++ 2015 Redistributable installation
(found in the <UFT installation directory>/prerequisites folder) and try the UFT
installation again.
Due to the Help documentation being online, the Help_Documents silent installation
parameter is no longer supported. If you have silent installation scripts that use this
parameter, remove it from your scripts to ensure UFT installs correctly.
Files in use
If the HP UFT Files in Use dialog box is displayed during the installation process, select
Close the application and attempt to restart them.
UFT automatically closes the applications and continues the installation.
If after restarting, the HP UFT 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 UFT to automatically close the applications that
are needed for the installation.
Do not close
application.
Instructs UFT to continue the installation. You must restart
your computer after the installation if you select this option.
UFT installations and other HPE software
LoadRunner
l
l
After uninstalling LoadRunner 11.50, UFT does not work.
Workaround: After uninstalling LoadRunner 11.50, perform a repair
installation for UFT
If you install LoadRunner 11.52 Patch 1 after installing UFT12.53,
make sure to reboot the computer after installing LoadRunner.
Otherwise, you may receive errors referring to the mdrv process.
Sprinter
If you are using both UFT and Sprinter on the same computer, and you
modify either UFT 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 UFT,
uninstalling UFT may remove the association of movie (.fbr) files.
This may prevent you from viewing movies associated with defects in
ALM using the HPE Micro Player.
Workaround: Re-associate the movie files with the HP Micro Player
from the Windows File Options dialog box.
HPE Unified Functional Testing (14.00)
Page 34 of 60
Installation Guide
Install UFT
LeanFT
In the Custom Setup screen, it is possible to select the LeanFT 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 LeanFT plugin
available.
Workaround: After installing the required IDE, run a Repair for the
installation.
UFT installations and Microsoft software
Software
UFT instructions
Windows 10
l
l
l
When installing UFT on a Windows 10 operating system, you must
close Cortana and the Action Center before performing the UFT
installation.
You must have administrative permissions to connect to ALM from
UFT on Windows 10.
Connect to ALM with Administrator permissions immediately after
installing UFT.
When uninstalling UFT on Windows 10, the UFT4WinRT service is
not uninstalled with other UFT files. As a result, a new installation on
the same machine will fail.
Workaround: Restart the computer after uninstalling UFT.
HPE Unified Functional Testing (14.00)
Page 35 of 60
Installation Guide
Install UFT
Software
UFT instructions
pdm.dll
l
l
If version 6.0.0.8169 ofthe pdm.dll is found on your computer, the
setup program will recgonize this during installation and will instruct
you download the corrected DLL from the Microsoft site.
For more details, see http://support.microsoft.com/kb/q293693/.
To debug GUI tests in UFT, ensure that you have the most recent
version of 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.
If your currently registered version is lower than 9:
a. Uninstall the Microsoft Script Debugger (if installed).
b. Perform a repair installation of Microsoft Visual Studio or
Microsoft Office.
Check the registry for pdm.dll version: HKEY_CLASSES_
ROOT\CLSID\{78A51822-51F4-11D0-8F20-00805F2CD064}
\InprocServer32
If you need to use the pdm.dll file installed with Microsoft Internet
Explorer, do the following:
a. Ensure that you have administrator privelgest.
b. Locate the pdm.dll file, usually located either in c:\program files
(x86)\internet explorer\ or c:\program files\internet explorer.
c. Move the pdm.dll file and the msdbg2.dll file from the same folder
to a different location.
d. Run the following commands:
regsvr32 <full path to pdm.dll>\pdm.dll
regsvr32 <full path to pdm.dll>\msdbg2.dll
Windows
Update
KB2918614
If you install UFT after installing Windows Update KB2918614, UFT
behaves unexpectedly during installation, with very long installation
times.
Workaround: Do the following in the registry:
1. Under the HKLM\SOFTWARE\Policies\Microsoft\Windows\Installer
key, create a DWORD with the name SecureRepairPolicy .
2. Set the value of the SecureRepairPolicy to 2.
3. In the HKLM\SOFTWARE\Policies\Microsoft\Windows\Installer key,
create StringValues with the UFT product code.
HPE Unified Functional Testing (14.00)
Page 36 of 60
Installation Guide
Install UFT
Software
UFT instructions
Microsoft
Office 64-bit
You cannot install Microsoft Office 64-bit on a machine with UFT.
Instead:
1. Uninstall the Microsofte Access database engine. This is installed
together with UFT.
2. Install Microsoft Office 64-bit.
3. Reinstall the Mcrosoft Office Access database engine from the
prerequisites\msade2010 folder of the UFT setup directory using the
following command:
<UFT root
directory>\prerequisites\msade2010\AccessDatabaseEngine.ex
e /passive
When using UFT on Windows 8.X or higher or Windows Server 2012
Windows
8.x or higher R2, if you want to use API tests and components, make sure that you
have MSU (Microsoft Update) KB2887595 installed.
/ Windows
Server 2012
R2
UFT installations and the Functional Testing Agent (browser support)
Browser UFT instructions
Google
Chrome
If you are testing applications in Google Chrome version 31 or later,
Chrome automatically downloads and installs the HP Functional Testing
Agent for Google Chrome the first time you open Chrome after UFT is
installed.
In the following cases, you must manually enable the Functional Testing
Agent for Google Chrome extension:
You have no internet connection.
l You have not enabled the automatic updates for Google Chrome.
l You are using Google Chrome version 30 or earlier.
For details on manually enabling the extension, see the task on How to
Enable the Functional Testing Agent for Google Chrome Extension in the
Web section of the Unified Functional Testing Add-ins Guide.
l
HPE Unified Functional Testing (14.00)
Page 37 of 60
Installation Guide
Install UFT
Browser UFT instructions
Mozilla
Firefox
Firefox versions 33 or later
If you are testing applications in Firefox version 33 or later, accept the
prompt for install HP Functional Testing Agent for Firefox the first time you
open Firefox after UFT is installed.
Firefox versions 32 or earlier
If you testing applications in Firefox version 32 and earlier, do the
following:
1.
2.
3.
4.
5.
6.
Open the <UFT installation folder>\Installations\Firefox folder.
From the Firefox folder, drag the AgentLegacy.xpi file into Firefox.
In Firefox, open the browser menu.
In the menu, click Add-ons .
In the Add-ons Manager tab, select the Extensions node.
In the Functional Testing Extension row, disable the HP Functional
Testing Agent extension and enable the extension you added to
Firefox.
Java applets
If you are testing Java applets, you must use the legacy Functional Testing
Agent for Firefox.
Legacy Functional Testing Agent for Firefox
The legacy Functional Testing Agent for Firefox is supported only for
Firefox versions 39 and earlier.
Note: If you are using a version of the Functional Testing Agent for Google
Chrome from UFT version 12.00 or earlier, you must enable the downloaded
extension and remove the previous version of the Functional Testing Agent
extension.
HPE Unified Functional Testing (14.00)
Page 38 of 60
Installation Guide
Install UFT
UFT installations and 64-bit applications
Installing
with
administrator
privileges
UFT loses support for 64-bt appliations if a user with administrator
priveleges installs the Unified Functional Testing Add-in for ALM, or
performs a Repair operation on the Run Results Viewer, and the a
user runs UFT on that same computer without adminsitrator
priveleges.
Workaround: Log in as an administrator and do one of the following
and Repair UFT or run <UFTinstallation>\bin64\Mediator64.exe.
32-bit and
64-bit
applications
If your computer has two versions of an application, where one is 32bit and the other is 64-bit, UFT 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.
UFT installation in languages other than English
When installing UFT 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 .
HPE Unified Functional Testing (14.00)
Page 39 of 60
Installation Guide
UFT licensing
UFT licensing
UFT supports various types of licenses. You can install licenses using the License
Wizard or from the command line.
We recommend you use the Autopass License Server version 9 or higher.
Information in this Help Center describes how you can use the Autopass License Server
from UFT. For full details on Autopass License Server capabilities, such as proxy
settings, license installation and management, and user management, see the
AutoPass License Server User Guide.
In this topic:
l
l
l
l
"Demo license" below
"Seat licenses" below
"Concurrent licenses" below
"Commuter licenses" on the next page
Demo license
When you install UFT for the first time, you have a demo license valid for 60 days.
This demo license is a seat license. If you need a demo concurrent license, you should
contact your HPE sales representative or HPE partner.
Seat licenses
A machine-specific license based on a specific locking code per computer.
The key must be entered once only, and provides one installation per key.
A computer with multiple bootable partitions may generate a different locking code for
each partition.
When obtaining a seat license key, you must use the locking code for the partition on
which you want to use UFT.
Concurrent licenses
A license taken from a license server on a per-session basis. You must have an active
network connection to install and check out commuter licenses.
Each time UFT starts, UFT tries to connect to the License Server for an available
license.
Each key provides unlimited installations . The license server regulates the number of
licenses in use at any given time.
HPE Unified Functional Testing (14.00)
Page 40 of 60
Installation Guide
UFT licensing
Tip: Use the HPE Usage Hub tool to track license usage across your network.
Commuter licenses
A license checked out for a period of time to use when you are not connected to the
license server.
You or another user must have an active network connection to install and check out
commuter licenses.
The license key is based on the machine identification, and is specific for the computer
making the request.
A commuter license key needs to be entered only once, and provides one installation for
a limited period of time.
After the commuter license expires, UFT automatically returns to the previously used
license type.
License editions
In this topic:
l
l
l
l
"Supported license editions" below
"Upgrading licenses from before UFT 14.00" on the next page
"Licensing fallback mechanism" on page 43
"Define license usage behavior" on page 44
Supported license editions
UFT supports a variety of license editions, each bundled with a different subset of FT
functionality.
License names
Includes the use
of these products:
UFT
Ultimate
UFT
Enterprise
UFT Pro
(LeanFT)
UFT
UFT Pro (LeanFT)
Sprinter
BPT
Mobile Center (for functional testing
purposes only)
HPE Unified Functional Testing (14.00)
Page 41 of 60
Installation Guide
UFT licensing
Additionally, use a UFT Runtime Engine license when you need to run UFT or LeanFT
tests.
The UFT Runtime Engine license does not enable you to create or edit tests, or access
the UFT IDE or LeanFT IDE plug-ins.
Note:
l
l
l
The UFT Ultimate license is available only as a concurrent license.
Sprinter is available for UFT Ultimate or UFT Enterprise concurrent licenses
only.
When using BPT with UFT with a UFT Enterprise license, you must also have
a valid ALM license for your user.
Upgrading licenses from before UFT 14.00
If you are upgrading, and currently have an FT, QTP, or UFT license,
Backwards
compatibility you are not required to migrate to one of the new license types.
UFT will continue to function with your existing license.
UFT and LeanFT licenses will be automatically renamed as follows:
l
l
Device ID based
licenses
UFT license: Your license is automatically renamed to the UFT
Enterprise license.
LeanFT license: Your license is automatically renamed to the UFT
Pro (LeanFT) license
Starting in UFT 14.00, UFT supports device ID-based concurrent
licenses, in addition to concurrent licenses based on your license
server IP address.
However, you cannot use both IP address-based and device ID-based
licenses simultaneously.
Once you've installed an ID-based concurrent license on your
AutoPass License Server, any IP address-based licenses for the same
features are automatically archived.
When upgrading, select the type of licenses you want to use moving
forward, and migrate your licenses as needed.
For more details, see the License Management - Frequently Asked
Questions section of the Autopass License Server User Guide.
HPE Unified Functional Testing (14.00)
Page 42 of 60
Installation Guide
UFT licensing
Licensing fallback mechanism
Note: The licensing fallback is relevant only when working with concurrent
licenses, and is not enabled by default.
When starting UFT or LeanFT, the Autopass License Server attempts to consume the
exact license edition configured on the UFT or LeanFT machine, such as UFT
Enterprise or UFT Pro.
To modify this configuration, see "Define license usage behavior" on the next page. Do
this if you are concerned about the availability of the license edition configured on your
UFT or LeanFT machine.
When the fallback mechanism is enabled, licenses are consumed as follows:
When starting UFT
l
l
If you have a UFT Enterprise license installed, the License Server looks for the UFT
Ultimate license as a fallback.
If you have a UFT Runtime Engine or UFT Pro (LeanFT) license installed, no fallback
is supported.
When starting the Runtime Engine or LeanFT
Licenses are consumed in the following order on the License Server, starting with the
license configured on your machine:
Example:
Scenario 1: UFT Pro (LeanFT) license configured on your LeanFT
machine
If the UFT Pro (LeanFT) license is configured on your LeanFT machine, but there
is no available UFT Pro (LeanFT) license on the License Server, LeanFT will try
to consume a UFT Enterprise license.
HPE Unified Functional Testing (14.00)
Page 43 of 60
Installation Guide
UFT licensing
In turn, if no UFT Enterprise license is available, LeanFT will try to consume a
UFT Ultimate license.
Scenario 2: UFT Runtime Engine license installed on your LeanFT
machine
If the UFT Runtime Engine license is configured on your LeanFT machine but
there is no available UFT Runtime Engine license, LeanFT will try to consume a
UFT Pro (LeanFT) license.
In turn, if there is no available UFT Pro (LeanFT) license, LeanFT will try to
consume a UFT Enterprise license, and so on.
Define license usage behavior
Define how your UFT or LeanFT installation uses licenses in the HPE UFT.xml file.
This file is located on your UFT or LeanFT computer at: C:\ProgramData\HP\HP AutoPass
License Server\AutoPass\LicenseServer\data\conf\.
Note: If you are upgrading from a previous UFT or LeanFT version, you must
upgrade your Autopass License Server to version 9.3 or higher to access this file.
Edit and add keys and values in the following format:
<entry key="{Key}">{Value}</entry>
Edit and add keys to do the following:
l
l
"Configure the licensing fallback mechanism" below
"Set maximum idle time" on the next page
Configure the licensing fallback mechanism
Depending on the license configured on your LeanFT machine, define whether your
system uses the licensing fallback mechanism by setting the following values to true:
Product
License type
Key
UFT
Any
license.fallback.uft.rte
Runtime Engine Any
license.fallback.rte.rte
HPE Unified Functional Testing (14.00)
Page 44 of 60
Installation Guide
UFT licensing
Product
License type
Key
LeanFT
UFT Pro
license.fallback.leanft.leanft
LeanFT
Runtime Engine license.fallback.leanft.rte
For example: To enable the fallback mechanism when you want to use UFT, and you
have any of the license types installed, set the relevant key value to true, as follows:
<entry key="license.fallback.uft.rte">true</entry>
Note: If the fallback mechanism is enabled on your computer, and an available
Runtime Engine license is found, you will only be able to run your tests, with no
creation or editing abilities.
Ensure that you can you can always access the UFT IDE or the LeanFT IDE
plug-ins by doing one of the following:
l
l
Disable the fallback mechanism on your computer by setting the key values to
false (this is the default)
Contact your License Server administrator to ensure that any UFT Runtime
Engine licenses are blocked or are in use
Set maximum idle time
Define the number of minutes, with no keyboard or mouse input, after which UFT or
LeanFT releases the currently used concurrent license.
In the HPE UFT.xml file, add the following line of code:
<entry key="autorelease.interval"><#></entry>
The number in this entry key is the number of minutes of inactivity.
For example, the following syntax defines that your license expires after 10 minutes of
inactivity.
<entry key="autorelease.interval">10</entry>
See also:
"Can I configure license behavior myself?" on page 54
HPE Unified Functional Testing (14.00)
Page 45 of 60
Installation Guide
UFT licensing
Install licenses
The Functional Testing License Wizard enables you install, check out, or switch
between license types, and requires administrator permissions.
Access the wizard from the Start menu (HPE Software > HPE Unified Functional Testing
> Tools > Functional Testing License Wizard) or the file system (C:\Program Files (x86)
\HP\Unified Functional Testing\bin\HP.UFT.LicenseInstallationWizard.exe)
Exit the wizard when the installation is complete. Restart the LeanFT runtime engine to
apply the new license.
Note: See also: "Install licenses from the command line" on page 49
You can view current license information from the Help > About Unified Functional
Testing screen by clicking the License button.
Additionally, UFT warns you if your license is about to expire. If you have multiple
licenses, UFT displays the date of the license closest to expiration.
In this topic:
l
l
l
l
l
l
"Install a Seat license (wizard)" below
"Install a Concurrent license (wizard)" on the next page
"Check out and install a Commuter license" on the next page
"Return a Commuter license" on page 48
"Check out and install a Remote Commuter license" on page 48
"Return a Remote Commuter license" on page 49
Install a Seat license (wizard)
1. In the License Wizard start screen, select Seat license.
2. In the Seat License installation screen, do one of the following:
l Click Load License Key File and select your license key .dat file.
l Paste the license key in the edit field.
If you don't yet have a license key, expand the How can I get a license key file
section.
3. Verify that the license key is valid, and click Install .
Note:
l
If you install a time-limited seat license, do not modify the date on your
computer. Doing so will block your active seat license and prevent future UFT
HPE Unified Functional Testing (14.00)
Page 46 of 60
Installation Guide
UFT licensing
seat license installations on that computer.
For questions about this issue, contact your HPE license supplier.
l
If you modify the MAC address or host name of the computer after installing a
seat license, you must regenerate and install your seat licenses again.
Install a Concurrent license (wizard)
1. Prerequisite: Make sure you are connected to the network and can access the
License Server.
2. In the License Wizard start screen, select Concurrent license.
3. In the Concurrent License Installation screen, enter the License Server address in
the following format:
<license server address>:<port>
Default port = 5814
The address format must identical the one used in the Main tab of the License
Server Configuration pane.
For details, see the Autopass License Server User Guide.
4. Click Connect to connect to the License Server.
5. (Optional) Define a redundant License Server.
If your primary License Server is unavailable, UFT will connect to the redundant
License Server to obtain a license.
Expand the Add Redundant Server link and enter the address for the redundant
License Server.
6. From the product license drop-down list, select the appropriate license and click
Install .
Check out and install a Commuter license
Commuter licenses can be checked out only if your License Server has available
concurrent licenses.
1. Prerequisite: Make sure you are connected to the network and can access the
License Server.
Alternative, if you cannot access the License Server: "Check out and install a
Remote Commuter license" on the next page
2. In the License Wizard start screen, select Additional Options > Commuter License.
3. In the Commuter License Installation screen, enter the License Server address in
the following format:
<license server address>:<port>
HPE Unified Functional Testing (14.00)
Page 47 of 60
Installation Guide
UFT licensing
4.
5.
6.
7.
8.
Default port = 5814
The address format must identical the one used in the Main tab of the License
Server Configuration pane.
For details, see the Autopass License Server User Guide.
Click Connect to connect to the License Server.
After the list of available licenses is displayed, ensure that Available is selected
below the License Server address field.
From the list of available licenses, select the licenses you need.
In the Check out licenses for (days) field, enter the number of days for which you need
the commuter license.
Maximum = 180 days
Click Check Out, and then Next to install the license.
Return a Commuter license
If you do not want to return all the licenses that you checked out, you must still return all
your checked out commuter licenses and then re-check out the licenses you need.
1. Prerequisite: Make sure you are connected to the network and can access the
License Server.
Alternative, if you cannot access the License Server: "Check out and install a
Remote Commuter license" below
2. Select Commuter License.
3. In the Commuter License Installation screen, the License Server address should
already be displayed and connected.
If needed, enter the License Server address in the following format:
<license server address>:<port>
Default port = 5814
The address format must identical the one used in the Main tab of the License
Server Configuration pane.
For details, see the Autopass License Server User Guide.
4. After the list of available licenses is displayed, ensure that Checked Out is selected
below the License Server address field.
5. Click Check In All Licenses , and then Next. The list of checked out licenses is
cleared.
Check out and install a Remote Commuter license
Remote commuter licenses can be checked out only if your License Server has
available concurrent licenses.
HPE Unified Functional Testing (14.00)
Page 48 of 60
Installation Guide
UFT licensing
1. In the License Wizard start screen, select Additional Options > Remote Commuter
license.
2. In the Remote Commuter License Installation screen, ensure that Generate Request
File is selected.
3. From the list of available licenses, select the license you need.
4. In the Check out licenses for (days) field, enter the number of days for which you need
the commuter license.
Maximum = 180 days
5. Click Generate Request File.
Send the generated .lcor request file to a License Server administrator or to a user
with access permissions to the License Server.
The other user must check out and send you a license key file.
6. Save the file, and then click Choose File to browse to the file you received.
7. Click Install to install the license.
Return a Remote Commuter license
1. In the License Wizard start screen, select Additional Options > Remote Commuter
license.
2. In the Remote Commuter License Installation screen, ensure that Generate Request
File is selected.
3. In the Generation screen, click Generate and Save Check In Request, and save the
.lcir check in request file.
4. Click Next to uninstall the license.
The license wizard reports that the remote commuter license is uninstalled. UFT reverts
to the previous license type as the active license.
Install licenses from the command line
Install and verify the statuses of seat or concurrent licenses directly from the command
line.
Enter the following command, followed by a set of parameters described below.
"<UFT installation directory>\bin\HP.UFT.LicenseInstall.exe"
In this topic:
l
l
l
l
"Install a Seat license (command line)" on the next page
"Install a Concurrent license (command line)" on the next page
"Modify server connection details" on page 51
"Verify available licenses" on page 51
HPE Unified Functional Testing (14.00)
Page 49 of 60
Installation Guide
UFT licensing
Install a Seat license (command line)
Add one of the following to install a UFT seat license:
l
seat "<license key string>"
l
seat "<path to the license key file"
For example:
Install a seat license key from a file saved locally:
"C:\Program Files (x86)\HPE\UFT \bin\HP.UFT.LicenseInstall.exe" seat
"Downloads\HP UFT-licfile.dat"
Install a seat license key from a license key string:
"C:\Program Files (x86)\HPE\UFT\bin\HP.UFT.LicenseInstall.exe" seat "9CDG C9MA H9P9
8HW3 UXB5 HWWF Y9JL KMPL B89H MZVU 6R4Q LHWE JHRP 3FQ3 CMRG HPMR MFVU A5K9 MWEC EKW9
HKDU LWWP SRL7 QPJQ YMM5 YQVW NV6G AG2A QZWD HY9B N4ZF BGWB B8GX 7YRF T8XT W7VB QW54
G83H 2TRY KBTD EQUZ M8LB DZU7 WE6H 4NMU BG55 4XKB 27LX ATQB UKF8 3F9N JQY5 \" HPE
Unified Functional Testing Seat User
Note: If the license key contains a quotation mark character (") in the license key
string, add a backslash character (\) before the quotes.
Install a Concurrent license (command line)
Add the following to install a UFT concurrent license:
concurrent <license ID> <license version> <server name/address> [<redundant server
name/address>] [/force]
Use the following format for the server or redundant server name/address:
<license server address>:<port>
Default port = 5814
The address format must identical the one used in the Main tab of the License Server
Configuration pane.
For details, see the Autopass License Server User Guide.
For example:
"C:\Program Files (x86)\HPE\UFT\bin\HP.UFT.LicenseInstall.exe" concurrent
HPE Unified Functional Testing (14.00)
Page 50 of 60
Installation Guide
UFT licensing
11.11.111.111:5814 /force
/force
parameter
The /force parameter saves the license installation information even if
the current installation fails.
In subsequent sessions, LeanFT will check the listed license server
for the listed license.
Optional
parameters
Optional parameters include:
l
l
l
port
redundant server name/address
force
Modify server connection details
Add one of the following:
Modify the primary License Server address
config protocol.primary <http/https>
Modify the secondary License Server address
config protocol.second <http/https>
Verify available licenses
Add the following:
licenses <server name/address> [<redundant server name address>]
For example:
"C:\Program Files (x86)\HPE\UFT\bin\HP.UFT.LicenseInstall.exe" licenses
11.11.111.111:5814
UFT licensing FAQs
This topic answers a number of frequently asked questions about using and installing
UFT licenses.
Information in this Help Center describes how you can use the Autopass License Server
from UFT. For full details on Autopass License Server capabilities, such as proxy
settings, license installation and management, and user management, see the Autopass
License Server User Guide.
In this topic:
HPE Unified Functional Testing (14.00)
Page 51 of 60
Installation Guide
UFT licensing
l
l
l
l
l
l
l
l
l
l
l
l
"Can I use my old license (from before UFT 12.50) with the new License Server?"
below
"How do I get a new license?" below
"Which license should I install?" on the next page
"How do I install the Autopass License Server?" on the next page
"If I am using concurrent licenses, how do I get UFT to work with the License Server?"
on the next page
"How do I install licenses if I am deploying UFT across an enterprise network?" on
page 54
"How do I manage the concurrent licenses on the License Server?" on page 54
"Can I configure license behavior myself?" on page 54
"Can I set up my License Server to work with a redundant (backup) License Server?"
on page 55
"Can I use the Autopass License Server with a proxy?" on page 55
"What is a cleanup license?" on page 55
"My demo license is expiring early. What can I do?" on page 55
Can I use my old license (from before UFT 12.50)
with the new License Server?
No. UFT 12.50 has changed the license mechanism and the concurrent license server
to the Autopass License Server.
Prior versions of UFT used the Sentinel Concurrent License Server.
Note: The Autopass License Server and accompanying documentation is
provided with the UFT Setup program.
In order to use your licenses with versions of UFT 12.50 and later, or to install them on
the Autopass License Server, you must upgrade your licenses.
For details, see the topic on upgrading licenses in the Unified Functional Testing
Installation Guide.
How do I get a new license?
In order to use UFT 12.50 and higher, you have to upgrade your license. This enables
you to convert your old license to a license compatible with UFT 12.50 and higher and
the new Autopass License Server.
You upgrade your license through the HPE Licensing portal.
HPE Unified Functional Testing (14.00)
Page 52 of 60
Installation Guide
UFT licensing
For details, see the topic on upgrading licenses in the Unified Functional Testing
Installation Guide.
Which license should I install?
In UFT, you can install a number of different license types. The following table should
help you to identify the one to install.
Scenario
License Type to Install
Are you assigned a specific license (with
its own unique license key)?
Seat
Are you part of a group that uses licenses
on an as-needed basis?
Concurrent.
Are you assigned the IP address from
which to check out a license?
Concurrent
Are you traveling and will not have
access to a license server?
Commuter
Are you already traveling and cannot
access the License Server to get a
license?
Remote Commuter
You will need the IP address of your
License Server where the licenses are
installed.
How do I install the Autopass License Server?
For full details, see the Autopass License Server User Guide.
If I am using concurrent licenses, how do I get UFT to
work with the License Server?
In the UFT License Wizard, if you select Concurrent license, you must enter the License
Server IP address.
This checks the connection between UFT and the License Server, and also gives you a
list of possible licenses to install.
After you initially install the license, UFT checks the specified License Server address
each time UFT starts and takes the requested license.
HPE Unified Functional Testing (14.00)
Page 53 of 60
Installation Guide
UFT licensing
How do I install licenses if I am deploying UFT across
an enterprise network?
UFT provides a command-line tool that enables you to install UFT licenses without
using the License Wizard interface.
For details on the commands to install these licenses, see "Install licenses from the
command line" on page 49.
The command line license installation is supported for seat and concurrent licenses.
How do I manage the concurrent licenses on the
License Server?
The Autopass License Server has a full Web-based interface that enables you to install,
manage, and administer all your licenses (both concurrent and commuter).
For full details, see the Autopass License Server User Guide.
Tip: Use the HPE Usage Hub tool to track license usage across your network.
Can I configure license behavior myself?
Yes.
Change the values for general license behavior in the Autopass license configuration
file.
This file is located at C:\ProgramData\Hewlett-Packard\UFT\License\autopass.txt, and
includes details about possible values.
Caution: Configure this file with caution.
Incorrect configuration may cause UFT to behave unexpectedly, or prevent UFT
from starting.
Additionally, if your concurrent license server has multiple license editions installed, you
can enable a fallback mechanism to ensure that you can your product can find an
available license.
For details, see "License editions" on page 41.
HPE Unified Functional Testing (14.00)
Page 54 of 60
Installation Guide
UFT licensing
Can I set up my License Server to work with a
redundant (backup) License Server?
Yes. You need to install the License Server on two separate servers, and then set one
server to be the primary and the other to be the redundant server. This configuration is
done in the Autopass License Server Web UI.
You also can supply this information to UFT in the License Wizard, which enables UFT
to take a concurrent license from the redundant License Server in the event that the
primary License Server is not available.
For full details, see the Autopass License Server User Guide , accessible from the
Autopass License Server User Guide.
Back to top
Can I use the Autopass License Server with a proxy?
Yes. Beginning with AutoPass License Server version 9.3, connection to the License
Server with a proxy is supported. You set the proxy settings in the autopass.txt file,
located at C:\ProgramData\Hewlett-Packard\UFT\License\autopass.txt. See the comments
inside this file for details on setting the proxy settings.
What is a cleanup license?
If your computer is clock-tampered after installing the License Server, both the License
Server and UFT's connection to the License Server do not work.
In this case, you must get a cleanup license for your License Server. This enables you
to reset all license capabilities.
For details on cleanup licenses, contact your HPE license supplier.
My demo license is expiring early. What can I do?
If you are having problems with the trial license period (60 days maximum), ensure the
following:
l
l
Ensure that you have full permissions to the C:\ProgramData\Hewlett-Packard\UFT
folder and all its subfolders
Ensure that you have not changed the system time. If you have moved the system
time, the license mechanism can reduce the trial period based on the number of days
that were back-dated.
Known issues with UFT licensing
Relevant for: GUI testing and API testing
HPE Unified Functional Testing (14.00)
Page 55 of 60
Installation Guide
UFT licensing
Modifying
the
computer
date
If you install a time-limited seat license, do not modify the date on your
computer.
Doing so will block your active seat license and prevent future UFT
seat license installations on that computer.
For questions about this issue, contact your HPE license supplier.
NAT
The License Server does not support the use of Network Address
Translation (NAT).
Demo
licenses
The concurrent license does not include a demo license and does not
work without an active connection to a License Server and an installed
license key.
Changing
types
You must have administrator permissions to change the license type
from seat to concurrent or vice versa.
HPE Unified Functional Testing (14.00)
Page 56 of 60
Installation Guide
Before connecting to ALM
Before connecting to ALM
Before connecting to ALM, you may need to modify User Account Control (UAC)
settings. You can revert these modifications afterward.
You must perform this procedure if you intend on running UFT tests remotely from ALM,
and are running UFT on one of the following operating systems:
l
l
l
l
l
Windows 7
Windows Server 2008
Windows Server 2008 R2
Windows 8.x and higher
Windows Server 2012
Note: The security changes described in this section should be performed by your
System Administrator.
Contact Microsoft Support if you have questions regarding changes in User
Account Control (UAC) on any of these operating systems.
For Microsoft Windows 7 and Windows Server 2008 R2
1. Log in as an administrator.
2. From the Control Panel, select User Accounts > User Accounts > Change User
Account Settings .
3. In the User Account Control Settings window, move the slider to Never notify .
4. Restart the computer to enable this setting to take effect.
For Microsoft Windows 8.x and higher and Windows Server 2012
1. Log in as an administrator.
2. From the Control Panel, select User Accounts and Family Safety > User Accounts >
Change User Account Control Settings .
3. In the User Account Control Settings window, move the slider to Never notify .
4. In the Control Panel, select System and Security > Administrative Tools > Local
Security Policy .
5. In the Local Security Policy window, in the left pane, select Local Policies .
6. In the Local Policies tree, select Security Options .
7. In the right pane, select the User Account Control: Run all administrators in Admin
Approval mode option.
8. Select Action > Properties from the menu bar.
HPE Unified Functional Testing (14.00)
Page 57 of 60
Installation Guide
Before connecting to ALM
9. In the dialog that opens, select Disabled.
10. Restart the computer for your changes to take effect.
Enable UAC again if required
After connecting to ALM, return to the User Account Control Settings window.
Restore the slider to its previous position to turn the UAC option on again.
Restart the computer for your changes to take effect.
HPE Unified Functional Testing (14.00)
Page 58 of 60
Send Us Feedback
Let us know how we can improve your experience with the Installation Guide.
Send your email to: docteam@hpe.com
HPE Unified Functional Testing (14.00)
Page 59 of 60

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project