Share this page

# Known issues

This section provides general notes and limitations.

Additional known issues and workarounds are included in the relevant sections of the Help Center.

In this topic:

## Installation and upgrade

Read the following before installing, uninstalling, or upgrading your components:

Item | Description
--- | ---
Install permissions | The installation process for all components requires a full administrator account (root account for Linux systems) for all operating systems. You can install the 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.
License update | When upgrading from a version earlier than version 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 support to obtain a valid, compatible license. For more information, see Manage and install licenses.
Virtual environments | The architectures provided by virtualization vendors are rapidly evolving. Virtual User Generator 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 Virtual User Generator-approved hardware requirements. If you follow the system requirements and support matrix to create the virtual machine, Virtual User Generator 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.
Security - CA certificate | This product works with OpenSSL, which enforces additional constraints for secure communication. OpenSSL requires that the basic constraints for a CA certificate include a confirmation that the certificate is a CA certificate. Use the provided tools to create and install a new CA certificate and new TLS certificates on each Virtual User Generator machine. For details, see Configure secure communication with TLS (SSL) . Organization's CA: If your CA certificate is provided by your organization, verify that the certificate includes the constraints described above. If the required constraints are not defined, your IT department should provide updated CA and TLS certificates to install on the machines. To verify: Check that the constraint is defined for the CA certificate in the Basic Constraints extension, for example, Subject Type=CA or CA:TRUE (the constraint format varies, depending on how the certificate was accessed). On Windows: Double-click the CA certificate and select the Details tab. Select Extensions only from the Show list, then select Basic Constraints and check that the constraint is defined in the properties area. On Linux: Use the following command to view certificate information: openssl x509 -in <CA-filename> -noout -text.
Anti-virus applications | It is recommended that you close all anti-virus applications, such as McAfee or Aladdin's eSafe, before installation.
Virtual Table Server (VTS) upgrade | When upgrading VTS, first uninstall the older version, then reinstall the latest version from the Additional Components folder. If you are upgrading VTS from a version earlier than 2020 SP1, then export the VTS data into a CSV file before uninstalling the older version. After installation of the new version, import the exported data into VTS. For more details, see Install VTS. The default data path for VTS has been updated to <VTS root folder>\db\data. To continue using your current data path: When prompted during the installation, redirect the data path to your current data path. After installation, update the dbPath value in the VTS configuration file. Then restart the VTS service.
Coexistence with OpenText Functional Testing products | We recommend that you do not install Virtual User Generator components and OpenText Functional Testing for Developers on the same machine. Doing so may cause issues when invoking the Analysis API from an external code or plugin (for example, Jenkins), with recording and code generation for Java protocols, with Network Virtualization replay, TruClient functionality, and other issues. If you try to continue to work while these issues exist, it may cause the components to malfunction. Possible workaround: Before proceeding, make sure that OpenText Functional Testing for Developers is excluded from the PATH environment variable on the machine. zz z If you install or uninstall components on a machine where OpenText Functional Testing is also installed, at the end of the process a warning message is displayed: "Cannot load resource file <somepath>/mdrv_res.e2 (<somepath>/mdrv_res.j2)." Ignore this message. If you install Virtual User Generator 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. A machine on which OpenText Functional Testing was installed after Virtual User Generator may not allow the recording of certain protocols. Resolution: Uninstall OpenText Functional Testing and run a Repair on the Virtual User Generator installation. If you install OpenText Functional Testing on a load generator machine when the load generator agent is running, the remote Controller may not be able to run OpenText Functional Testing scripts on the load generator machine. Resolution: After installing OpenText Functional Testing, restart the load generator agent using the Agent Configuration utility, or alternatively reboot the machine.
Uninstall | If you have multiple Virtual User Generator components installed together on a machine (for example, both VuGen and Analysis, standalone versions), and you uninstall one of the components, run a Repair installation on the remaining components after the uninstall. If you have VuGen standalone and OpenText Business Process Monitoring (BPM) installed together on a single machine, and you uninstall BPM, run a Repair installation on VuGen. When uninstalling a load generator on a Linux machine, the uninstall process may fail and you may get an error message saying "Cannot restore segment port after reloc: permission denied." Resolution: Use the setenforce 0 command to deactivate SE Linux before uninstalling the load generator. When the uninstall is complete, use the setenforce 1 command to enable SE Linux.

