Prepare for installation

This section provides information on the installation packages, and notes and known issues.

Installation packages and requirements

You can access the installation packages from the free trial page, or by selecting your account on the Software Licenses and Downloads page.

Tip: You can download VuGen, OpenText Performance Engineering for Developers, VTS, and more, for free from Marketplace.

Installation can include the following components:

Component Description
Virtual User Generator (VuGen) A tool for creating virtual user (Vuser) scripts, primarily through recording. Vuser scripts emulate users without a graphical user interface by using direct function calls.
Controller Controls the execution of load and performance tests based on Vuser scripts. Includes the online monitors which monitor and display information about the test execution.
Analysis Provides graphs and reports for analyzing the load test.
Load generator (OneLG) Component for running Vusers (including Windows-based GUI Vusers) to generate load.
Network Virtualization

Enables you to emulate network conditions in your testing environment, such as latency, packet loss, and bandwidth, to accurately test how your application responds under a multitude of network conditions.

Monitors over Firewall

Component on the agent machine for monitoring over a firewall.

MI Listener

Component for the MI Listener machine, used in running Vusers and monitoring over a firewall.

Data Hub

Communication channel that supports more robust communication between the components.

Data Hub Web Connector

Enables the Data Hub to communicate over the web and over firewalls.

Some of the components above are available for standalone installation. These can be found in the installation package's Standalone Applications folder.

Additional components (such as the Citrix agent) can be found in the installation package's Additional Components folder. For details and installation instructions, see Components and applications.

The following information can be found in the Support Matrix:

  • System requirements for running components on the relevant platforms.
  • A full list of components that can be installed on the same physical machine at the same time.

Back to top

Notes and known issues

Before beginning installation, review the information below.

For additional notes and limitations, see Known issues.

Item Description
TLS (SSL) certificates

During installation of some components, you have the option to install CA and TLS (SSL) certificates.

These certificates are used for authentication and secure communication. Both certificates must be in *.cer (X.509) format.

  • CA certificate: Enter the path to an existing certificate, or leave it blank to skip the step. The CA certificate should be generated in advance.
  • TLS certificate: Select from an existing certificate file. Alternatively, the certificate can be generated automatically if you provide the CA certificate containing the private key.

For details on generating a CA certificate and working with certificates, see Secure communication with TLS (SSL) .

Security review

We strongly recommend that you install the components on dedicated machines that do not contain, or provide access to, sensitive information; and that you do a thorough security review of the network topology and access levels in your testing environment.

Virtual environments

The architectures provided by virtualization vendors are rapidly evolving. OpenText Professional Performance Engineering is expected to function as designed in these changing environments, as long as the third-party vendor guarantees full compatibility of the virtualized environment with the OpenText Professional Performance Engineering-approved hardware requirements. If you follow the system requirements and support matrix to create the virtual machine, the product will work correctly.

Working on top of a virtual machine may require access to the virtualization server hardware/monitoring environment, to ensure the virtualization server is not saturated; otherwise, this might obscure the virtual machine's measurements and lead to false results.

Permission requirements

The installation process for all components requires a full administrator account (root account for Linux systems) for all operating systems.

You can install components with UAC and DEP enabled, but we recommend to keep them disabled during installation (or enable DEP for essential Windows programs and services only).

After installation, all of the applications and components can run under a standard user account (an administrator account is not required), with UAC and DEP enabled.

Antivirus applications

It is recommended that you close all antivirus applications before installation.

Running Web Services Vusers on Windows

The Axis toolkit and WSE are no longer automatically installed. When running Web Services Vusers on a standalone load generator, some legacy configurations may require activation of .NET 3.5 (see MSDN), the inclusion of the Axis java files, or an installation of WSE (2.0 SP3 and WSE 3.0).

To avoid using these components, recreate the scripts and import the WSDL using the default WCF toolkit.

To use these components:

  • For WSE, install the WSE components from the OneLG installation package's folders, DVD\lrunner\Common\wse20sp3 and DVD\lrunner\Common\wse30, or download them from the Microsoft website.

  • For Axis, copy the Axis java files to <installdir>\bin\java\Axis. For OneLG, the files are located in the prerequisites\Axis subfolder of the extracted installation package, by default <OneLG <version> root folder>\prerequisites\Axis.This allows you to run legacy scripts on an Axis toolkit.

For more details, see Known issues for Web Services.

Running Java Vusers on Windows

OpenJDK 32-bit is no longer automatically installed. To work with Java protocols, you need to manually install a supported version of the JDK. VuGen uses internal logic to automatically detect your JRE version. For details, see Set up the environment for Java protocols.

Coexistence with OpenText Functional Testing

If you install OpenText Professional Performance Engineering and OpenText Functional Testing on the same machine, and then uninstall one of them, the remaining software program may not function correctly.

Resolution: Run a Repair of the software program you want to use on the machine.

Licensing

Note the following regarding licensing:

  • To run Vusers with Controller, there must be a valid license installed on the Controller machine. The Community license bundle is automatically installed (free of charge) during OpenText Professional Performance Engineering setup, providing 50 Vusers.
  • If upgrading from a version earlier than 2020, you need to replace your current license to work with the upgraded installation. If you are using the Community license, it is automatically replaced during installation. For any other license, contact licensing support to obtain a valid, compatible license.

For details on managing licenses and extending your Vuser capacity, see About licenses.

Custom certificates

When upgrading from version 12.55 or earlier, if you used custom certificates in your previous installation, install them again when prompted for certificates during setup. Otherwise, the setup program will overwrite them using the defaults.

Network Virtualization
  • When upgrading from a version prior to 12.50, you must manually uninstall all Network Virtualization components before running the installer.

  • If a firewall is active, open the NV default port 8182 (or another port you select during installation) for TCP. You can set up an exception to Windows Firewall by selecting custom installation in the NV Setup wizard.

  • If you choose to install NV automatically (as part of a full installation), you must deactivate Windows SmartScreen before proceeding with the NV installation.

    Do the following:

    1. Open HKEY_LOCAL_ MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer in the Registry Editor
    2. Change the Value data for SmartScreenEnabled to Off.

    Note: You do not need to deactivate SmartScreen when installing NV individually.

Back to top

See also: