Troubleshooting: Installation issues on Linux

You can troubleshoot issues that you encounter while you install or uninstall HCL OneTest™ Server.

The installation process is interrupted and re-installation of the software fails

When the installation of HCL OneTest Server is interrupted and you are unable to reinstall the software, you must remove the previous installation data on your workstation.

About this task

If the installation process is interrupted, you cannot re-install the software until you remove the installation data that was saved when you had installed HCL OneTest Server.

Procedure

  1. Change the directory path to access the registry file by using the following command:
    cd /var
  2. List the hidden file using the following command:
    ls -alt
  3. Back up the .com.zerog.registry.xml registry file .
  4. Modify the .com.zerog.registry.xml registry file based on the number of products that are installed by using the stand-alone installer on your computer. For example:
    • If you have installed only one product by using the stand-alone installer, delete the .com.zerog.registry.xml file.
    • If you have installed multiple products by using the stand-alone installer, then in the registry file, search the product name and delete the <product> tag from the registry file and save the file.

    The following section displays the sample contents of a registry file.

    <product name="HCL OneTest™ Server" id="5ae8ffb0-1f3b-11b2-9e11-832f00f33b90" upgrade_id="f3fa0d58-1f3a-11b2-99bf-832f00f33b90" version="1.0.0.0" copyright="2019" info_url="" support_url="" location="/opt/server_hcl/HCL/OneTest-Server" last_modified="2019-06-26 22:28:03">
<![CDATA[]]>
<vendor name="HCL" id="5ae962f7-1f3b-11b2-9eaf-832f00f33b90" home_page="" email=""/>
<feature short_name="Application" name="Application" last_modified="2019-06-26 22:28:03">
<![CDATA[This installs the application feature.]]>
<component ref_id="f3fa0d7d-1f3a-11b2-99e6-832f00f33b90" version="1.0.0.0" location="/opt/server_hcl/HCL/OneTest-Server/Uninstall/Uninstall-HCL-OneTest-Server"/>
<component ref_id="f3fa0d7c-1f3a-11b2-99e4-832f00f33b90" version="1.0.0.0" location="/opt/server_hcl/HCL/OneTest-Server/images.tar.gz"/>
</feature>
<feature short_name="Help" name="Help" last_modified="2019-06-26 22:28:03">
<![CDATA[This installs the help feature.]]>
<component ref_id="f3fa0d7d-1f3a-11b2-99e6-832f00f33b90" version="1.0.0.0" location="/opt/server_hcl/HCL/OneTest-Server/Uninstall/Uninstall-HCL-OneTest-Server"/>
<component ref_id="f3fa0d7c-1f3a-11b2-99e4-832f00f33b90" version="1.0.0.0" location="/opt/server_hcl/HCL/OneTest-Server/images.tar.gz"/>
</feature>
</product>
  5. Change the current directory to the installation directory in the command prompt by entering the following command:
    cd <directory path>\<installation folder>

    For example, cd opt/HCL/onetest

  6. Execute the following commands:
    • shutdown.sh
    • rm-images.sh --confirm
  7. Delete the installation directory.

Results

The installation directory is deleted.

Installation does not start on Linux computers

The installation of HCL OneTest Server is interrupted on Linux computers because the default firewall setting blocks the communication of Docker with the external network.

About this task

The installation of HCL OneTest Server is aborted at the startup phase and an error message is displayed. The gateway container also fails to start. You must check the startup.txt log file to get the id of the gateway container. You can view the log file of the gateway container by entering the following command:
docker logs <gateway container id>
The gateway container log contains the following error message:
Caused by: java.net.NoRouteToHostException: No route to host (Host unreachable)

For installation to start, you must enable the communication between the Docker and the external network by changing the firewall settings on Linux computers.

Procedure

  1. Change the firewall configuration settings by entering the following commands:
    • sudo firewall-cmd --permanent --zone=public --add-rich-rule='rule family=ipv4 source address=172.16.0.0/12 accept'
    • sudo firewall-cmd –reload
    The Docker can now access the host Linux computer.
  2. Uninstall HCL OneTest Server.
  3. Restart the installation of HCL OneTest Server.

Feedback