uft install guide

HPUnified Functional TestingFor the Windows operating systems

Software Version: 12.00

Installation Guide

Document Release Date: March 2014

Software Release Date: March 2014

Legal NoticesWarranty

The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should beconstrued as constituting an additional warranty. HP 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 LegendConfidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial ComputerSoftware, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commerciallicense.

Copyright Notice Copyright 1992 - 2014 Hewlett-Packard Development Company, L.P.

Trademark NoticesAdobe and Acrobat are trademarks of Adobe Systems Incorporated.

Apple and the Apple logo are trademarks of Apple Computer, Inc., registered in the U.S. and other countries.

Google andGoogleMaps are trademarks of Google Inc

Intel and Pentium are trademarks of Intel Corporation in the U.S. and other countries.

Microsoft, Windows, Windows XP, andWindows Vista are U.S. registered trademarks of Microsoft Corporation.

Oracle and Java are registered trademarks of Oracle and/or its affiliates.

Documentation UpdatesThe title page of this document contains the following identifying information:

l Software Version number, which indicates the software version.l Document Release Date, which changes each time the document is updated.l 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 themost recent edition of a document, go to: http://h20230.www2.hp.com/selfsolve/manuals

This site requires that you register for an HP Passport and sign in. To register for an HP Passport ID, go to: http://h20229.www2.hp.com/passport-registration.html

Or click theNew users - please register link on the HP Passport login page.

You will also receive updated or new editions if you subscribe to the appropriate product support service. Contact your HP sales representative for details.

SupportVisit the HP Software Support Online web site at: http://www.hp.com/go/hpsoftwaresupport

This web site provides contact information and details about the products, services, and support that HP Software offers.

HP Software online support provides customer self-solve capabilities. It provides a fast and efficient way to access interactive technical support tools needed tomanageyour business. As a valued support customer, you can benefit by using the support web site to:

l Search for knowledge documents of interestl Submit and track support cases and enhancement requestsl Download software patchesl Manage support contractsl Look up HP support contactsl Review information about available servicesl Enter into discussions with other software customersl Research and register for software training

Most of the support areas require that you register as an HP Passport user and sign in. Many also require a support contract. To register for an HP Passport ID, go to:

http://h20229.www2.hp.com/passport-registration.html

To findmore information about access levels, go to:

http://h20230.www2.hp.com/new_access_levels.jsp

HP Software Solutions Now accesses the HPSW Solution and Integration Portal Web site. This site enables you to explore HP Product Solutions tomeet yourbusiness needs, includes a full list of Integrations between HP Products, as well as a listing of ITIL Processes. The URL for this Web site ishttp://h20230.www2.hp.com/sc/solutions/index.jsp

Installation Guide

HP Unified Functional Testing (12.00) Page 2 of 63

About the Installation GuideTheHP Unified Functional Testing Installation Guide provides a complete, step-by-stepinstructions on how to install and set up UFT on a standalone computer.

Prerequisite BackgroundThis guide is intended for users who need to install and set up UFT and for administrators who wantto set up a silent installation for users in their organization.

UFT Guides and ReferencesThe following tables provide a list of the UFT guides, online help and references:

