Welcome
Troubleshooting HCL OneTest™ Server
While working with HCL OneTest™ Server, you might encounter some problems that you can easily troubleshoot.
Troubleshooting issues
You can find information about the issues or problems that you might encounter while working with HCL OneTest™ Server. Details about issues, their causes and the resolutions that you can apply to fix the issues are described.

Release Notes
This document includes information about What’s new, installation and upgrade instructions, known issues, and contact information of HCL Customer Support.
System Requirements
Getting started guide
This guide, which is intended for new users, provides an overview and some task flows to get you started with HCL OneTest™ Server.
Administrator guide
This guide, which is intended for an administrator, describes how to install HCL OneTest™ Server software. After you install the software, you can administer the server. Administration tasks can include License configuration, User management, Security, Memory and disk usage management, Backup and restore user data.
Test Author guide
This guide, which is intended for a tester and test manager, describes how to create test assets in HCL OneTest™ Server and publish test assets to the Git repository that you have configured.
Test Execution Specialist guide
This guide, which is intended for a tester or a test execution specialist, describes tasks that you must complete before you can configure and run tests on HCL OneTest™ Server. You can find information about other tasks that you can perform on the Resource Monitoring Service, Virtualization, and Integrations with third-party applications.
Test Manager guide
This guide, which is intended for a test manager, explains how to manage and track your overall test effort.
Reference Guide
This guide describes conceptual information about data design environment components when you want to use the data fabrication feature in HCL OneTest™ Server.
Troubleshooting HCL OneTest™ Server
While working with HCL OneTest™ Server, you might encounter some problems that you can easily troubleshoot.
- Troubleshooting issues
  You can find information about the issues or problems that you might encounter while working with HCL OneTest™ Server. Details about issues, their causes and the resolutions that you can apply to fix the issues are described.
- Troubleshooting
  You can troubleshoot some of the common problems that you might encounter when you use HCL OneTest™ Data.
All Guides (PDF)
You can find the link to view or download the content of the release notes, system requirements, and persona guides of HCL OneTest™ Server as a PDF file.
Security considerations
For HCL OneTest™ Server, you can take actions to ensure that your installation is secure, customize your security settings, and set up user access controls.
Notices

Troubleshooting issues

You can find information about the issues or problems that you might encounter while working with HCL OneTest™ Server. Details about issues, their causes and the resolutions that you can apply to fix the issues are described.

The troubleshooting issues are presented to you in the following tables based on where or when you might encounter these issues on HCL OneTest™ Server.

Troubleshooting issues: installation
Troubleshooting issues: server administration
Troubleshooting issues: resource monitoring
Troubleshooting issues: test or stub runs
Troubleshooting issues: test results and reports

Table 1. Troubleshooting issues: installation
Problem	Description	Solution
When you are installing the server software and you encounter errors in the scripts that are running.	At times, scripts might not appear to be running due to any of the following reasons: Slow connection speeds. Insufficient CPU, memory, or disk resources. A firewall that was configured incorrectly is already enabled.	You can complete any of the following tasks: To identify the issue, you can perform a diagnostic check by running the following command:microk8s.inspect Run the following command to see what is not running:kubectl get pods -ARun the following command to get details about the pods: kubectl describe pod Follow the on-screen instructions to resolve the errors. Some issues can be solved by re-running the following script:ubuntu-init.sh
The DNS is not working as expected.		You can change the nameservers by using the following command:kubectl edit cm coredns -n kube-system The changes are applied when you restart the coredns pod. If you are unsure of how to do this you can run the following script that helps you manage the DNS settings: ubuntu-set-dns.sh

Table 2. Troubleshooting issues: server administration
Problem	Description	Solution
Less recently patched versions of OpenShift can give errors when ever OpenShift performs internal checks. For example, the following error is displayed: ValidationError(Route.spec.to): missing required field "weight"	The errors are caused because OpenShift performs the internal checks that are invalid.	Apply the latest OpenShift patches when they become available. If you do not want to apply the patches or cannot apply the patches, you can disable these checks in OpenShift by appending the following option to the helm command: --disable-openapi-validation
If your user-realm role is changed when you are logged in a session, the changed role is not applied immediately or even after the browser is refreshed.		You must log out of the session and log in again for the changed role to take effect.

Table 3. Troubleshooting issues: resource monitoring
Problem	Description	Solution
You are not able to add a Prometheus server as a Resource Monitoring source.	The cause might be that you have not installed the Prometheus server at the time of server installation.	Verify that the Prometheus server was installed in Helm at the time of server installation. See Installing the server software on Ubuntu using microk8s. If not, consult your cluster administrator to get the Promethues server installed and configured.

Table 4. Troubleshooting issues: test or stub runs
Problem	Description	Solution
When you run tests and you encounter any of the following issues: Out of memory errors. Observe that the test runs are slow with a high CPU usage.	The issue is seen when the memory that is used by the particular test during the test run exceeds the allocated default memory of 3 GB.	You can increase the memory usage for the test run in any of following ways: Specifying a maximum heap size for the test run. Specifying the container memory limit explicitly for the test run. You can set the heap size or set the memory limit by performing the following steps when you configure the test run: Click Advanced in the Execute test asset dialog box. Enter any of the following arguments in the Java Arguments field: `-Xmx4g` Configuring this argument enables the allotted `3 GB` memory to be increased to `4 GB`. `-Dexecution.resource.memory.limit=<custom_memory_value>Gi` Note: You must enter the value for the memory limit that you want in <custom_memory_value>. For example, if you want to set the memory limit to `5 GB`, the argument can be: `-Dexecution.resource.memory.limit=5Gi`. The argument enables the memory to be set to `5 GB` and overrides the default memory size. Configure the other settings for the test run and run the test. Important: The memory settings that you configure for a test run is persisted for the test when ever you run it. You must use this setting judiciously. Configuring all tests for an increased memory limit might affect subsequent test runs or cause other memory issues when tests run simultaneously.
You are not able to run the Istio stubs from the Execution page.	The cause might be that you have not enabled the service visualization via Istio at the time of server installation. The default configuration does not enable service virtualization via Istio.	Contact your cluster administrator or if you have the privileges, configure Helm as follows: For Multi-tenant clusters If the cluster is shared and the product may only virtualize services running in specific namespaces then add the following parameter to the Helm install: --set execution.istio.enabled=true Then enable service virtualization in specific namespaces using this command: kubectl create rolebinding istio-virtualization-enabled -n {namespace} --clusterrole={my-ots}-execution-istio-test-system --serviceaccount=test-system:{my-ots}-execution Note: Uninstalling the chart does not clean up these manually created role bindings. For Single-tenant clusters If the cluster is not shared and the product may virtualize any service running in the whole cluster then add the following parameters to the Helm install: --set execution.istio.enabled=true --set execution.istio.clusterRoleBinding.create=true
	The cause might be that the fully qualified domain name is not specified in the Host field for the stub when it was created.	Verify and ensure to add the fully qualified domain name of the server in the Host field when the physical transport for the stub is configured in HCL OneTest™ API.

Table 5. Troubleshooting issues: test results and reports
Problem	Description	Solution
You are not able to view the Jaeger traces for the tests you ran.	The cause can be as follows: Might be that you have not installed Jaeger at the time of server installation. The Jaeger trace is not supported for the particular test you ran.	Check for any of the following solutions: Verify that Jeager was installed in Helm at the time of server installation. See Installing the server software on Ubuntu using microk8s. If not, consult your cluster administrator to get Jeager installed and configured. Verify that the tests you ran are supported for Jaeger traces. See Test results and reports overview.