Back to top

## Microsoft Windows

Note the following when working with a Microsoft Windows OS:

Microsoft Windows 10 and Windows Server 2016

Item | Description
--- | ---
Default browser | When working with Windows 10 or 2016, we recommend using Internet Explorer (IE) 11 as the default browser; using the Edge browser interferes with some of the advanced functionality. Use IE as the default browser with Windows 10 to prevent issues with proxy recording and certificate settings.
Windows Sockets (Winsock) | Recording Winsock scripts on older Microsoft Edge browsers is not supported. Recording is supported on the Chromium-based Microsoft Edge browser.

Microsoft Windows 10 May 2019 Update (1903)

Item | Description
--- | ---
Docker | Publishing a container port fails on Windows 10 1903. As a result, Dockerized load generators are not supported when using Windows 10 1903 edition. (Recommended OS: Windows Server 2019, build 17763)

Back to top

## Permissions

The following describes possible issues with permission settings:

Item | Description
--- | ---
License utility | When running the License Utility with UAC enabled, you are prompted for administrator credentials. Resolution: Run the utility as administrator.
Web scripts and IE ESC | On a Window Server operating system when recording Web protocol scripts, or recording and replaying TruClient - Web scripts, it is recommended to deactivate Internet Explorer Enhanced Security Configuration (IE ESC). IE ESC blocks certain actions. This may prevent the automatic download of files that are necessary for your workflow. Resolution: In Windows 2016 or 2019 select Server Manager > Local Server > Internet Explorer Enhanced Security Configuration.
Web scripts and DEP | When recording a Web-based protocol script, the recording may fail in certain installations, if Data Execution Prevention (DEP) is enabled. Resolution: Deactivate DEP on your VuGen machine. For details, see Record a Vuser Script.
IP Wizard | The IP Wizard does not function for a Limited user. Resolution: Run the IP Wizard with administrator permissions. The IP Wizard uses raw sockets to communicate with remote machines. Therefore, administrative privileges are required for opening and using raw sockets in socket-based communication. For more information, see TCP/IP raw sockets in the Microsoft documentation,. Alternatively, you can set the IP Wizard settings locally on the target machine.
Load generator on Linux | The network settings for load generators on Linux machines cannot be configured by a standard (non-administrator) user account. Resolution: When working on a Linux operating system, run lr_agent_settings with administrator permissions.
Trusted sites | When opening an OpenText site in the embedded browser, if the site is not included in the trusted sites list, you may be prompted to add the site to the trusted site list. After adding the site, you might receive a Web site scripting error. Resolution: Close the error and continue working as you normally would.
McAfee | When McAfee On-Access file scan is enabled, it may block/revert some of the file-writing operations performed during code generation, particularly when asynchronous communications have been detected. As a result, the content of some of the script actions may be lost; these actions will be empty instead of containing the required generated Async code. Resolution: Exclude VuGen files from the scan. When McAfee Host Intrusion Prevention (HIP) is enabled, a crash may occur while recording a web-based protocol script, including Java over HTTP, especially if the current user account is a limited account (non-admin). In addition, you may experience browser malfunctions, even when working with a full-privileged user account. McAfee's anti-virus application blocks port 443, which is the default port for the OpenText Professional Performance Engineering Agent. Resolution: Manually enable this port. To enable the port, open the McAfee Configuration dialog box. In the Firewall Policy tab, add a new rule to allow Port 443 - Action: Permit IP: TCP, Incoming traffic for the OpenText Professional Performance Engineering Agent Process.

Back to top

## VuGen and protocols

The following describes some general known issues when working with VuGen and VuGen protocols.

