Troubleshooting: DevOps Test Virtualization Control Panel

You can use workarounds to troubleshoot common problems that you might encounter when you use HCL DevOps Test Virtualization Control Panel (Test Virtualization Control Panel).

Problem Solution

You might encounter issues with startup, web server, unrecognized registration or other messages from agents or proxies while working on Test Virtualization Control Panel.

Analyze the log files to investigate the issues. The log files are located in the following directories:

C:\Program Files\HCL\DevOpsTestControlPanel\logs

C:\Program Files\HCL\DevOpsTestControlPanel\logs\additional

After you upgrade to the latest version, you might have issues if you did not close the session with Test Virtualization Control Panel in the web browser.

Refresh the session in the browser by using the Shift+F5 keys or close the Browser tab, and then log in to Test Virtualization Control Panel.

After you install the latest version, if the preferred language is not displayed, you might want to change the runtime language.

Test Virtualization Control Panel typically detects the language of the browser configuration and displays that language. However, if that is not the case, you can modify the URL that is used to access Test Virtualization Control Panel by adding the language that you want to use. For example, if you want to display French, you can use the following code:

https://mydefaultServer:5443/RTCP/?locale=fr

After you upgrade to the latest version, nothing that is configured to communicate with Test Virtualization Control Panel can connect to it. Test Virtualization Control Panel does not load in a browser.

The following message is displayed in the log files for Test Virtualization Control Panel:

[ERROR] CWWKT0022E: The configured host 0.0.0.0 for HTTP endpoint defaultHttpEndpoint could not be resolved. The endpoint has been disabled.

Edit the C:\Program Files\HCL\DevOpsTestControlPanel/config/server.custom.xml file to do one of the following tasks:
  • Replace 0.0.0.0 with *.
  • Remove the host attribute to use the default.
  • Remove the entire httpEndpoint element to use the default for all its attributes.

The process for Test Virtualization Control Panel exits with Java heap space errors in its log.

Test Virtualization Control Panel is no longer accessible. The process ran out of memory and crashed.

The logs/console.log file for Test Virtualization Control Panel contains the following errors:

java.lang.OutOfMemoryError Java heap space

A Java dump output follows.

Java ran out of memory because Java has a fixed upper limit.

The start scripts for Test Virtualization Control Panel do not explicitly set the Java memory size limit. The server uses a default value that is calculated by using the system memory.

Typically, the scripts allocate 512 MB of memory.

This problem can be caused by any of the following tasks:
  • Publishing large projects
  • Deploying large projects
  • Viewing large reports in the web interface of Test Virtualization Control Panel, for example, those of Test Performance.

Verify the contents of the console.log. For Windows systems the log file is typically in the following directory:

C:\Program Files\HCL\DevOpsTestControlPanel\logs

For non-Windows systems the log file is typically in the following directory:

/opt/HCL/DevOpsTestControlPanel/log

Verify the Java memory size limit by performing the following steps:
  1. Open a command window on Test Virtualization Control Panel.
  2. Go to the installation directory for Test Virtualization Control Panel and find the jre/bin folder.
  3. On Windows systems, run the following command: java -verbose:sizes -version

    On non-Windows systems, run the following command: ./java -verbose:sizes -version

  4. Locate the value of -Xmx, for example:-Xmx512M memory maximum
Increase the memory allocation by performing the following steps:
  1. Shut down Test Virtualization Control Panel.
  2. Edit setenv.bat or setenv.sh depending on the operating system. Add the following setting: JVM_ARGS=-Xmx1024M -Djava.net.preferIPv4Stack=true ...
  3. Restart Test Virtualization Control Panel.
  4. Check and reconfigure this value after a version update as the change is overwritten.

Installation Manager supports rolling back the installation of Test Virtualization Control Panel, but not the workspace directory. If you roll back the installation of Test Virtualization Control Panel and do not delete the workspace directory, Test Virtualization Control Panel fails to start.

To roll back Test Virtualization Control Panel and not reuse the workspace directory, perform the following steps:
  1. Uninstall the current version of Test Virtualization Control Panel and delete the workspace directory while uninstalling the server.
  2. Install the earlier version of Test Virtualization Control Panel with a new workspace directory.
To roll back Test Virtualization Control Panel and reuse the workspace directory, perform the following steps:
  1. Uninstall the current version of Test Virtualization Control Panel and do not delete the workspace directory while uninstalling the server.
  2. Install the earlier version of Test Virtualization Control Panel.
  3. Configure the workspace directory to work with the earlier version of Test Virtualization Control Panel.

    For more information about reusing the workspace and upgrading Test Virtualization Control Panel, see the related links.

Note: Starting from 9.2.1, when you roll back a version of Test Virtualization Control Panel, the workspace cannot be reused and must be reinstalled.

Test Integrations and APIs Agent trusts the certificate and so connects to Test Virtualization Control Panel.

When it attempts to run a stub by using RunTests it fails and you see errors in the log file. For example: SEVERE: Unable to poll commands from server: com.ibm.jsse2.util.h: PKIX path building failed: java.security.cert.CertPathBuilderException: PKIXCertPathBuilderImpl could not build a valid CertPath.; internal cause is: [RunTests/instance1 (0)]: java.security.cert.CertPathValidatorException: The certificate issued by CN=ACD Sample Test SHA256, OU=397 480 930, O=SAMPLE COMPANY, C=FR is not trusted; internal cause is: ...

Add your certificate to the Agent trust store and restart the agent.

The default trust store is located in the following directory: C:\Program Files\HCL\DevOpsTestAPIAgent \config\ssl\greenhat.jks.

Stubs that are created for Resource Monitoring do not start in Test Virtualization Control Panel.

Perform any of the following actions:
  • When you add the JVM arguments to Library Manager for Resource Monitoring, you must change the dependent parameters or use different values for the parameters in the arguments.

    For example, you must set a different port from the port that is already set either in the previous version of the application or set during the previous installation of the application.

  • Enter valid JVM arguments to Library Manager.

You cannot use more than 1000 engines on an agent that is connected to Test Virtualization Control Panel.

The number of engines that can be used simultaneously on an agent that is connected to Test Virtualization Control Panel is limited to 1000 engines. If required, you can increase the number of engines to any number that you want by performing the following steps:
  1. Edit the vie.server.properties file that is located in the following path:

    C:\Program Files\HCL\DevOpsTestControlPanel/usr/servers/defaultServer/apps/RTCP.war/WEB-INF/classes/

  2. Add the attribute and the number of engines that you want to use as its value, as follows:

    max.engines.per.agent=<the_value_required>

  3. Save and close the properties file.
  4. Restart Test Virtualization Control Panel.