HCL OneTest API and HCL OneTest Virtualization release notes for V10.0.1

Read about new features, system requirements, installation, known issues, known limitations, and support for HCL OneTest™ API and HCL OneTest Virtualization V10.0.1.


This offering includes the following installable components:
  • HCL OneTest API, a scripting-free environment for developing tests for SOA messaging and business process integration projects. Tests can be built by recording existing system behaviors or from requirements, by entering the data to send and the data that is expected in return. You can also create virtual services to remove test dependencies and enable earlier testing. Virtual services can be deployed by HCL OneTest Virtualization to provide on-demand virtualized test environments that can support all phases of the test development lifecycle.
  • HCL Quality Server, a server-based web application that provides a central repository for virtualized services. With HCL Quality Server, you can use virtual services that are published by HCL OneTest API to create, share, and deploy virtualized test environments in HCL OneTest Virtualization. It also contains technology-specific components that are used by HCL OneTest API for recording SOA message conversations, HTTP(S) and JDBC traffic, and for monitoring middleware systems under test with minimal reconfiguration of client applications.

What’s new

The following sections list the new features, enhancements or other changes made in V10.0.1.

HCL OneTest Server

For information about HCL OneTest Server V10.0.1, see Release notes.

HCL Quality Server

The list of agents changed for a release was updated. See the Tools page of HCL Quality Server to see each tool and the version that it was last changed.


Only 64-bit architectures are now supported during the installation of HCL OneTest API. For this reason all 32-bit options were disabled. Raising a defect in HP Quality Center was only supported on 32-bit windows, so this feature was removed.


  • The CICS DPL agent now displays version 10.0.1 when starting. The version 10.0.1 agent functions the same as the version 10.0.0 agent, and there is no need to upgrade to the newer agent.
  • The IBM® WebSphere® MQ exit for z/OS now displays version 10.0.1 when starting. The 10.0.1 exit functions the same as the 10.0.0 exit, and there is no need to upgrade to the newer exit.


  • In HCL OneTest API, when you save the generated output from the Generate External Tool Configuration wizard (for example, Maven POM file, ANT XML file, or Jenkins file), the default file extension (.xml) is used if you did not provide it in the file name.
  • The console output from a test run is now available from the Maven plug in when the Surefire test runs. Test failures are marked as assertion errors to be consistent with the standard Surefire behavior.
  • HCL OneTest API provides synchronization support for CSDL definitions exposed by an OData service. With this support you can use a CSDL definition to automatically create the resources that are required for testing the API that the definition describes. For more information, see Common Schema Definition Language definitions.


  • Proportional and fixed width font sizes can now be specified in the Look and Feel category in the project preferences. For more information, see Changing preferences.
  • It is now possible to temporarily disable previously defined keys in the Recording Studio Wizard. This might affect the default groups to which events are assigned. For more information, see Creating basic stubs.
  • Systemd scripts for Linux systems are now supplied allowing you to automatically start HCL OneTest API Agent, the HTTP/TCP proxy, or HCL Quality Server.For more information, see Starting and stopping HCL Quality Server, Starting and stopping the HTTP/TCP proxy, or Running HCL OneTest API Agent on Unix-like systems.
  • An update to the MySQL results database schema is available to fix a constraint violation exception when you delete results from the Results Gallery. ​ Upgrade the schema to version 'g' by running patch-1_9_24_f-1_9_24_g_mysql.sql.​ There is no change to HCL OneTest API, earlier versions will work with schema version 'g'.

System requirements

For system requirements, see the download document https://support.hcltechsw.com/csm?id=kb_article&sysparm_article=KB0069175.

Installing HCL OneTest API and HCL Quality Server V10.0.1

For information about installation, see:

Installing HCL OneTest Virtualization V10.0.1

For information about installation, see Installing HCL OneTest Virtualization.

Known problems

Table 1. Download documents and technotes
Product Download document Knowledge base
HCL OneTest API https://support.hcltechsw.com/csm?id=kb_article&sysparm_article=KB0069175 HCL support

The knowledge base is continually updated as problems are discovered and resolved. By searching the knowledge base, you can quickly find workarounds or solutions to problems.

Known limitations

The only known limitation is that the Logical View does not display a diagram. Instead, a tree view, similar to that used in the Test Factory and Test Lab is used to support the logical components of the SUT.

Contacting HCL support

HCL Customer Support provides you with technical assistance.

Before you contact HCL support, gather the background information that you will need to describe your problem. When describing a problem to an HCL support specialist, be as specific as possible and include all relevant background information so that the specialist can help you solve the problem efficiently. To save time, know the answers to these questions:
  • What software versions were you running when the problem occurred?
  • Do you have logs, traces, or messages that are related to the problem?
  • Can you reproduce the problem? If so, what steps do you take to reproduce it?
  • Is there a workaround for the problem? If so, be prepared to describe the workaround.