Troubleshooting: Rational® Test Control Panel
You can use workarounds to troubleshoot common problems that you might encounter when you use IBM® Rational® Test Control Panel.
Problem | Solution |
---|---|
You might encounter issues with startup, web server, unrecognized registration or other messages from agents or proxies while working on Rational® Test Control Panel. |
Analyze the log files to investigate the issues. The log files are located in the following directories: <Rational® Test Control Panel installation directory>\logs <Rational® Test Control Panel installation directory>\logs\additional |
After you upgrade to the latest version, you might have issues if you did not close the session with Rational® Test 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 Rational® Test Control Panel. |
After you install the latest version, if the preferred language is not displayed, you might want to change the runtime language. |
Rational® Test 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 Rational® Test 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:
|
After you upgrade to the latest version, nothing that is configured to communicate with Rational® Test Control Panel can connect to it. Rational® Test Control Panel does not load in a browser. The following message is displayed in the log files for Rational® Test 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 RTCP/config/server.custom.xml file to do one of the following tasks:
|
The process for Rational® Test Control Panel exits with Java heap space errors in its log. Rational® Test Control Panel is no longer accessible. The process ran out of memory and crashed. The logs/console.log file for Rational® Test Control Panel contains the following errors: java.lang.OutOfMemoryError Java heap spaceA Java™ dump output follows. Java™ ran out of memory because Java™ has a fixed upper limit. The start scripts for Rational® Test 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:
|
Verify the contents of the C:\Program Files\HCL\HCLProducts\QualityServer\logs For non-Windows™ systems the log file is typically in the following directory: /opt/HCL/HCLProducts/QualityServer/log Verify the Java™ memory size limit by performing the following steps:
Increase the memory allocation by performing the following steps:
|
Installation Manager supports rolling back the installation of Rational® Test Control Panel, but not the workspace directory. If you roll back the installation of Rational® Test Control Panel and do not delete the workspace directory, Rational® Test Control Panel fails to start. |
To roll back Rational® Test Control Panel and not reuse the workspace directory, perform the following steps:
To roll back Rational® Test Control Panel and reuse the workspace directory, perform the following steps:
Note: Starting from V9.2.1, when you roll back a version of Rational® Test Control Panel, the workspace cannot be reused and must be reinstalled. |
Rational® Integration Tester Agent trusts the certificate and so connects to Rational® Test 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 <HCL Agent installation>\config\ssl\greenhat.jks. |
Stubs that are created for Resource Monitoring do not start in Rational® Test Control Panel. |
Perform any of the following actions:
|
You cannot use more than 1000 engines on an agent that is connected to Rational® Test Control Panel. |
The number of engines that can be used simultaneously on an agent that is connected to Rational® Test 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:
|