HCL OneTest API, HCL OneTest Virtualization release notes for Version 9.2.1 and

Read about new features, system requirements, installation, known issues, and known limitations for HCL OneTest™ API, HCL OneTest Virtualization, version 9.2.1 and


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.

New features and enhancements

What's new in Version

  • HCL OneTest API provides synchronization support for RAML definitions. With this support you can use a RAML definition to automatically create the resources that are required for testing the API that the definition describes. See RAML definitions.
  • Support was added for RabbitMQ (AMQP 0.9.1). Support includes the RabbitMQ transport, broker, and queue proxy recording. HCL OneTest API can test, record, and virtualize messages sent over RabbitMQ, including RabbitMQ secured by SSL. See Testing with RabbitMQ.
  • The HTTP/TCP proxy now allows for custom certificate creation. Custom code can be written to provide signed certificates for HTTPS endpoints that are being proxied. See Programmatic custom certificate creation in proxy.
  • 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.

What's new in Version 9.2.1


  • In releases before 9.2.0, subscribing to a file by using a File transport would consume the file on each subscribe even if the file was not modified. The updated File transport in 9.2.0 only consumed the file if it changed. A new option was added to the File transport to enable files to be consumed within a subscribe action even if they were not modified. The default setting for projects created before 9.2.0 is to ignore the last modified time. File transports modified or created by using HCL OneTest API 9.2.0+ defaults to only consuming if the file was modified. The setting can be changed on the File transport configuration UI. If the setting is enabled, the file system is queried without waiting for the next scheduled poll. See File transport.
  • File transport based stubs can now be published to a Dockerfile and build context. See Supported transports to publish stubs to a Dockerfile and build context.
  • A new physical resource type named "File Access" was introduced. A File transport can be bound to a File Access resource to allow access to remote files by using FTP or SFTP. See Adding a file access to the Physical view.

HCL Quality Server

  • Resource Monitoring is now available in HCL Quality Server to view the status of system resources as part of a performance test. See Navigating the user interface.
  • Stubs started from the HCL Quality Server, either through the Environments page, REST interfaces or command line tools, are now automatically restarted if the original instance is no longer reported as working. See Starting stubs: HCL Quality Server method.
  • Quality Server now trusts the hosted license server without needing you to add its certificate into the truststore. See Setting up licensing.
  • The HCL Quality Server Environments page was replaced by the Environments dashboard. This dashboard is for testers to view stub details, filter stubs, and start and stop stubs that are scoped to a domain and environment. Testers can also create and manage scenarios from the Environments dashboard. The HCL Quality Server Agents page was replaced by the Infrastructure dashboard and the Networks dashboard. The Infrastructure dashboard is for administrators to view and monitor the agent, engine, and proxy applications that are running. The Networks dashboard was added to show all the rules from all the domains and environments. See Navigating the user interface.
  • When HCL OneTest API agents are asked to perform test execution through an engine, these engines are held 'open' for a period of time after completion of the task so that they can be reused for other assets within the same project.
  • The Stub Hit Counter is now present as part of the overall statistics of a virtual service and shows the number of messages that are received since it was started. This value cannot be reset.
  • The existing XML-based REST APIs available under RTCP_BASE_URL/rest/ are deprecated; consequently, alternative and new ones are accessible from RTCP_BASE_URL/api/. See REST services.
  • In 9.2.1, the HCL Quality Server Environments page and the Agents page were replaced by dashboards. Those dashboards model stubs and scenarios differently and use new REST APIs, so existing test automation scripts that use the REST APIs before 9.2.1 will operate differently. Review the list of enhancements and download documents in the release notes for information about other differences in HCL Quality Server in 9.2.1.
  • 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.

System requirements

For system requirements, see the PDF documents on the HCL License & Delivery Portal.

Installing HCL OneTest API and HCL Quality Server 9.2.1

Installing HCL OneTest Virtualization 9.2.1

For information about installation, see Installing HCL OneTest Virtualization.

Known problems

Known problems are documented. See Known Issues.

Known limitations

The known limitations are listed.
  • 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 Products and Platforms Support provides you with technical assistance.