UFT Installation and License Activation Guide

Installing and Setting Up UFT - License Activation: A Comprehensive Guide

Unified Functional Testing (UFT) is a powerful testing solution that requires proper installation and license activation to function optimally. Getting your UFT environment set up correctly is crucial for ensuring seamless testing operations and maximizing the value of your investment in this software. This comprehensive guide will walk you through the entire process of installing UFT and activating your licenses, ensuring you can fully leverage its testing capabilities.

Introduction to UFT and Licensing Requirements

Unified Functional Testing, developed by Micro Focus (now part of OpenText), is a comprehensive testing solution that supports functional, regression, and service testing across various applications. Before diving into the installation process, it's essential to understand that UFT operates on a licensing model that determines how many users can access the software simultaneously and what features are available. Proper licensing ensures compliance with vendor agreements and prevents disruptions to your testing activities.

The licensing requirements for UFT vary based on your organization's needs, including the number of testers, the type of testing you'll perform, and whether you need access to additional components like Terminal Emulator or PDF testing capabilities. Understanding these requirements upfront will help you avoid installation issues and ensure your team can perform their testing tasks efficiently. When planning your UFT deployment, consider factors such as concurrent user licenses, named user licenses, and any add-ons required for specialized testing scenarios.

UFT employs different types of licenses that control access to its features and capabilities. License management is a critical aspect of UFT deployment as it determines how many users can simultaneously access the software and which functionalities they can utilize. The Functional Testing License Wizard is the primary tool used to manage license installation and usage on UFT client machines, providing a centralized interface for license administration.

Understanding UFT License Types and Their Applications

UFT offers different license types to accommodate various organizational structures and testing requirements. The two primary license types are named user licenses and concurrent user licenses. Named user licenses are tied to specific individuals, allowing designated users to access UFT from any machine. Concurrent user licenses, on the other hand, allow any user to access UFT as long as the number of simultaneous users doesn't exceed the licensed quantity.

• Named User Licenses:
• Tied to specific users
• Allow access from any machine
• Ideal for organizations with dedicated testers

• Concurrent User Licenses:
• Shared among multiple users
• Limited by the number of simultaneous users
• More cost-effective for teams with flexible testing schedules

Additionally, UFT offers various license options for specialized testing needs, such as web, mobile, or SAP testing. When selecting your license type, consider your team's workflow, testing patterns, and budget constraints. It's also important to note that concurrent licenses do not have demo versions available, unlike named user licenses which may offer trial periods for evaluation purposes.

For node-locked licenses, activation typically involves entering a license key directly into the Functional Testing License Wizard, which then validates and activates the license on the specific machine. Concurrent license activation requires additional steps as it involves a license server. First, you must install the AutoPass License Server on a designated machine that will manage the license pool. During this installation, you'll specify the license server's name or IP address, which UFT clients will use to connect. Once the server is configured, you can install the licenses on the server using the provided license keys.

Pre-installation Requirements and Preparation

Before installing UFT, it's crucial to ensure your system meets the minimum requirements and that you have all necessary components ready. Proper preparation helps prevent installation issues and ensures smooth license activation later.

First, verify your system specifications against UFT's requirements, including supported operating systems, memory, disk space, and processor capabilities. You'll also need to determine your licensing model beforehand—whether you'll be using node-locked licenses or concurrent licenses. For concurrent licenses, you'll need to identify the license server machine that will manage the license pool.

Key preparation steps include:

• Checking system compatibility
• Obtaining the appropriate UFT installation media (Full UFT One DVD Release or Core UFT One DVD Bundle)
• Gathering license information and server details
• Ensuring network connectivity for license server communication
• Planning user access and permissions

Taking these preparatory steps will streamline the installation process and minimize potential complications during license activation.

Step-by-Step Guide to Installing UFT

The UFT installation process is straightforward when followed systematically. Begin by ensuring your system meets the minimum requirements, including compatible operating system versions, sufficient RAM, and available disk space. Next, download the installation files from the official Micro Focus portal or use the installation media provided with your license.

The installation process typically involves launching the setup executable and following the on-screen instructions. During installation, you'll be prompted to select components such as the core UFT application, add-ins for specific technologies, and optional tools like the Terminal Emulator or PDF testing capabilities. Select only the components relevant to your testing needs to optimize installation time and system resources.

# Example command-line installation for UFT on Windows
msiexec /i "UFT Installation.msi" ADDLOCAL="Core_UFT,Web_AddIn" LICENSESERVER="license-server.example.com" /qb

After the base installation completes, you may need to configure additional components:

• Run the Stingray Wizard if you're working with Stingray applications
• Configure the Terminal Emulator Wizard for terminal-based testing
• Set up any required plugins or integrations

For enterprise deployments across a network, you'll need to ensure proper network connectivity between UFT clients and the license server. The system will attempt to locate the license server automatically during UFT's launch sequence if no specific server is configured, but manually specifying the server name or IP address is recommended for reliability.

Activating Your UFT License: Detailed Instructions

License activation is a critical step in setting up UFT, as without proper activation, the software will operate in a limited mode or not at all. For UFT versions 12.50 and later, the Functional Testing License Wizard is the primary tool for managing license installation and usage. This wizard guides you through the process of connecting to your license server or activating local licenses.