Note: To check for recent updates of any of the guides below, visit the HP Software ProductManuals Web site (http://h20230.www2.hp.com/selfsolve/manuals).

Getting started

Reference Description

What'sNew?

Describes the newest features in the latest version of Unified Functional Testing.

You can also access theWhats New from theUnified Functional Testing Helpmenu.

ProductMovies

Click the link or select Help > Product Feature Movies to view short movies thatdemonstrate themain product features.

Readme Provides last-minute news and information about Unified Functional Testing.

For the latest readme file, go to the HP SoftwareManuals Web site (requires anHP Passport) at http://support.openview.hp.com/selfsolve/manuals.

UFT PAM The Product Availability Matrix (PAM) provides current information abouttechnologies and integrations supported for this version of UFT.

GUITestingTutorial

TheGUI Testing Tutorial is a self-paced printable guide, designed to lead youthrough the process of creating GUI tests and familiarize you with the testingenvironment.

API TestingTutorial

The API Testing Tutorial is a self-paced printable guide, designed to lead youthrough the process of creating API tests in theWindows environment.

Installation GuideAbout the Installation Guide


PDF guides

Guide Description

UFT UserGuide

The HP Unified Functional Testing User Guide describes howto use UFT to test your applications. It provides step-by-stepinstructions to help you create, debug, and run tests, andreport defects detected during the testing process.

Run ResultsViewer

The HP RunResults Viewer User Guide explains how to usethe Run Results Viewer to interpret and use the test resultsfrom your GUI or API tests.

UFTInstallationGuide

The HP Unified Functional Testing Installation Guideprovides a complete, step-by-step instructions on how toinstall and set up UFT on a standalone computer.

UFTQuickStart

The UFT Installation QuickStart Sheet explains the steps toperform a basic installation of UFT.

License ServerInstallationGuide

The Concurrent License Server Installation Guide providesthe information you need to install andmaintain theHPFunctional Testing Concurrent License Server.

UFT Add-insGuide

The HP Unified Functional Testing Add-ins Guide explainshow to set up support for UFT add-ins and standardWindowstesting support. Add-ins enable you to test any supportedenvironment using GUI tests and business components.

References

Links to the references are available from the UFT online help home page.


Object ModelReference

TheObject Model Reference for GUI Testing includes a description, a list ofmethods and properties, syntax, examples, and identification properties foreach UFT test object.

VBScriptReference

Microsoft's Visual Basic Scripting documentation that describes objects,methods, properties, functions, and other elements that can be used whenwriting VBScript scripts.

AutomationObject ModelReference

List the objects, methods, and properties that enable you to control UFT fromwithin another application.




ObjectRepositoryAutomationReference

Describes the objects that enable you tomanipulate UFT shared objectrepositories and their contents from outside of UFT.

Run ResultsSchemaReference

Provides details about the structure of the Run Results XML schema, anddescribes the elements and attributes used in the its XML reports.

Test ObjectSchemaReference

A reference describing the elements and attributes available for creating testobject configuration XML content, for use when creating UFT extensibilityprojects.

ObjectRepositorySchemaReference

Describes the elements and complex types defined for the object repositoryschema.

Additional Online ResourcesThe following additional online resources are available from the Unified Functional Testing Helpmenu:

Resource Description

HP SoftwareSupport Online

Opens the HP Software Support Web site. This site enables you to browsethe HP Software Self-solve knowledge base. You can also post to andsearch user discussion forums, submit support requests, download patchesand updated documentation, andmore. ChooseHelp > HP SoftwareSupport. The URL for this Web site www.hp.com/go/hpsoftwaresupport.

l Most of the support areas require that you register as an HP Passportuser and sign in. Many also require a support contract.

l To findmore information about access levels, go to:http://h20230.www2.hp.com/new_access_levels.jsp

l To register for an HP Passport user ID, go to:http://h20229.www2.hp.com/passport-registration.html



Resource Description

Testing Forums Opens the testing forums for GUI Testing, API Testing, and BPT Testingforums. where you can interact with other users of UFT and discuss topicsrelated to GUI Testing, API Testing, and BPT.

The URLs for these sites are:

l GUI Testing:http://h30499.www3.hp.com/t5/Unified-Functional-Testing/bd-p/sws-Fun_TEST_SF

l API Testing: http://h30499.www3.hp.com/t5/Service-Test-Support-and-News/bd-p/sws-Serv_TEST_SF

l BPT:http://h30499.www3.hp.com/t5/Business-Process-Validation/bd-p/sws-BPT_SF

UFT ProductPage

Opens the HP Unified Functional Testing product page, with information andrelated links about UFT.

Troubleshooting& KnowledgeBase

Opens the Troubleshooting page on the HP Software Support Web sitewhere you can search the HP Software Self-solve knowledge base. ChooseHelp > Knowledge Base orHelp > Troubleshooting. The URL for thetroubleshootingWeb site ishttp://h20230.www2.hp.com/troubleshooting.jsp.

HP SoftwareCommunity

Opens the HP ITExperts Community site, where you can interact with otherHP software users, read articles and blogs on HP software and accessdownloads of other software products.

HPManuals Site Opens the HP Software Product Manuals Web site, where you can searchfor themost up-to-date documentation for a selected HP Software product.The URLfor this Web site ishttp://support.openview.hp.com/selfsolve/manuals (requires an HPPassport).

What's New Opens the UFTWhat's New Help, describing the new features andenhancements in this version of UFT.

Product Movies Opens a page on HPLN(HPLive Networks) displaying a list of all productmovies.

HP SoftwareWeb site

Opens the HP SoftwareWeb site. This site provides you with themost up-to-date information on HP Software products. This includes new softwarereleases, seminars and trade shows, customer support, andmore. The URLfor this Web site is www.hp.com/go/software.

You can access the following sample applications from theStartmenu. These applications are thebasis for many examples in this guide:



l Mercury Tours sampleWeb site. The URL for this Web site is http://newtours.demoaut.com.

l Mercury Flight application. To access from the Start menu, select All Programs > HPSoftware > HP Unified Functional Testing > Sample Applications > Flight API / FlightGUI.



Chapter 1: Before You InstallWelcome to HPUnified Functional Testing, the advanced keyword-driven testing solution forfunctional test and regression test automation. UFT is part of HPALM. This guide describeseverything you need to know to install UFT on a standalone computer.

Note: Unless otherwise specified, references toApplication Lifecycle Management orALMin this guide apply to all currently supported versions of ALM andQuality Center. Note thatsome features and options may not be supported in the specific edition of ALM or QualityCenter that you are using.

For a list of the supported versions of ALM or Quality Center, see theHP Unified FunctionalTesting Product Availability Matrix, available from the UFT Help or the root folder of the UnifiedFunctional Testing DVD. Themost up-to-date product availability matrix is available from theHP Software Product Manuals site, at http://h20230.www2.hp.com/selfsolve/manuals(requires an HP Passport).

For details on ALM or Quality Center editions, see theHP Application Lifecycle ManagementUser Guide or theHP Quality Center User Guide.

Before you install UFT, confirm that your computer meets all system requirements. For details, seetheHP Unified Functional Testing Readme.

Youmust not run any other installation at the same time as you run the UFT installation. In addition,you should ensure before you install UFT that your computer is not in a state that requires a restart.If this is the case, the installation will not run.

This chapter includes:

Setting Required Access Permissions 9

Considerations WhenUpgrading from QuickTest or Service Test 11

Enterprise Deployment of UFT 11


Setting Required Access PermissionsYoumust make sure the following access permissions are set to run UFT or to work with ALM.

Permissions Required When Working with UFTYoumust have the following file system permissions:

l Full read and write permissions to the Temp folder

l Read permissions to theWindows folder and to the System folder

l Full read and write permissions to the folder on which you are saving solutions, tests, or runresults

l Full read and write permissions to the \Common Files\MercuryInteractive folder

l If you are working on theWindows Vista, Windows 7, orWindows Server 2008 operatingsystems:Full read and write permissions to the \HP folder

l Full read and write permissions to the User Profile folders

l Full read and write permissions to the \mercury.ini file

l Full read and write permissions to the following AppData folders:

n %userprofile%\AppData\Local\HP

n %appdata%\Hewlett-Packard\UFT

n %appdata%\HP\API Testing

Note: Read/write permissions to these folders should also enable permission to anysubfolders contained in the folders listed above. If not, the system administrator mustgrant administrative permissions to the subfolders contained in these folders.


Youmust have the following registry key permissions:

l Full read and write permissions to the keys uder HKEY_CURRENT_USER\Software\MercuryInteractive or [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Hewlett-Packard]

l Full read and write permissions to all the keys under HKEY_CURRENT_USER\SOFTWARE\HewlettPackard

l Read andQuery Value permissions to all the HKEY_LOCAL_MACHINE and HKEY_CLASSES_ROOTkeys

Permissions Required When Working with ALMYoumust have the following permissions to use UFT with ALM:

l Full read and write permissions to the ALM cache folder

l Full read and write permissions to the \HPfolder

l Full read and write permissions to the UFT Add-in for ALM installation folder

l Administrative permissions for the first connection to ALM

Note: If you do not have administrative permissions, you can turn off the UAC for your useraccount instead in order to perform the first connection to ALM.

Permissions Required When Working with BPTThe ALM Project Administrator can control access to a project by defining which users can log in toit and by specifying the types of tasks each user may perform. The ALM Project Administrator canassign permissions for adding, modifying, and deleting folders, components, steps, and parametersin the Business Components module of an ALM project.

You need tomake sure you have the required ALM permissions before working with businesscomponents and application areas.

l Towork with component steps in ALM, youmust have the appropriateAdd Step,Modify Step,orDelete Step permissions set. You do not needModify Component permission to work withcomponent steps. TheModify Component permission enables you to work with componentproperties (the fields in the component Details tab).

l Towork with parameters in ALM or in a testing tool, youmust have all the parameter taskpermissions set in ALM.

l Tomodify application areas, youmust have the separate permissions for resources required formodifying components, and adding, modifying, and deleting steps. All four permissions arerequired. If one of these permissions is not assigned, you can open application areas only inread-only format.

Installation GuideChapter 1: Before You Install


Formore information on setting user group permissions in the Business Components module, seetheHP Business Process Testing User Guide.

Considerations When Upgrading from QuickTest orService Test

l You can automatically install UFT12.00 from QuickTest versions 9.5/Service Test 10.00 orlater. You are prompted to accept the automatic installation. If you click Yes, the installerautomatically uninstalls the previous version of QuickTest or Service Test and reinstalls UFT11.50. The previous version of QuickTest or Service Test is uninstalled.

l If you are upgrading to UFT12.00 from a version earlier thanQuickTest 9.5 or Service Test10.00, youmust first manually uninstall your current QuickTest or Service Test version and theQuickTest Add-in for ALM/QC. Otherwise, the installation process will not run. At the end of theuninstall process, restart your computer and install the new version and add-in.

l UFT supports the Sentinel RMS LicenseManager version 8.4.0 as its concurrent license server.If you are upgrading to UFT with a concurrent license, youmust also upgrade your concurrentlicense server. For details on setting up a concurrent license server, see theHPFunctionalTesting Concurrent License Server Installation Guide.

l License data is retained when upgrading from QuickTestProfessional version 9.5 or ServiceTest 10.00 or later. However, if you have not installed a license before the upgrade, youmust runthe LicenseWizard as part of the installation.

l All GUI Testing add-ins that were installed in QuickTest version 9.5 are identified during theupgrade and checked by default in the feature selection page of the installation. You can add orremove add-ins during the installation.

l All QuickTest settings defined in Tools > Options (in your version of QuickTest)are retained.

l Connection settings to ALM are not retained by the upgrade process. If required, youmustreconnect to ALM after the installation. To install the latest version of the ALM Add-in, youmustmanually uninstall the previous version of the Add-in before installing the latest version.

Enterprise Deployment of UFTWhen installing UFT in an enterprise business model across many computers in a network orcompany, note the following:

l Ensure you have administrator permissions on each the computers on which you are installingUFT.

l Make sure you have access to the necessary folders and registry keys. For a list of thenecessary access permissions, see "Setting Required Access Permissions" on page 9.



l You can install UFT (either through the wizard or silently) without turning off the computer's UserAccount Control (UAC).

For details on installing UFT through the installation wizard, see "Installing Unified FunctionalTesting" on page 15.For details on the silent installation, see "Installing UFT Silently" on page19.

l If the eventual user of the UFT computer needs connect to ALM through UFT, you can install theUFT Add-in for ALM as part of the installation, in theCustom Setup screen, or the ADDLOCALsilent installation parameter.

However, to connect to ALM from UFT for the first time without turning off the UAC, youmustalso install the ALM client MSI file on each user's machine. You can generate a customMSIforall your users by using these HP ALM Client MSIGenerator. This tool enables you to configurethe settings for your ALM servers before installing the client-sideMSI.

You can download the ALM Client MSIGenerator and User Guide fromhttps://hpln.hp.com/page/hp-alm-client-msi-generator. Instructions for configuring the settingsfor a customMSIare provided in the user guide.

IMPORTANT:When configuring the settings, youmust select theCheck IncludeComponent Registration andUse Shared Deployment Mode options.

After the customMSI is installed on each user's machine, they can connect to ALM withouttemporarily deactivating the UAC for their user account.

l Post-installation configuration is also part of the standard installation. You can either select thepost-installation configurations in theUFTConfiguration screen of the installation wizard oradd the configuration options as a silent installation argument. For details on setting the post-installation configuration silent installation arguments, see "Setting UFT configuration options"on page 24.

l If your users are using either the Stingray or Terminal Emulator add-ins, there are additionalconfiguration you or the user must perform:

n You can run the Additional Installation Requirements after themain installation on eachcomputer. This tool is found in theStartmenu (Start >All Programs >HP Software >HPUnified Functional Testing >Tools >Additional Installation Requirements).

In the Additional Installation Requirements, select theRun Stingray Wizard and/orRunTerminal Emulator Wizard options, and follow the configuration wizard steps to set up theadd-ins.

n If you want your users to perform the configurations:

o For the Stingray add-in, the user runs the Stingray Support ConfigurationWizard in theStingray pane of the Options dialog box (Tools >Options >GUI Testing tab >Stingraypane >Select Version). This configuration requires no administrative permissions.



o For the Terminal Emulator add-in, you can run the configuration one time withadministrator permissions, and save the settings to a registry file which can be deployedon all the computers.

To copy and deploy the settings, do the following:

o In the final screen of the Terminal EmulatorWizard, select theSave terminalemulator settings to file option.

Note: Before you copy the saved configuration, make sure you know the vendorname and the emulator name assigned to the configuration, and the exact nameand location of the file. The file has a .reg extension.

o Copy the file to the \dat folder on your computer.

o Double-click the registry file to open the Registry Editor message box.

o Click Yes to add the information into the registry. A message opens confirming thatthe information has been copied into the registry.

o Click OK. The emulator name assigned to this configuration is added to the list ofavailable terminal emulators for your UFT installation.

o For the Terminal Emulator, the user must have administrator permissions. Each user canrun the Terminal Emulator configuration wizard from the Terminal Emulator pane of theOptions dialog box (Tools > Options > GUI Testing tab >Terminal Emulator pane >Open Wizard).



Chapter 2: Installing UFTWhen you install UFT, youmust know which features and add-ins you want to use. The basicinstallation process automatically installs UFT and theWeb, Visual Basic, and ActiveX Add-ins,and you can also select which additional add-ins to install. You can also set up UFT to installsilently (in the background), and on remote computers.

Youmust also know which type of license you want to install. A Seat license is a permanentlicense that is specific to the computer on which the license is installed, and aConcurrent licenseis a per session license that is available only if your company has an HPFunctional TestingConcurrent License Server. For more details, see "Working with UFT Licenses" on page 28.

You can install UFT from aDVDor download and install from theWeb. The installation processremains the same regardless of from where you install UFT.


Installing Unified Functional Testing 15

Installing a Localized Version of UFT 17

Installing UFT Silently 19

Troubleshooting and Limitations-Installing/Uninstalling UFT 26


Installing Unified Functional TestingYour UFT DVD or setup program (if you downloaded theWeb installation) includes an installationprogram that guides you through the installation process.

Prerequisites:

1. Make sure you are logged on with Administrator privileges.

2. Select a local drive on which to install UFT. Do not install UFT on a network drive.

3. If you are installing UFT from theWeb download, youmust have access to the Internet todownload the necessary prerequisite software.

4. If you plan to run tests of aWeb service using security created using Service Test or earlierversions of UFT, youmust have the .NET Framework 3.5, WSE2.0sp3 package, andWSE3.0 package installed on your computer.

These prerequisites are not provided with the UFT installation. If they are not installed on yourcomputer, you can install them from the following locations on the DVD:

n NET 3.5 Framework: DVD/prerequisites/dotnet35_1/donetfx35_sp1.exe

n WSE 2.0 sp3: DVD/prerequisites/wse20sp3/MicrosoftWSE2.0SP3Runtime.msi

n WSE 3.0: DVD/prerequisites/wse30/MicrosoftWSE3.0Runtime.msi

To install UFT, do the following:

1. When the Unified Functional Testing Setup window opens, select Unified FunctionalTesting Setup.

Note: If you are installing only the Unified Functional Testing Testing Add-in for ALM orthe Run Results Viewer, choose the appropriate setup option.

The Unified Functional Testing InstallationWizard opens.

Important:You cannot install the UFT Add-in for ALM or the Run Results Viewerseparately after you install UFT.


2. Follow the steps in the wizard to complete your installation.

Note the following special considerations as you use the installation wizard:

n In theCustom Setupwindow, do the followingas needed:

Select the GUI Testing add-ins or theUFT Add-in for ALM to install. Choose from thefollowing options to install these features:

o Will be installed on local hard drive. Installs the selected feature on your localhard drive. Sub-features of the selected feature are not installed.

o Entire feature will be installed on local hard drive. Installs the entireselected feature and its sub-features on your local hard drive. For example, you caninstruct UFT to install the .NET Add-in with its sub add-ins, Silverlight andWindowsPresentation Foundation.

o Entire feature will be unavailable. Excludes the feature from the installation andit is not available in UFT.

n In theUFT Configuration window, select the necessary configuration options:

o Configure Internet Explorer settings. Select this check box to automaticallyconfigure the Internet Explorer options that enable UFT to use theMicrosoft ScriptDebugger application during test runs.

You can also configure these options manually before running UFT. In InternetExplorer, select Tools > Internet Options > Advanced. Then select Disablescript debugging andEnable third-party browser extensions.

o Configure DCOM settings for ALM Integration. Select this check box toautomatically change DCOM permissions and security settings and open a firewallport on your UFT computer. These changes are only required if you want to run UFTtests remotely from ALM, and are running UFT onWindows 7.

If you need to set these options manually, see "Modifying DCOM PermissionsManually to Enable Remote UFT Execution" on page 51.

You can also automatically configure DCOM later by running the AdditionalInstallation Requirements tool (Start > All Programs >HP Software > HPUnified Functional Testing > Tools > Additional Installation Requirements) orrunning the Remote Agent (\bin\AQTRmtAgent.exe).

Installation GuideChapter 2: Installing UFT


o Configure DCOM settings for Automation Scripts. Select this check box toautomatically change DCOM permissions and security settings to enable anothercomputer to remotely control UFT using automation scripts.

Caution: Selecting this option enables remote users to control UFT on thismachine, exposing the UFT computer to security risks.

For information on how to configure this optionmanually, see "To disable group-wideremote DCOM execution of UFTscripts:" on page 55.

o Download and Install Microsoft Script Debugger. Provides the debuggingenvironment that UFT uses during test runs. This item is displayed only when notcurrently installed.

When UFT is done installing, you can view the Readme file as well as an log of all installationdetails. In some situations, youmay be prompted to restart your computer after you have installedUFT. It is recommended that you restart your computer as soon as possible if you are prompted todo so. Delaying the system restart may result in unexpected UFT behavior.

Installing a Localized Version of UFTIf you are installing UFT on a computer using a language other than English, your installation setupand wizard automatically runs in the language of your computer.

By default UFT is installed in the same language as your computer's operating system. If you wantto install UFT in English instead of the language of your operating system, you can do so in theLicense Agreement screen of the installation.

You can install UFT in the following languages:

l Brazilian Portuguese

l Chinese

l Dutch

l French

l German

l Italian

l Japanese

l Korean



l Russian

l Spanish



Installing UFT SilentlyA silent installation (or quiet installation) is an installation that is performed in the background. Youcan install UFT, UFT Add-ins, and the ALM Add-in silently on your computer or a remote computer,without the need to navigate through setup screens or for user interaction.

Youmust have administrator privileges to install UFT and the ALM Add-in silently.

The following sections list the steps necessary to perform a silent installation of UFT and UFT Add-ins.

Installing the Prerequisite Software for UFT 19

Installing UFTSilently 20

Installing the Prerequisite Software for UFTThe following prerequisite software is required to be installed on your computer before you installUFT and UFT Add-ins. This software is available on the UFT installation DVD, and can be installedfrom the command line.

In order to install all prerequisites silently, run the following command in the command line:

DVD\Unified Functional Testing\EN\setup.exe /InstallOnlyPrerequisite /s (if youare installing from aDVD)

or

\Unified Functional Testing\EN\setup.exe/InstallOnlyPrerequisite /s (if you are installing from theWeb download)

You can also install the prerequisite software individually, using the following syntax:

UFT:

Note: If you are installing UFT from theWeb download, make sure to change DVDto thedownload directory you used.

Prerequisite Silent Command Line Syntax

.NETFramework4.5

DVD\prerequisites\dotnet45\dotnetfx45_full_x86_x64.exe /q/norestart /c:"install /q" /LCID

MicrosoftAccess databaseengine 2010

DVD\prerequisites\msade2010\AccessDatabaseEngine.exe/quiet


Microsoft WSE2.0 SP3 Runtime

DVD\prerequisites\wse20sp3\MicrosoftWSE2.0SP3Runtime.msi/quiet/norestart ALLUSERS=1

Microsoft WSE3.0 Runtime

DVD\prerequisites\wse30\MicrosoftWSE3.0Runtime.msi/quiet/norestart ALLUSERS=1

Microsoft VisualC++ 2010 Run-timeComponents for32/64 bitOperatingSystems

DVD\prerequisites\vc2010_redist\vcredist_x86.exe/q (for 32-bitmachines

DVD\prerequisites\vc2010_X64_redist\vcredist_x86.exe/q (for 64-bit machines)

Microsoft C++2012Redistributable

DVD\prerequisites\vc2012_redist_x86\vcredist_x86.exe/quiet/norestart (for 32-bit machines)

DVD\prerequisites\vc2012_redist_x64\vcredist_x64.exe/quiet/norestart (for 64-bit machines)

UFT Add-in for ALM:

Note: If you are installing UFT from theWeb download, make sure to change DVDto thedownload directory you used.

Prerequisite Silent Command Line Syntax

.NETFramework 4.5 DVD\prerequisites\dotnet45\dotnetfx45_full_x86_x64.exe/q /norestart /c:"install /q" /LCID

Microsoft Visual C++2012 Redistributable

DVD\prerequisites\vc2012_redist_x86\vcredist_x86.exe/quiet /norestart (for 32-bit machines)

DVD\prerequisites\vc2012_redist_x64\vcredist_x64.exe/quiet /norestart (for 64-bit machines)

Installing UFTSilentlyThis section describes how to install UFT, UFT add-ins, and the UFT Add-in for ALM silently onyour computer.

This task includes the following steps:

l "Prerequisites" on the next page

l "Install UFT silently" on the next page

l "Installing UFT add-ins" on the next page

Installation GuideInstalling UFT Silently


l "Installing the UFT Add-in for ALM silently" on page 23

l "Installing localized versions of UFT" on page 23

l "Setting UFT configuration options" on page 24

l "Specifying a concurrent license server" on page 24

l "Silent installation command examples" on page 24

Prerequisitesl Save any open files and close all open applications before running the silent installation.

l Install the prerequisite software for UFT. For the full list of prerequisite software, see "Installingthe Prerequisite Software for UFT" on page 19. You can begin the silent installation only after allthe required prerequisite software is installed.

Install UFT silentlyIn the command line, run the msiexec command to install UFT, using the following syntax:

msiexec/ I \Unified Functional Testing\MSI\Unified_Functional_Testing_x64.msi/qb (for 64-bit machines)

msiexec/ I \Unified FunctionalTesting\MSI\Unified_Functional_Testing_x64.msi/qb (for 64-bit machines)

or

msiexec/ I \Unified Functional Testing\MSI\Unified_Functional_Testing_x86.msi/qb (for 32-bit machines)

msiexec/ I \Unified FunctionalTesting\MSI\Unified_Functional_Testing_x86.msi/qb (for 32-bit machines)

Note: If you do not specify an installation folder, UFT is installed in the default installationfolder.

For a description of possible silent installation commands, see "Silent Installation Commands" onpage 50.

Installing UFT add-insYou can use the ADDLOCALMSI 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.

If you use this command, the followingmandatory options must be included:

l Core_Components (parent: Unified_Functional_Testing)

l Samples (parent: Unified_Functional_Testing)

Note:When installing a feature using the ADDLOCAL property, its parent always getsinstalled as well.

In addition to themandatory options, you can install the following UFT features and add-ins:

l ALM_Plugin

l ActiveX_Add_in

l Visual_Basic_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

Installing the UFT Add-in for ALM silentlyIn the command line, run the msiexec command to install the UFT Add-in for ALM, using thefollowing syntax:

msiexec /i "\ALMPlugin\MSI\" /qn

Note: If you install the UFT Add-in for ALM as part of the regular UFT installation,you cannotinstall it independently.

For a description of possible silent installation commands, see "Silent Installation Commands" onpage 50.

Examples

Upgrade: msiexec /i "\Unified_Functional_Testing_Add-in_for_ALM.msi" /qn

Complete Installation msiexec /qn /i "\ALMPlugin\MSI>\Unified_Functional_Testing_Addin_for_ALM.msi"

Installing localized versions of UFTYou can also perform a silent installation of a localized version of UFT.

In the command line, add the PRODUCT_LOCALEproperty to the msiexec command to install thefollowing localized versions:

l Brazilian Portuguese:PRODUCT_LOCALE="PTB"

l Chinese:PRODUCT_LOCALE="CHS"

l Dutch: PRODUCT_LOCALE="NLD"

l French: PRODUCT_LOCALE="FRA"

l German:PRODUCT_LOCALE="DEU"

l Italian:PRODUCT_LOCALE="ITA"

l Japanese:PRODUCT_LOCALE="JPN"



l Korean: PRODUCT_LOCALE="KOR"

l Russian:PRODUCT_LOCALE="RUS"

l Spanish:PRODUCT_LOCALE="ESP"

Setting UFT configuration optionsBy default, the following configuration options are included in the silent installation:

l Configure Internet Explorer settings (to exclude this option from the installation, use CONF_MSIE=0)

l Configure DCOM settings for ALM Integration (to exclude this option from the installation,CONF_DICOM=0)

l Download and install Microsoft Script Debugger (to exclude this option from the installation,set DLWN_SCRIPT_DBGR=0)

TheConfigure DCOM Settings for Automation Scripts option is not included by default. To setthis option for a silent installation, use CONF_DICOM_UFT=1.

Caution: Setting this option enables remote users to control UFT on this machine, exposingthe UFT computer to security risks.

Specifying a concurrent license serverYou can specify a specific license server during the silent installation. Use the LICSVRcommand asfollows:

LICSVR=

Silent installation command examplesThe following examples illustrate different possible commands for a silent installation of UFT.

l Standard installation:msiexec/ I \Unified FunctionalTesting\MSI\Unified_Functional_Testing_x64.msi/qb

l Standard installation with the Java Add-in, installed from a DVD msiexec/ I \Unified Functional Testing\MSI\Unified_Functional_Testing_x64.msi/qb "ADDLOCAL=Core_Components,Test_Results_Viewer,UFT_Mandatory,Samples, Web_Add-in,Java_Add-in" "TARGETDIR="

l Standard installation from the Web download with the Web and Java Add-insinstalled, DCOM configurations set, the Microsoft Script Debugger notdownloaded: msiexec/ I \Unified



Functional Testing\MSI\Unified_Functional_Testing_x64.msi/qb"ADDLOCAL=Core_Components,Test_Results_Viewer,UFT_Mandatory, Samples, Web_Add-in,Java_Add-in" "DLWN_SCRIPT_DBGR=0" "CONF_DICOM=1" "TARGETDIR="

l Standard installation of the localized German version of UFT with the .NET Add-in:msiexec/ I \Unified Functional Testing\MSI\Unified_Functional_Testing_x64.msi/qb "ADDLOCAL=Core_Components,Test_Results_Viewer,UFT_Mandatory, Samples, Web_Add-in,_Net_Add_in" "PRODUCT_LOCALE="DEU" "TARGETDIR="



Troubleshooting and Limitations-Installing/Uninstalling UFT

This section describes troubleshooting and limitations for installing UFT, and contains the followingsections:

l "General Limitations" below

l "Upgrading from QuickTest Professional" below

l "Troubleshooting and Limitations-Uninstalling UFT" on the next page

General Limitationsl If the HP UFT Files in Use dialog box is displayed during the installation process:

n Select theClose the application and attempt to restart them option. UFT automaticallycloses the needed applications and continues the installation.

n If you are upgrading from an earlier version of UFT, restart the computer before upgrading.

n If after restarting, the HP UFT Files in Use dialog box lists Explorer as the open application,you can do one of the following:

o Close the applications and attempt to restart them:Instructs UFT to automaticallyclose the applications that are needed for the installation.

o Do not close application. Instructs UFT to continue the installation. Youmust restartyour computer after the installation if you select this option.

l You cannot install a previous version of UFT after installing UFT 12.00 or higher.

Workaround:Manually uninstallUFT 12 or higher before installing the older version.

l After uninstalling LoadRunner 11.50, UFT does not work.

Workaround:After uninstalling LoadRunner 11.50, perform a repair installation for UFT.

Upgrading from QuickTest Professionall When upgrading from QuickTest Professional 11.00 and installing UFT into the same directory

as Quick Test, certain files will bemissing from the installation.

Workaround: After the upgrade, run the UFT installation again and select theRepairInstallation option.



l When upgrading from QuickTest Professional, the installationmay repeatedly prompt you forconfirmation to continue.

Workaround: Click Continuewhen prompted.

Troubleshooting and Limitations-Uninstalling UFTWhen a ALM client is installed on the same computer as UFT, uninstalling UFTmay remove theassociation of movie (.fbr) files. This may prevent you from viewingmovies associated withdefects in ALM using the HP Micro Player.

Workaround:Re-associate themovie files with the HP Micro Player, as follows

1. Select Start> All Programs> HPSoftware > HP Unified Functional Testing> Tools>HP Micro Player to open the HP Micro Player.

2. Select File> Options to open the HP Micro Player Options dialog box. Then select theAssociate FBR files with this Player check box to associate the files directly with the HPMicro Player.



Chapter 3: Working with UFT LicensesYou can install UFT using a seat license (formerly known as a local or standalone license) or aconcurrent license (formerly known as a floating license).

Your UFT license enables all UFT features, including the use of all UFT add-ins. If upgrading from aprevious version, only previously licensed add-ins will be available.


Understanding UFT License Types 29

Requesting a Seat License Key 30

Requesting a License Key via the HP Software Licensing Portal 30

Installing a Seat License Key 31

Installing a Concurrent License 33

Working with Commuter Licenses 35

Checking Out a Commuter License 35

Checking In a Commuter License 37

Obtaining a Commuter License Remotely 38

Troubleshooting and Limitations -Working with Licenses 45


Understanding UFT License TypesTo use UFT, youmust have a valid license. There are two types of licenses: seat and concurrent.The table below summarizes the differences between the two license types.

Topic Seat License Concurrent License

Generaldescription

The license is specific to the computer onwhich the license is installed.

Each license entitles theorganization to one additionalconcurrent user.

Number ofinstallationsper licensekey

Each installation of UFT requires a distinctlicense key.

There is no limit to the number ofUFT installations on the network,but a special concurrent licenseserver regulates the number ofcomputers that can run a copy ofUFT at any time.

Maintenancenumber

The license key is based partially on themaintenance number. Themaintenancenumber identifies the customer.

The license key is based partiallyon themaintenance number. Themaintenance number identifies thecustomer and indicates how manyconcurrent users the licensesupports.

Other issues The license key is based partially on thelocking code, which is a code that identifiesthe computer on which UFT is installed.The supplied license key works only for thecomputer on which the locking code wasgenerated.

Note: A computer with multiplebootable partitions may generate adifferent locking code for eachpartition. If a different locking code isgenerated for a partition, you need torequest a unique license key for it.

Not supported for Unix networks.

It is recommended that theconcurrent license server has afixed IP address.

UFT client computers must haveTCP/IP installed.

To use concurrent licenses acrossnetworks, UDP port 5093must beopen on the server.

Enteringlicense key

At the end of the installation procedure,UFT asks you to enter the license key. Ifyou do not have a license key at that point,UFT asks you to enter the key the first timeyou open UFT.

Each time UFT opens, itautomatically searches the samesubnet for the concurrent licenseserver. You do not need to enter alicense key for your UFT clientinstallation.


Requesting a Seat License KeyWhen you install UFT with a seat license for the first time, it includes a 30-day demo license. Touse UFT beyond the 30-day period, youmust request and activate a license key for your copy ofUFT.

To request a seat license key:

1. Perform one of the following:

n From the license warningmessage displayed when you start UFT, click Install License.

n From within UFT, select Help > License Wizard. The Unified Functional Testing LicenseWizard dialog box opens.

Select Seat license and click Next. Click Yes to install a new license key. TheWelcomescreen opens.

2. Make a record of the displayed locking code for your computer. You will need the locking codeto request your license key. Click the link on the Unified Functional Testing License Installation-Welcome screen for theHP Webware License Key Delivery Service to request yourlicense key. Follow the instructions as described in "Requesting a License Key via the HPSoftware Licensing Portal" below.

Requesting a License Key via the HP SoftwareLicensing Portal

The HP Software Licensing Portal assists you in requesting a license key.

For details on the various areas of the portal, see the links under theResources section on the leftside of theWeb page, such as the tutorial or the how-to demos.

Request your license key as described in the HP Software License Activation Quick Start Guide,available from theResources area of the HP Software Licensing Portal.

Installation GuideChapter 3: Working with UFT Licenses


Installing a Seat License KeyIn the License Key screen, you enter the license key you received from HP. The license key isincluded in the .dat file attached to the e-mail containing your Permanent Password Certificate.

Caution:

l Youmust have Administrator privileges to install a license key.

l After installing the seat license key, do not change your computer's date or time. Thistriggers aClock Tamper lock on the license information, preventing you from using thelicense.

To install a seat license key:


n From the warningmessage displayed when you start UFT, click Install License.

n From within UFT, select Help > License Wizard.

Note: You can also activate the seat license as part of the UFT installation. After you clickFinish in the final installation screen, the Unified Functional Testing License Installation -Welcome screen opens, as described below.

The License Type screen opens.

2. In the License Type screen, elect Seat license and click Next. In the confirmation box, clickYes to install a new license key. TheWelcome screen opens.

Tip: Check that the locking code in the License Key screenmatches the locking code yousent to HP when you requested a license key.

Click Next. The License Key Screen opens.

3. In the License Key screen, enter your license key.

Notes:

n The license key is valid only for the computer with the locking code that you entered inthe HPSoftware Support license request form.

n A computer with multiple bootable partitions may generate a different locking code for



each partition. If a different locking code is generated for a partition, you need to requesta unique license key for it.

i. Open the .dat file attached to the email containing your Permanent PasswordCertificate using any text editor. The license key is also included in the PermanentPassword Certificate.

ii. Copy the license key (with or without the #character) from the .dat file to theclipboard.

iii. Paste the key into the License Installation - License Key screen by clicking thePaste From Clipboard button .

Click Next. The Install Summary Screen opens.

7. In the Install Summary screen, verify your license details and click Next to install the license..

8. If you entered a valid license key, the Finish screen confirms that your license key wassuccessfully installed.

If the license could not be installed successfully, a message is displayed describing why. Forexample, if a seat license was previously installed on your computer, and you try to install aseat license again using the same license key, the license installation will not succeed. If thelicense could not be installed, aSend to Support button is displayed. You can click Send toSupport to create an e-mail with licensing information and send the email to your nearest HPSoftware Support location. Make sure that you fill in the required information in the e-mail sothat Software Support can assist you.

Tip: You can install another license by selecting the Install another license check box,clicking Finish and performing this task again.

9. If you do not want to install another UFT license, click Finish to complete the licenseactivation process and close the wizard.

Note: If you need tomodify your license type at a later date, you can do so by selecting Help>LicenseWizard or click Install License when opening UFT.



Installing a Concurrent LicenseIf there is an accessible concurrent license server on your network with an available license, youcan connect to it. This enables you to use a concurrent license instead of a seat license. For moredetails on working with concurrent license servers, and the supported versions, see theHPFunctional Testing Concurrent License Server Installation Guide.

To work with a concurrent license:


n From the license warningmessage displayed when you start UFT, click Install License.

n From within UFT, select Help > License Wizard.

The License Type screen opens.

2. Select Concurrent license and click Next. The Concurrent License Server screen opens.

3. In the edit box or the Concurrent License Server screen, either enter the name or IP address ofthe concurrent license server to which you want to connect, or leave the box blank to instructUFT to search for an available server on your local network.

Tip:When you activate a concurrent license using the LicenseWizard and specify asingle server name, the LSFORCEHOST user variable is automatically defined with theconcurrent license server you specified. You canmodify the concurrent license servereither by running the LicenseWizard or by setting the LSHOST or LSFORCEHOST uservariable. For more details, see theHPFunctional Testing Concurrent License ServerInstallation Guide.



4. Click Check Connection. If UFT can connect to the concurrent license server, a successmessage is displayed

Tip: If you want to specify the name of a concurrent license server that is currentlyunavailable, but will be available later, you can enter the name of the concurrent licenseserver in the edit box. Even though the Concurrent License Server screen informs you thatthe specified server is not available for connection, the next time you open UFT, UFT willtry to locate the server you specified.

5. Click Next. The installation informs you that the concurrent license activation was successful.

6. Click Finish to close the wizard. If UFT is open, youmust close and restart to use theconcurrent license server.

Note: If you need tomodify your license type at a later date, you can do so by selecting Help>LicenseWizard or click Install License when opening UFT.



Working with Commuter LicensesIf you use UFT with a concurrent license, but cannot connect your computer to your network (forexample, during a business trip), you can install a commuter license. Commuter licenses areavailable in companies that have only concurrent licenses (not seat licenses).

For example, suppose you need to travel on business with your laptop computer and you want touse UFT while you are away. You can check out a UFT license from the concurrent license serverto use for the duration of your trip, and then check the license back in upon your return. Commuterlicenses are valid for up to 180 days, according to your requirements.

Tip: If you have a concurrent license and are located far from the concurrent license server,you can also use a commuter license if you encounter network traffic.

For more details, see "Checking Out a Commuter License" below , and "Checking In a CommuterLicense" on page 37.

Note: Installing a commuter license requires administrator permissions for the computer onwhich you want to use the license.

In addition, if you are unable to check out a license before you disconnect from the network (that is,leave for your trip), or if you checked out a license but it expired because your return was delayed,you can ask a local network user to check out a commuter license and send it to you remotely. Formore details, see "Obtaining a Commuter License Remotely" on page 38.

Note: If you have upgraded to HPFunctional Testing Concurrent License from a version earlierthan7.6, you need to request a new server license key to enable the commuter licensingfunctionality. For details, contact HPSoftware Support or your local representative.

Checking Out a Commuter LicenseBefore you check out a commuter license, ensure that the computer (for example, a laptop) onwhich you want to install the commuter license has UFT installed, is connected to the network, andhas access to a concurrent license server with an available UFT license. After you have checkedout the license, you can disconnect the computer from the network.

To check out a commuter license:

1. Run the WCommute.exe file located in \bin. TheWCommute dialog box opens.



2. To see commuter licenses available on all concurrent license servers located within yoursubnet, click Search Subnet. If you want to specify a particular concurrent license server, or ifyou want to select a concurrent license server outside of your subnet, click Single Server.

n If you click Search Subnet, theWCommute utility searches the subnet for concurrentlicense servers that support commuter licensing and displays them in theWCommutedialog box.

Note: This process may take several minutes.

n If you click Single Server, a dialog box opens enabling you to specify the concurrentlicense server you want to locate. Enter the concurrent license server computer's hostname, IP address, or IPX address and click OK. The specified concurrent license server islocated and displayed in theWCommute dialog box.

For each concurrent license server, a list of available commuter licenses is displayed. A redcheck mark next to a commuter licensemeans that the license is already checked out to yourcomputer. You cannot check out multiple licenses for the same application to the samecomputer. Click a license to view the license details in the right pane of the dialog box.

3. Select the license that you want to check out.



4. In theEnter number of days until the commuter authorization expires box, specify themaximum number of days to check out the license. Themaximum number of days is 180.

Note:

n UFT supports the Sentinel RMS LicenseManager version 8.4.0 as its concurrentlicense server. If you are upgrading to UFT with a concurrent license, youmust alsoupgrade your concurrent license server.

n When you check out a license, it decreases the number of licenses available for use byothers. Therefore, you should specify the absolute minimum number of days that yourequire.

5. Click Check Out. The selected license is saved locally on your computer.

6. To use the new checked-out license, open UFT and change your license type from concurrentto seat. In the confirmationmessage that opens after you change the license type, click No touse the commuter license.

Checking In a Commuter LicenseWhen you finish using the commuter license, you should check it in from your computer to theconcurrent license server from which you checked it out. This makes the license available to otherusers.

Note: If your license expires, you do not need to check it in. When a license expires, you canno longer use it. The license is automatically returned to the concurrent license server, even ifyour computer is not connected to the concurrent license server network.

To check in a commuter license:

1. Run the WCommute.exe file located in \bin. TheWCommute dialog box opens.



2. Locate the concurrent license server for the commuter license you want to check in, asdescribed in "Checking Out a Commuter License" on page 35. Youmust check in the licenseto the same concurrent license server from which you checked it out.

3. Select the license you previously checked out.

Tip: The checked-out license is indicated by a red check mark.

4. Click Check In. The license is returned to the concurrent license server, and is made availablefor use by others.

Note: Before you can use UFT again, youmust change your license type from seat toconcurrent.

Obtaining a Commuter License RemotelyA local network user can locally check out a UFT commuter license and send it to you forinstallation on a remote computer. This is useful in situations in which you are currently notconnected to the concurrent license server network. For example, youmay be out of the office onan extended business trip, but need to be able to use UFT.



To obtain a commuter license remotely:

1. Run theWRCommute utility to generate a commuter locking code for your computer and sendthe commuter locking code to a local user who has access to the concurrent license server.For more details, see "Step 1: Generating a Remote Computer Locking Code" below.

2. Ask the local user to run theWCommute utility (entering the commuter locking code yougenerated) to check out a remote commuter license, and send the license to you. For moredetails, see "Step 2: Checking Out a Commuter License for a Remote Computer" on the nextpage.

3. Run theWRCommute utility to install the remote commuter license on your computer. Formore details, see "Step 3: Installing a Commuter License on a Remote Computer" on page 43.

4. Open UFT and change your license type from concurrent to seat. In the confirmationmessagethat opens after you change the license type, click No to use the commuter license.

Step 1: Generating a Remote Computer Locking CodeThe first step in remotely obtaining a commuter license is to generate a locking code on yourcomputer using theWRCommute utility, and transfer the code (by e-mail) to a network user whohas access to the concurrent license server.

Note: The remote computer locking code used to lock a commuter license is not the same asthe locking code displayed by the ECHOID utility. Youmust use theWRCommute utility toobtain the commuter license locking code.

To generate a locking code on a remote computer:

1. Run the WRCommute.exe file located in \bin. TheWRCommute dialog box opens.



The Locking code string for the current machine box contains the locking code that youneed to e-mail to a network user who has access to the concurrent license server containingthe UFT licenses.

2. Send the locking code to the local network user in one of the following ways:

n Select the locking code string and click theCopy to clipboard button to copy the stringto yourWindows clipboard. Then open your e-mail program and paste the string into a newe-mail message and e-mail it to the local network user.

n Click theSave lock code string to file button to save the locking code in a file.Specify the name and location for the file, and then attach the file to a new e-mail messageand e-mail it to the local network user.

n Click theDisplay locking code string button to display the entire locking code inanother dialog box. You can then select the locking code string, right-click it and selectCopy to copy it to yourWindows clipboard. Then open your e-mail program and paste thestring into a new e-mail message and e-mail it to the local network user.

n In theE-mail address box, enter the e-mail address of the local network user and clickSend.

Note: This option is supported only if Microsoft Outlook Express is set up as your e-mail client.

Step 2: Checking Out a Commuter License for a Remote ComputerAfter a local network user receives the locking code, the user can check out the license and transferthe license to you (by e-mail). To do this, the user must have UFT installed on his or her computerand also have access to the concurrent license server with an available UFT license.

To check out a commuter license for a remote computer:

1. Run the WCommute.exe file located in \bin. TheWCommute dialog box opens.\



2. Locate the concurrent license server from which you want to check out a remote commuterlicense, as described in "Checking Out a Commuter License" on page 35.

For each concurrent license server, a list of commuter licenses that you can check out isdisplayed.

3. Select the license that you want to check out.

4. Select theCheck out authorization for remote machine check box.

5. In theEnter the number of days until the authorization expires box, specify the number ofdays to check out the license. Themaximum number of days is 180.

Note:

n UFT supports the Sentinel RMS LicenseManager version 8.4.0 as its concurrentlicense server. If you are upgrading to UFT with a concurrent license, youmust alsoupgrade your concurrent license server.

n When you check out a license for a remote computer, the license cannot be checked inand remains in use (unavailable to other users) for the entire number of days specified.Therefore, you should specify the absolute minimum number of days required.



6. Click Check Out. The Locking Code for RemoteMachine dialog box opens.

7. Enter the locking code that the remote user e-mailed you in one of the following ways:

n If the locking code was e-mailed to you in the body of an e-mail, copy it to yourWindowsclipboard. In the Locking Code for RemoteMachine dialog box, select Enter the locking

code string for remote machine and then click thePaste from clipboard button .

n If the locking code was e-mailed to you as an attached file, save the attachment and then

select Get locking code string for remote machine from file. Click the Load button. Select the file that contains the locking code and click Open.

8. Click OK. The Remote Commuter Licensing dialog box opens.



9. Send the commuter license to the remote user in one of the following ways:

n Click theSave button to save the locking code in a file. Specify the name and locationfor the file, click Save and then click OK. Attach the file to a new e-mail message and e-mailit to the remote user.

n In theE-mail address box, enter the e-mail address of the remote user. Click Send andthen click OK.

Note: This option is supported only if Microsoft Outlook Express is set up as your e-mail client.

Step 3: Installing a Commuter License on a Remote ComputerThe final step in remotely obtaining a commuter license is to install the license that was sent to youby the network user on your computer.

To install a commuter license on a remote computer:

1. Ensure that you are logged in to your computer with administrator privileges.

2. Run the WRCommute.exe file located in \bin. TheWRCommute dialog box opens.

3. Click the Install Remote Authorization Code tab.



4. Enter the commuter license that the network user e-mailed you, as follows:

n If the commuter license was e-mailed to you in the body of an e-mail, copy it to yourWindows clipboard. In the Install Remote Authorization Code tab of theWRCommutedialog box, select Enter remote authorization code and then click thePaste from

clipboard button .

n If the commuter license was e-mailed to you as an attached file, save the attachment and

then select Get remote authorization code(s) from file. Click the Load button .Select the file that contains the locking code and click theOpen button.

5. Click Install. The new license code is installed on your computer.

Step 4: Modifying the License Type on the Remote ComputerOpenUFT and change your license type from concurrent to seat. In the confirmationmessage thatopens after you change the license type, click No to use the commuter license.

Note: A remote commuter license cannot be checked in to the concurrent license server whenyou have finished using itthe license simply expires on the remote computer. After you returnto your office and are reconnected to the network, you should change your license type fromseat to concurrent.



Troubleshooting and Limitations - Working withLicenses

The following section contains troubleshooting tips and limitations for using UFT licenses:

Using Old Service Test licensesUFT cannot open with a license that was installed with Service Test 9.53.

Workaround: Reinstall the license using the UFT LicenseManger, available from the Start menu.

No network connection between the concurrent license server and clientcomputers with the UFT installationYou can check the network connection between the client and server machines by pinging thelicense server machine in a command prompt window.

For example, you can enter the following command: c:\ ping

If there are no replies from the ping command, or if there are timeouts in the replies, theremay be anetwork problem. If required, contact your Computer or Network Administrator.

Concurrent license server not runningYoumay need to start or restart the license server service:

1. Open the Control Panel (Start > Settings > Control Panel).

2. Select Services.

3. Select SentinelRMS service.

4. Click Start the Service (orRestart the Service), or right-click and select Start (orRestart).

Licenses not installed on the concurrent license serverUse theWlmAdmin utility to check that licenses are installed on the license server. For moredetails on theWlmAdmin utility, see theUtilities chapter in theHPFunctional Testing ConcurrentLicense Server Installation Guide.

1. Run SrvUtils.exe in the LicenseServer\utils folder of the UFT installation DVD.

2. SelectWlmAdmin.

3. Enter the license server name as a defined server.

4. Try to expand the license server branch.

If no license key information is displayed, then the installed licenses are invalid, or the license keyfile (lservrc) cannot be found. If license key information is displayed, then the installed licensesare valid. You can check whether the licenses are all in use by selecting a license and checking theStatistics pane in theWlmAdmin utility.



License key file (lservrc) not found on the concurrent license serverThe lservrc file should be located in the following directory:

\Program Files\Common Files\SafeNet Sentinel\ RMS License Manager\WinNT

If the file is not there, the license server is not able to locate licenses. Search the license servercomputer for the file. If found, move the file to the correct directory and restart the SentinelLMservice. If the file is not found, licenses are not installed.

The concurrent license server is being used by themaximum number of users

l If all licenses are in use, the License Server Manager is not able to issue another license until alicense is released. You can use theWlmAdmin utility to determine which users are currentlyusing the licenses. Run SrvUtils.exe in the LicenseServer\utils folder of the UFTinstallation DVD, and selectWlmAdmin.

For more details on theWlmAdmin utility, see theUtilities chapter in theHPFunctional TestingConcurrent License Server Installation Guide.

l Theremay be cases where UFT closes unexpectedly and does not release the licenseautomatically. If this happens, you can wait for the license to timeout, or you can restart thelicense server.

For more details, see the HP Software Self-solve knowledge base athttp://h20230.www2.hp.com/selfsolve/document (requires an HP Passport user name andpassword).

In the knowledge base, search for:Document ID 18428. "What happens if AQT/QTP crasheson a client machine while using a Floating license".

Two or more versions of the concurrent license server runningOnly one version of the license server should be installed and running on the same computer. Ifthere aremore versions, useAdd/Remove Programs to uninstall all of the license serverinstances. Then install the latest version of the license server software and reinstall the licensecode keys.

Client computer configured to use a seat licenseIf your computer is configured to use a seat license and you need to switch to a concurrent license,select Install Licensewhen opening UFT or select Help >License Wizard in UFT.

License key does not match the concurrent license server locking codeUse the lsdecode.exe utility to check the locking code for a license key:

1. Copy the lsdecode.exe utility from the LicenseServer\utils folder of the UFT installationDVD to the location of the lservrc file (\Program Files\Common Files\SafeNetSentinel\ RMS License Manager\WinNT).

2. Run the lsdecode.exe utility. A command prompt window opens with the decoded keyinformation.



The locking code for the license key is displayed on theServer locking code line.

3. Run the inst_key.exe utility from the LicenseServer\KeyInstallation folder of the UFTinstallation DVD.

The license server computer's locking code is displayed on theWelcome screen.

Note: This stepmust be done on the license server computer. Accessing the licenseserver computer remotely can generate an invalid license code.

4. Compare the locking code for the license key and from the server computer.

If the locking codes do not match, you need to determine why the locking code has changed.Reinstalling the operating system, renaming the computer, using a dynamic IP address,retrieving the locking code through a terminal session, or installing the license keys through aterminal session can cause the locking code to be changed and the license keys to becomeinvalid.

After you have determined why the locking code has changed, you can submit a LicenseRequest to have a new license key generated.

Client computer cannot identify the license keys on the server computerUse theWlmAdmin utility to check the licenses on the client computer. For more details on theWlmAdmin utility, see theUtilities chapter in theHPFunctional Testing Concurrent License ServerInstallation Guide.

1. Run SrvUtils.exe in the LicenseServer\utils folder of the UFT installation DVD.

2. SelectWlmAdmin.

3. Enter the license server name as a defined server.

4. Try to expand the license server branch.

If license keys are not identified, then either UDP Port 5093 is blocked between the client andserver, or the IP address of the license server is using Network Address Translation (NAT), whichis not supported. If required, contact your Computer or Network Administrator.

For more details, see the HP Software Self-solve knowledge baseathttp://h20230.www2.hp.com/selfsolve/document (requires an HP Passport user name andpassword).



In the knowledge base, search for:

l Document ID 18402. "What is port 5093 in the licensemechanism used for?"

l Document ID 41449. "Does UDP port 5093 need to be bi-directional?"

l Document ID 18424. "How to set up the LicenseManager for machines running on differentsubnets."

LSHOST or LSFORCEHOST variables are not set on the concurrentlicense serverFor details on how to set these variables, see theHPFunctional Testing Concurrent License ServerInstallation Guide.

LSERVRC system variable is set on the client computer with the UFTinstallationThe LSERVRC variable is used for seat licenses andmay have been created for the demo licensewhen UFT was installed. If this variable exists, it must be removed so it does not interfere withlocating the license server.

1. On your desktop, right-click My Computer and select Properties.

2. Select theAdvanced tab and click Environment Variables.

3. Check the System Variables list for the LSERVRC variable. If it exists, click Delete.

4. Click OK to close the windows.

5. Reboot the client computer to implement the changes.

Client computer with the UFT installation connects through VPN softwareIf the client computer with the UFT installation is connecting through VPN software, verify thatVPN has not been configured to use IPSec over UDP. This configures the network to use NetworkAddress Translation (NAT), which is not supported.



Appendix A: Additional InstallationInformation

This chapter provides additional supplemental information about the installation.


Silent Installation Commands 50

Modifying DCOM Permissions Manually to Enable Remote UFT Execution 51

Modifying User Account Control Settings to Connect with ALM (Windows7, WindowsServer2008, Windows Server2008R2, Windows 8, andWindows Server 2012) 57

Verifying the UFT Installation 58


Silent Installation CommandsThe following table lists commands, arguments, and options used for silent installation (inalphabetical order):

Command /Argument Description

ADDLOCAL(UFT coreinstallation only)

(Optional) Instructs the silent installation to install specific UFT features andadd-ins. For more details and a list of available features, see "Installing UFTadd-ins" on page 21.

Note:

l If you do not use this argument, UFT is installed with the default add-ins.

l Youmust include Samples, and Core_Components in the ADDLOCALcommand.

l Values must be separated by commas andmust not contain spaces.

LicSvr (Mandatory) The name or IP address of the license server to specify wheninstalling UFT licenses.

MsiFlags (Optional) Any MSI options, flags, and other instructions that are not includedin the MsiProperties arguments, such as logging commands.

MsiProperties (Optional) Any MSI properties or parameters, such as TARGETDIR. EachMSIproperty and its definitionmust be contained in quotes ("") andmust notcontain spaces.

ALM_Plugin(UFT Add-in forALM installationonly)

(Mandatory) The name of theMSI installation file.

Note: There is a different MSI file for each available user interfacelanguage.

UFT_DVD_Path The path to the UFT Installation DVD or network location.

The path to the UFT Installation executable that you downloaded.


Modifying DCOM Permissions Manually to EnableRemote UFT Execution

This section describes how tomanually change DCOM permissions and open firewall ports toenable remote execution of UFT. These changes are only required if you are running UFT onWindows7 orWindows 8.

You need tomake these changes only if:

l You plan to execute UFT tests remotely as part of a Default ALM test set.

l You did not select the Configure DCOM Settings option during the installation process.

Tip: The HP Support Knowledge Base provides utilities to assist you inmaking DCOMchanges. For more details, see the HP Software Self-solve knowledge base(http://h20230.www2.hp.com/selfsolve/document/KM196144) and search for Problem ID43245. The Knowledge Base area requires that you register as an HP Passport user and signin.

Tomanually enable remote execution of UFT, perform the following procedures:

l EnableWindows to authenticate the remote user (described on page 51)

l Configure theWindows Firewall to enable port135 for DCOM (described on page 52)

l Modify DCOM security properties (described on page 52)

l Configure security settings for the Unified Functional Testing Remote Agent DCOMapplications (described on page 56)

l Disable group-wide remote DCOMexecution of UFT scripts (described on page 55)

l Enable COM+ Access

In addition, before remotely running a test youmust alsomake sure that theAllow otherHPproducts to run tests and components option is selected in theRun Sessions pane (Tools> Options > General tab > Run Sessions node) of the UFT Options dialog box. For more details,see theHP Unified Functional Testing User Guide.

To enable Windows to authenticate the remote user:

1. For users logged into both computers, add these users to the Local Administrators group on theUFT computer. This enables Windows to authenticate the remote user executing the testsagainst the DCOM objects.

Installation GuideAppendix A: Additional Installation Information


To configure the Windows Firewall to enable port135 for DCOM:

1. On the UFT computer, select Control Panel > System and Security > Windows Firewall.TheWindows Firewall options open.

2. Select theAllow a program or feature through Windows Firewall option on the leftsidebar.

3. Click Allow another program. The Add a Program dialog box opens.

4. Select or browse to the Remote Agent (\bin\AQTRmtAgent.exe) and click OK.

Note: If you do not configure the Remote Agent as an exception as described above, aWindows Security Alert message will display while running a test remotely. ClickUnblock to solve this problem. The next time you remotely execute an automated test,the warning does not display.

5. Click OK to close theWindows Firewall dialog box.

Note: Formore details, a list of port assignments for commonly-used services can befound at: http://technet.microsoft.com/en-us/library/cc959833.aspx.

To modify DCOM security properties:

1. Select Start > Run, type dcomcnfg, and press Enter. The Component Services windowopens.

2. Navigate toConsole Root > Component Services > Computers > MyComputer.

Note: If aWindows Security Alert message opens, click Ask me later orUnblock.

3. Right-click My Computer and select Properties.

4. Select theDefault Properties tab.

5. Make sure theDefault Impersonation Level is Identify and click Apply.

6. Select theCOM Security tab.

7. In the Access Permissions area, click Edit Limits. The Access Permission dialog box opens.

8. Click Add. The Select Users or Groups dialog box opens.

9. Click Advanced.



10. Click Locations. In the displayed dialog box, select your computer name and click OK.

11. Click Find Now.

12. Select the following users and groups from the local computer and click OK:

n Administrator

n Administrators

n Authenticated Users

n Anonymous Logon

n Everyone

n Interactive

n Network

n System

13. Add the following users from the domain and click OK:

n

n

14. In the Access Permission dialog box, assign Local Access andRemote Access permissionsto the groups and users in the list and click OK.

15. In the Launch and Activation Permissions area, click Edit Limits. The Launch Permissiondialog box opens.

16. Repeat steps 8 to 13.

17. In the Access Permission dialog box, assign Local Launch, Remote Launch, LocalActivation, andRemote Activation permissions to the groups and users in the list and clickOK.

To configure security settings for the Unified Functional Testing RemoteAgent DCOM applications:

1. In the Component Services window, navigate toConsole Root > Component Services >Computers > My Computer > DCOM Config.

2. Right-click theAQTRmtAgent item and select Properties. The AQTRmtAgent Properties



dialog box opens.

3. In the Identity tab, select The interactive user. This enables the DCOM application toauthenticate the process against the logged-inWindows user and run the process in thatsecurity context.

4. Select theSecurity tab.

5. In the Launch and Activation Permissions area, select Customize and click Edit. The LaunchPermission dialog box opens.

6. Click Add. The Select Users or Groups dialog box opens.

7. Click Advanced.

8. Click Locations. In the displayed dialog box, select your computer name and click OK.

9. Click Find Now.

10. Select the following users and groups from the local computer and click OK:

n Administrator

n Administrators

n Authenticated Users

n Anonymous Logon

n Everyone

n Interactive

n Network

n System

11. Add the following users from the domain and click OK:

n

n

12. In the Launch Permission dialog box, for all the groups and users in the list, select Allow for allpermissions and click OK.

13. In the Access Permissions area, select Customize and click Edit. The Access Permissiondialog box opens.



14. Repeat steps 6 to 12.

15. Click Apply to save the changes and click OK to close the dialog box.

16. Close the Component Services window.

To disable group-wide remote DCOM execution of UFTscripts:

1. In the Component Services window, navigate toConsole Root > Component Services >Computers > My Computer > DCOM Config.

2. Right-click theQuickTestProfessional Automation item and select Properties. TheQuickTestProfessional Automation Properties dialog box opens.

3. Select the Security tab.

4. Select Customize and Click Edit. The Launch and Activation dialog box opens.

5. Select a group/user name from the list of groups/user names following for it:



6. In the Permissions list below, forRemote Activation, clear theAllow box.

7. Repeat steps 5 and 6 for each group/user name in the list.

To enable COM+ on a Windows 2008 or Windows 2012 server:

1. Open the Server Manager.

2. Install theCOM+ Network Access feature in theApplication Server role.

You can now remotely execute a UFT test from ALM.

Note: Before remotely running a test, youmust alsomake sure that theAllow otherHPproducts to run tests and components option is selected in theRun Sessions (Tools> Options > General tab > Run Sessions node) pane of the UFT Options dialog box. Formore details, see theHP Unified Functional Testing User Guide.



Modifying User Account Control Settings toConnect with ALM (Windows7, WindowsServer2008, Windows Server2008R2, Windows 8,and Windows Server 2012)

If you are running UFT onWindows7, Server2008, or Server2008R2, youmust disable UserAccount Control (UAC) and restart your computer before you connect with ALM for the first time

uft install guide

Documents

hp software online support

software release date

hp products

software trainingmost

support contractsl

software version number

support areas

support web site