Item | Description
--- | ---
TruClient 2.0 | For TruClient 2.0 scripts, in the General settings dialog box > Client certificate tab, the Attach certificate button is unresponsive. Resolution: See this knowledge base article: The attachment certificate button is unresponsive.
DevWeb | From version 2020, the TruWeb protocol is renamed to DevWeb. When running Vusers for DevWeb/TruWeb scripts in Virtual User Generator, they consume license capacity as part of your community license, or protocol license for Web - HTTP/HTML.
Recording | When recording, if Microsoft User Experience Virtualization (UE-V) or Microsoft Application Virtualization (App-V) is enabled, it might block the recording (hooking) mechanism and cause recording to fail.
SSL | SSL2 is no longer supported. When recording a script, some applications may be unable to connect to a server using SSL. Errors such as "Invalid certificate" and "SSL Handshake Failed" may appear. This is because VuGen now uses SHA-256-signed certificates for recording of SSL-encrypted communication instead of the older SHA-1-signed certificates. Resolution: Instruct VuGen to use SHA-1-signed certificates, as follows: Add the following lines to <installdir>\config\vugen.ini: [WebRecorder] ProxyCertificateHash=sha1 Delete the following files from <installdir>\bin\certs\: wplusCA_Expiration_2022.crt wplusCAOnly_Expiration_2022.crt wplusCert_Expiration_2022.crt Restart VuGen and record the application again.
Proxy settings | When working in VuGen with a DevWeb script, some components may hang, and not be able to download the content. This includes components such as Recording Options, Parameters dialog, Snapshots Viewer, and the script uploader Resolution: Change the Local Area Network (LAN) proxy server settings on your machine: If you have set up your machine to Use a proxy server for your LAN, make sure the option to Bypass proxy server for local addresses is also selected. In some cases, when you use the proxy to record a local application, the proxy settings are not automatically restored to their original values after the recording session. This can prevent your computer from accessing local and external Internet sites. Resolution: In your browser, manually reset the proxy settings. If the proxy settings are incorrect, this can greatly increase the load time for the Runtime Settings. Resolution: Make sure all proxy and connection related settings are correct. Alternatively, use a direct connection.
Creating scenarios | When you use VuGen to create a scenario, if Controller is open (and was opened by double-clicking a .lrs scenario file), you are not given the option to add the script to the current scenario, and Controller will be closed, losing any unsaved changes.
DFE | Data Format Extensions (DFEs) are supported on Windows operating systems only.
Replay - JSON | Parsing a long JSON in the Replay log, or a JSON file containing a long line, may cause a short delay when scrolling in the Replay log.
Java | When you run a Java protocol script, the replay status may be Script Not Run and some errors may appear in the mdrv.log file. However, due to Java internal architecture, these errors may not be included in the VuGen Output and Errors panes. This occurs when VuGen fails to initialize a Java Vuser, and JVM then terminates the replay process. Resolution: Look for errors directly in the mdrv.log file (you can find this in the script’s folder). If the entry in the log is due to a memory-related issue, try using different memory options for Java in the runtime settings. Java-based technologies are not yet supported by Microsoft Edge. Therefore, we do not recommend selecting this browser emulation for the replay of Java-based protocols (Java over HTTP, Oracle NCA). Java includes parameters to define the maximum metaspace/heap size, and the commit size (reserved memory), that are used for Java processes. You can view the values for these parameters by running the command: `java -XX:+PrintFlagsFinal` To avoid issues, note the following: The maximum metaspace size is calculated considering the actual memory capacity of the machine. For example, for Java 1.8, the size is calculated as 25% of the possible maximum value. We recommend that you increase the calculated value for better performance. The commit size is greater than the memory that is actually used, and it scales with the maximum heap size (Xmx). We recommend to decrease the commit value, so that more Java processes can be opened on the machine without running out of memory. You can change the maximum metaspace and commit size values by adding arguments to the Java command line. In the Runtime Settings, add this value: -XX:MaxMetaspaceSize=34359214080 -Xms10m -Xmx110m The maximum value (Xmx) should be determined after running the script and looking at the Java memory consumption.
JavaScript | If your JavaScript language script runs slow in VuGen, disable the debugging option: In the Internet Protocol runtime settings, open the Preferences view and locate the JavaScript section. Clear the Enable JavaScript debugging mode option. For details, see Preferences view - Internet protocol.
C Vuser scripts | 64-bit replay for C Vuser scripts is not supported on Linux-based load generators.
Web - HTTP/HTML | Web Page Diagnostics are not supported for scripts using HTTP/2 protocol. Deactivate Web Page Diagnostics in the Controller > Diagnostics > Configuration > Diagnostics Distribution dialog box. Uploading a buffer (request body) larger than 64 KB is not supported for scripts using HTTP/2 protocol. When replaying scripts using HTTP/2 protocol, WebSocket-related APIs (for example, web_websocket_connect) still use HTTP/1.1.
VBScript | Runtime errors generated during the replay of VBScript scripts may not be handled properly. It is recommended that you port existing VBScript scripts to C. Possible resolution: Enable the Continue on Error option in the Runtime settings.
Conditional breakpoints | When adding a conditional breakpoint based on a parameter value, the value is not updated immediately. Therefore, in the script step that follows, the condition may be ignored even though the argument value has been updated.
VTS | When you stop a named VTS instance, the instance may continue to run until you restart the VTS Windows service, which will block you from creating an instance with the same name or port. Resolution: Restart the VTSService Windows service. For example, use the “net stop vtsservice” to stop the service, and “net start vtsservice” to restart it.
WinInet replay | When using the WinInet replay engine, you may encounter the following error: "HttpSendRequest" failed, Windows error code=12002. This HttpSendRequest timeout occurs when a transaction takes more than 30 seconds (default timeout setting) to connect to the server. Resolution: Change the default timeout setting for the WinInet replay engine. In the Registry Editor, open HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Internet Settings and change the default time (30 seconds) to 180 seconds: "SendTimeOut"=dword:0002bf20 "ReceiveTimeOut"=dword:0002bf20
Git integration | When connecting to GitHub from VuGen on a corporate machine that requires a proxy, the connection might not work correctly. Resolution: Try to define Git proxy, and run VuGen as administrator.
Runtime Settings | In the Runtime Settings user interface, the Import, Export, and Search buttons have been temporarily removed. They will be restored in a future version.
JVM | If you install or upgrade a JVM while VuGen is open, you need to restart VuGen before continuing to record or develop a script. Resolution: Add an entry "about:internet" to the Trusted Sites in the browser.