To activate your license, first determine whether you're using a license server or standalone licenses. If using a license server, you'll need to provide the server name or IP address during activation. For concurrent licenses, UFT will attempt to locate a server on the network if no specific address is provided. This automatic discovery feature simplifies the connection process in enterprise environments with multiple license servers.

// Example Java code to check UFT license status
import com.hp.lft.sdk.License;
import com.hp.lft.sdk.LicenseManager;

public class LicenseCheck {
    public static void main(String[] args) {
        try {
            LicenseManager licenseManager = new LicenseManager();
            License[] licenses = licenseManager.getLicenses();
            
            for (License license : licenses) {
                System.out.println("License Type: " + license.getType());
                System.out.println("Status: " + license.getStatus());
                System.out.println("Expiration Date: " + license.getExpirationDate());
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

For standalone licenses, you'll need to provide the license file obtained during the purchasing process. The License Wizard will guide you through the file selection process and validate the license before activation. Once activated, you can verify the license status through UFT's help menu or by checking the license management interface provided with the License Server.

Troubleshooting Common License Issues

Despite following proper installation procedures, you may encounter license-related issues that prevent UFT from operating correctly. Common problems include license server connectivity issues, expired licenses, and incorrect license configurations. Understanding how to troubleshoot these issues can minimize downtime and keep your testing activities running smoothly.

License server connectivity issues often stem from network configuration problems or incorrect server addresses. To resolve these issues, first verify that the license server is running and accessible from your network. Check firewall settings that might be blocking communication between UFT clients and the license server. If using a concurrent license, ensure you're specifying the correct server name or IP address during activation.

• Common license issues and solutions:
• "License server not found" - Verify server address and network connectivity
• "License expired" - Renew license through Micro Focus portal
• "Insufficient licenses" - Monitor license usage and consider upgrading

Another frequent issue is license conflicts when upgrading from older versions of UFT. While older licenses may work with the new License Server, it's recommended to check the specific compatibility matrix for your version. Documentation typically addresses questions like "Can I use my old license with the new License Server?" and provides guidance on the appropriate license to install. For those upgrading from older UFT versions (pre-12.50), compatibility questions often arise. Starting with version 12.50, UFT uses a new license server architecture that may not be compatible with older license files. In such cases, you'll need to install the new License Server component and migrate your existing licenses to the new format.

Best Practices for Enterprise License Management

Effective license management is crucial for organizations deploying UFT across multiple machines and teams. Implementing best practices ensures optimal utilization of your investment while maintaining compliance with licensing agreements.

For organizations managing multiple UFT installations across a network, implementing effective license management practices is essential. Proper license management ensures compliance, optimizes resource utilization, and reduces costs. Consider implementing a centralized license server to manage all UFT licenses in your organization, providing a single point of control and monitoring.

Regular license audits should be conducted to ensure you're utilizing your licenses effectively and identifying any unused or underutilized licenses. This practice can help you make informed decisions about license renewals and adjustments based on actual usage patterns. Additionally, establish clear procedures for license allocation and reallocation as team members change roles or leave the organization.

// Example script to check license usage from a license server
const axios = require('axios');

async function checkLicenseUsage() {
    try {
        const response = await axios.get('https://license-server.example.com/api/licenses');
        const licenses = response.data;
        
        licenses.forEach(license => {
            console.log(`License Type: ${license.type}`);
            console.log(`Total Licenses: ${license.total}`);
            console.log(`In Use: ${license.inUse}`);
            console.log(`Available: ${license.available}`);
            console.log('---------------------');
        });
    } catch (error) {
        console.error('Error checking license usage:', error);
    }
}

checkLicenseUsage();

Implementing the following best practices can further enhance your license management:

• Document license allocation and user permissions
• Establish procedures for license transfer and reallocation
• Schedule regular audits to ensure compliance
• Plan for license renewal and expansion needs
• Train administrators on license management tools and processes

By following these practices, organizations can maximize their UFT investment while minimizing administrative overhead and compliance risks.

Conclusion

Proper installation and license activation are fundamental to leveraging the full power of UFT in your testing environment. By following the steps outlined in this guide and understanding the nuances of license management, you can ensure a smooth deployment process and avoid common pitfalls. Whether you're setting up UFT for individual use or implementing it across an enterprise network, a well-planned approach to installation and licensing will provide a solid foundation for your automated testing initiatives.

Understanding the different license types, preparing adequately before installation, and implementing effective license management practices will not only ensure compliance but also optimize your testing resources. With UFT properly configured and activated, your team can focus on creating comprehensive test scripts and delivering high-quality software products efficiently.

Frequently Asked Questions

• What are the different types of UFT licenses?
  UFT offers named user licenses tied to specific individuals and concurrent user licenses shared among multiple users. Specialized licenses are also available for web, mobile, or SAP testing.
• How do I activate my UFT license?
  Use the Functional Testing License Wizard to activate licenses. For concurrent licenses, you'll need to install the AutoPass License Server first and provide the server name or IP address during activation.
• What should I do if I encounter license server connectivity issues?
  Verify the license server is running and accessible from your network. Check firewall settings that might be blocking communication and ensure you're specifying the correct server name or IP address.
• Can I use my old UFT license with the new License Server?
  Starting with UFT version 12.50, a new license server architecture was introduced. Older licenses may not be compatible, and you may need to migrate existing licenses to the new format.
• What are the best practices for enterprise license management?
  Implement a centralized license server, conduct regular license audits, document license allocation, establish procedures for license transfer, and train administrators on license management tools.