Troubleshooting issues
You can find information about the issues or problems that you might encounter while working with HCL DevOps Test Hub (Test Hub). Details about issues, their causes and the resolutions that you can apply to fix the issues are described.
Problem |
Cause |
Solution |
---|---|---|
On Ubuntu, when you are installing Test Hub 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:
|
You can complete any of the following tasks:
|
On Ubuntu, DNS is not working as expected. |
The DNS configuration that is used by the cluster can be displayed by using the following command: kubectl get cm -n kube-system coredns -ojsonpath="{.data.Corefile}" The forward setting displays the
nameservers that are used. For
example, you might see the following in the
corefile:
.:53 { : forward . 8.8.8.8 9.9.9.9 : } A script (ubuntu-set-dns.sh) is supplied for managing these values. For example, to set the DNS values for the values shown in
the previous
example:
sudo ./ubuntu-set-dns.sh --server 8.8.8.8 --server 9.9.9.9 Note: If
you do not use sudo in the command,
the script runs but the configuration might be lost if
the cluster is restarted. To learn more about the behavior of the script, run the
following
command:
sudo ./ubuntu-set-dns.sh --help |
|
When running helm install the created pods keep crashing, and the logs contain: ACCESS_REFUSED when trying to connect to RabbitMQ | In some instances, the RabbitMQ password is not automatically setup correctly. | Manually apply the necessary
password:kubectl exec -n <namespace> <release-name>-rabbitmq-0 -- rabbitmqctl change_password user \ "$(kubectl get secret -n <namespace> <release-name>-rabbitmq -o jsonpath='{.data.rabbitmq-password}' | base64 --decode)" |
Problem |
Cause |
Solution |
---|---|---|
When a user is assigned an additional role, the change in the permissions is not observed in the browser. |
You must log out of the session and log in again for the changed role to take effect. |
|
You see the following message displayed on Test Hub: You can’t request to join a project that has no owners |
You requested to join an project that no longer has an owner. Orphaned projects occur when the project owners are deleted. This can occur, for example, when the person leaves the organization. |
Ask an administrator to take ownership of the project, and then add you as a member. |
Problem |
Cause |
Solution |
---|---|---|
You encounter errors when you attempt to register a remote Docker host. |
The computer on which you set up the remote Docker is not running or accessible. |
You can issue a ping command by using the hostname or IP address of the remote Docker host computer to verify that the remote host is running and accessible. |
The Common Name or Fully Qualified Domain Name in the Certificate Authority does not match the hostname you specified as the remote Docker host. |
Verify by running the following command: |
|
The argument -traditional was not specified when you generated the RSA key. |
Ensure that you use the -traditional argument when you generate the RSA key. |
|
Connection with the remote Docker host computer fails. |
Perform the following steps:
|
|
Attempt to access the remote Docker host computer by using
the same CA certificate, Client certificate, and Client key
from a terminal window on any computer that is on the same
network as Test Hub by running the following command:
Where HOST is the hostname of
the remote Docker host computer.The output from this command must be clean information about the version of Docker running on the remote host with no errors or exceptions. |
Problem |
Cause |
Solution |
---|---|---|
When you configure a run of a schedule that matches the
following conditions:
|
The cause might be because of the following reasons:
|
To resolve the problem, select from either of the following
methods:
|
You have added a remote repository to your project that
contains the test assets or resources of the following
types:
|
This problem occurs if the server extension is not enabled. Although the extension was enabled at the time of installation of Test Hub, it was disabled subsequently by the server administrator. |
You must verify if the server extension is enabled and running by running the following command: kubectl get pod -n devops-system, where devops-system is the namespace that you created to install Test Hub. The server extensions that are running are displayed. If the server extension that you want is not running implying that the server extension is not enabled. You must enable the server extension. Contact the server administrator to enable the server extension. |
Problem |
Cause |
Solution |
---|---|---|
You encounter any of the following issues:
|
The issue is seen when any of the following events occur:
|
To resolve the problem, you can increase the resource allocation for test runs by using the arguments listed in Table Increasing resource allocation. You can enter arguments in the Additional configuration options field in the Advanced settings panel of the Execute test asset dialog when configuring a test run. 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.
In addition, in the JVM Arguments field under the Advanced settings you can set the maximum heap size for the test run time. For example, adding the JVM argument -Xmx3g sets the maximum heap size to 3Gi. |
You are not able to run Web UI tests on a remote agent that runs on Linux because the browser fails to launch. | Browser launch is prevented when the remote agent runs as root or sudo. | To resolve this issue, you must
perform the following steps after you have installed the remote
agent:
|
Requirement | Configuration option name | Default value, if no value is set | An example value | Result of using the example value |
---|---|---|---|---|
Specifying the memory limit of the init container. |
init.resource.memory.limit |
1024Mi | 2048Mi |
Increases the memory limit of the init container from the default value to 2048Mi. |
Configuring a larger memory request for the init container to avoid pod eviction. |
init.resource.memory.request |
64Mi |
1024Mi |
Increases the initial memory request for the init container from the default value to 1024Mi. |
Specifying the cpu request for the init container. |
init.resource.cpu.request |
50m | 60m |
Increases the cpu request for the init container from the default value 60m. |
Specifying the memory limit of the container used for the
test run.
Note: If the memory limit you
set is more than the default limit, you must run the
following command to increase the allotted limit to 8 GB
or any other value above the default value of 3 GB, at
the time of installing the server or anytime
later: You
must be a server administrator to run this
command. |
resource.memory.limit |
The larger of 3Gi or maximum heap size + 1Gi |
4Gi |
Changes the memory limit of the main container from the default value to 4Gi. |
Specifying the memory request for the container used by the test run. |
resource.memory.request |
1024Mi |
2048Mi |
Increases the memory request for the main container from the default value to 2048Mi. |
Specifying the cpu request for the main container used by the test run. |
resource.cpu.request |
50m | 70m |
Increases the cpu request for the main container from the default value to 70m. |
Problem |
Cause |
Solution |
---|---|---|
You are not able to create Jira work items in Jira. You are also not able to view the created work items in Jira that you created in HCL OneTest™ Server 10.5.4 or earlier. |
The cause can be due to the change in the authentication method used to connect to Jira in Test Hub 11.0.0 or later. |
Reconfigure Jira as a change management system in Test Hub 11.0.0 or later. See Configuration of Atlassian Jira as a change management system. |
You are not able to export results to the Xray project. You are also not able to view the results exported to the Xray project that you created in HCL OneTest™ Server 10.5.4 or earlier. |
The cause can be due to the change in the authentication method used to connect to Jira in Test Hub 11.0.0 or later. |
Reconfigure the Xray project after you reconfigure Jira Test Hub 11.0.0 or later. See Integration with Xray test management for Jira. |