Back to top

## Controller and load generators

The following describes some general known issues when working with Controller and load generators.

Item | Description
--- | ---
Running scenarios | When using Controller with MI Listener, and Network Virtualization is enabled, you may encounter the following issues: When you start a scenario, the first batch of Vusers go directly from pending to stopped. All other Vusers run as expected. When you stop a scenario, all Vusers are stopped, and the Start Scenario button is enabled for 1 second then returns to disabled, and stays disabled. Resolution: Delete the first Vuser, the Start Scenario button then reverts to enabled.
High definition display | Controller is not supported on display monitors with 4K or higher resolution (UHD).
SiteScope monitor | When using the SiteScope monitor, you cannot change the counters already saved with the scenario. Resolution: Remove all existing SiteScope counters, close the dialog box and re-add them.

Back to top

## Network Virtualization and Service Virtualization

Item | Description
--- | ---
NV on Linux | As of version 2023, Network Virtualization is no longer supported on Linux load generators.
NV installation | The Setup wizard prompts you to install Network Virtualization at the conclusion of the installation. If you did not install the component as part of the overall installation, you can run the Network Virtualization installation manually at any time. When installing Network Virtualization on Windows in custom mode, you must manually reboot the machine at the end of installation.
NV Licensing | Network Virtualization usage is included with the Virtual User Generator protocol licenses; network emulation and NV Insights do not require any additional license purchase.
NV Virtual Locations | Analysis Summary reports and NV Insights show None as the Virtual Location name, even though no groups with this name were defined in a scenario. Resolution: See this knowledge base article: Analysis Summary reports and NV Insights show “None” as the Virtual Location name.
SV and SSL | If a Service Virtualization server uses credentials for both SSL and monitors, then the Service Virtualization project cannot be correctly imported to a scenario. Resolution: Configure the Service Virtualization server to use credentials only for SSL.

