Troubleshooting: HCL® Quality Server
You can use workarounds to troubleshoot common problems that you might encounter when you use HCL® Quality Server.
Problem | Solution |
---|---|
You might encounter issues with startup, web server, unrecognized registration or other messages from agents or proxies while working on HCL® Quality Server. |
Analyze the log files to investigate the issues. The log files are located in the following directories: QualityServer_installation directory\logs QualityServer_installation directory\logs\additional |
After you upgrade to the latest version, you might have issues if you did not close the session with HCL® Quality Server 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 HCL® Quality Server. |
After you install the latest version, if the preferred language is not displayed, you might want to change the runtime language. |
HCL® Quality Server 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 HCL® Quality Server 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 HCL® Quality Server can connect to it. HCL® Quality Server does not load in a browser. The following message is displayed in the log files for HCL® Quality Server: [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 HCL® Quality Server exits with Java heap space errors in its log. HCL® Quality Server is no longer accessible. The process ran out of memory and crashed. The logs/console.log file for HCL® Quality Server 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 HCL® Quality Server 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 HCL® Quality Server, but not the workspace directory. If you roll back the installation of HCL® Quality Server and do not delete the workspace directory, HCL® Quality Server fails to start. |
To roll back HCL®
Quality Server and not reuse the workspace directory, perform the following
steps:
To roll back HCL®
Quality Server and reuse the workspace directory, perform the following steps:
Note: Starting from 9.2.1, when you roll back a version of
HCL®
Quality Server, the workspace cannot be reused and must be reinstalled.
|
HCL OneTest™ API Agent trusts the certificate and so connects to HCL® Quality Server. 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 HCL® Quality Server. |
Perform any of the following actions:
|
You cannot use more than 1000 engines on an agent that is connected to HCL® Quality Server. |
The number of engines that can be used simultaneously on an agent
that is connected to HCL®
Quality Server 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:
|