Troubleshooting: Installation and configuration

You can troubleshoot some of the problems that you might encounter when you are installing and running HCL OneTest™ API.
Table 1. Troubleshooting HCL OneTest API installation and configuration issues
Problem Description Solution
Project fails to open - duplicate items Each file within an HCL OneTest API project has a unique identifier of the following format:editableResource createdTimestamp="1317292623890" createdUser="atester" id="-44ea417a:132b496f2c1:-7e17" type="test_resource"

This problem is caused by project files that are copied by using the operating system rather than copying within HCL OneTest API.

HCL OneTest API must always be used to copy objects.

The error message lists which files have the same IDs and the solution is to remove one of them and reopen the project.

HCL OneTest API fails to start In some cases, the HCL OneTest API workspace can become corrupted. Try renaming the .integrationtester folder and restarting HCL OneTest API.
Unix-like systems: program does nothing and exits   In HCL OneTest API Installation Directory\configuration, check for log files with the file name format UTC timestamp.log (for example, 1253866725028.log). A new log file is created for each execution of HCL OneTest API and Library Manager (LibConfig).
Linux systems: fail to start - java.lang.UnsatisfiedLinkError  

If the following error occurs, you need to install the libXtst package:

java.lang.UnsatisfiedLinkError: /home/root/jdk1.6.0_16/jre/lib/i386/xawt/ cannot open shared object file: No such file or directory

Contact your system administrator for assistance.

After installing the latest version of HCL OneTest API, you want to change the runtime language.  
  1. Run the Library Manager and add the following entry on a separate line in the JVM Arguments field on the Application page of Library Manager:
    -Duser.language=<Java language>

    For a list of language codes, see JDK 7 and JRE 7 Supported Locales. HCL OneTest API supports a subset of these language codes as documented in a PDF document in the HCL License & Delivery Portal.

    For example, if you want to display HCL OneTest API in Spanish, you use the following code:

    For more information about using Library Manager, see Working with the Library Manager.

  2. To use this language, restart HCL OneTest API.