Back to top

## General

Item | Description
--- | ---
OpenText Application Quality Management | When integrating with OpenText Application Quality Management, if you have a slow connection this may be because the machine does not have access to the WAN, and so cannot verify the digital signature of the relevant files. Resolution: Download and import the certificates from the GlobalSign Root Certificates site using certmgr MMC until the issue is resolved (you might not need to import all the certificates).
Scaling and zoom | Changing the display settings, to reset the display scale and zoom, is not supported for any components.

Back to top

## Non-English operating systems

Item | Description
--- | ---
Language pack installation | If you install a language pack after you have already generated an Analysis session, you will not be able to open the session file (.lra). You can only open it on a machine with the same regional settings as the machine upon which it was generated. You can, however, open the raw results, the .lrr file.
Untranslated items | On non-English operating systems, several components may contain untranslated items, such as the Print Preview page in VuGen, log files, and installation screens.
Chinese OS | VuGen cannot record a Vuser script for certain protocols if installed on a Chinese operating system, and the installation path contains Chinese characters.
Path names | Path names cannot be in multi-byte format.
System locale | Controller decodes and displays strings in the script based on the selected system locale on the machine (defined in the Region Settings). For transaction names to be displayed properly, the script encoding must correspond with the system locale on the machine. Alternatively, instead of modifying the system locale, you can do one of the following: Modify the Controller settings to use UTF-8 encoding for transaction names. For details, see Convert transaction names to UTF-8 encoding. Convert the transaction names using the lr_convert_string_encoding function. For details, see Convert the encoding format for strings.
.NET | When recording a .NET script on non-English operating systems with McAfee anti-virus active, it may issue the following message "The solution has been changed externally". Resolution:: Add the vugen.exe process to the Low-Risk processes in the McAfee antivirus On-Access Scan Properties.

Back to top

## Documentation

IE ESC | When components are installed on a Windows Server operating system, Internet Explorer Enhanced Security Configuration (IE ESC) must be disabled in order to view Help Center content. It is enabled by default. Resolution: In Windows 2016 or 2019 select Server Manager > Local Server > Internet Explorer Enhanced Security Configuration.
Trusted domains | On certain machines with high level security settings, you need to trust the domain (admhelp.microfocus.com/lr, admhelp.microfocus.com/vugen, admhelp.microfocus.com/lrd) in order to view the Help Center. Resolution: Open the Help Center in IE or Edge, and accept the site as a trusted domain. Then you will be able to use the context sensitive and menu help from the product.
Help link gives 404 | If a help link results in a 404 (page not found) error, try the following: On the 404 page, click Home Page to access the home page for the latest help, then select the relevant version from the version dropdown list. If the link was saved from a previous version, try replacing the version number in the URL with latest. For example, change: https://admhelp.microfocus.com/lr/en/2022/help/... to: https://admhelp.microfocus.com/lr/en/latest/help/...
Online help access | If the online help center is unavailable at the start of an Virtual User Generator application session (for example, because internet access is down), this can cause the Open Online option to remain disabled during the whole session with that application. Resolution: Start a new session. Install the help locally. For details, see Download Help Center.

Back to top

See also:

- Deprecated features

https://admhelp.microfocus.com VuGen,Professional Performance Engineering,Performance Engineering for Developers 8942
Tips to improve your search results... OpenText™ Virtual User Generator Help Center OpenText™ VuGen Help 25.1-25.3 All View Local Help Center View Online Help Center Version: