Working in non-GUI mode

You can use the tools and executable files that are provided along with the product software. You can use these tools to perform different test actions in a non-GUI mode.

You can find the following information:

Tools and executable files

HCL DevOps Test Integrations and APIs (Test Integrations and APIs) and HCL DevOps Test Integrations and APIs Agent (Test Integrations and APIs Agent) provide tools and executable files that you can use. These are located in the installation folders where you install Test Integrations and APIs and Test Integrations and APIs Agent.

The following table describes the tools and executable files that you can use in Test Integrations and APIs:
Applications in Test Integrations and APIs installation folder Description
IntegrationTester Executable file that starts Test Integrations and APIs on your computer.
IntegrationTesterCmd Tool with which you can run various command line tasks.
LibConfig Executable file that starts Library Manager of Test Integrations and APIs on your computer.
RunTests Tool with which you can run tests by using the command line interface.
EncryptPassword Tool with which you can encrypt passwords for use in configuration files.
RQMAgent Executable file that starts a server for running tests from Engineering Test Management or Engineering Test Management.
The following table describes the tools and executable files that you can use in Test Integrations and APIs Agent:
Applications in Test Integrations and APIs installation folder Description
Agent Executable file that starts Test Integrations and APIs Agent on your computer.
LibConfig Executable file that starts Library Manager of Test Integrations and APIs Agent on your computer.
EncryptPassword Tool with which you can encrypt passwords for use in configuration files.
RunTests Tool with which you can run tests by using the command line interface.

Applications for internal use

The following tools that are found in the installation folders of Test Integrations and APIs and Test Integrations and APIs Agent are for internal use by the applications and you cannot use these tools.

Tools in Test Integrations and APIs for internal use:
  • Eclipse
Tools in Test Integrations and APIs Agent for internal use:
  • Eclipse
  • Probe
  • TestEngine

Availability of the various interfaces

Command line
Both the RunTests and IntegrationTesterCmd commands are supplied with Test Integrations and APIs. For more information on the commands, see Command-line interfaces.
Ant
Support for the environment, scenario and stub Ant tasks is supplied with HCL DevOps Test Virtualization Control Panel (Test Virtualization Control Panel). Support for the IntegrationTester Ant task is supplied only with Test Integrations and APIs. For more information on the Ant tasks, see Ant tasks.
REST
The REST interfaces described here are only a set of specifications, so no client is provided. However REST calls must be made to an instance of Test Virtualization Control Panel. For more information on the REST services, see REST services.

Usage of the various interfaces

Note: When Ant tasks and Test Integrations and APIs commands communicate with the server over HTTPS any certificate that is presented by Test Virtualization Control Panel is trusted.
Examples of processes that might run REST API commands include:
  • Automated build processes
  • Reporting tools
  • Plug-ins for other tools
  • Custom software programs

Many different programs can run REST commands. To run the command, you send an HTTP request to a REST resource and pass HTTP query parameters or a request body. The request body is typically in XML format, although a few resources use JSON.

Alternatively, build processes that already use the Apache Ant client can use the Ant API. When calling from other scripts, or executing commands manually, you can call the API directly from the command line, as in the following example:
IntegrationTesterCmd --serverUrl "https://localhost:5443/RTCP/" --domain myDomain --environment localhost --name "My stub" start-stub

You can also call an Ant task from the command line.

Using the command line requires an installation of Test Integrations and APIs, and using Ant requires the Test Virtualization Control Panel Ant tasks archive file, as well as an installation of Ant. Stand-alone programs written in languages like Java and C# can call REST methods directly.

The following table provides an overview of the actions that can be also be completed by using a non-GUI interface.
Table 1. Available actions and their associated interfaces
Actions Command line Ant tasks REST services, grouped by resource type
Managing authentication for REST services See REST services.
Running tests RunTests IntegrationTester
Managing test results IntegrationTesterCmd command
Managing domains See all the REST services at /RTCP/api/swagger-ui.html
Managing environments IntegrationTesterCmd command See all the REST services at /RTCP/api/swagger-ui.html
Managing scenarios IntegrationTesterCmd command See all the REST services at /RTCP/api/swagger-ui.html
Managing stubs IntegrationTesterCmd command See all the REST services at /RTCP/api/swagger-ui.html

Domain level security

Note: By default, domain-level security is not enabled.
If domain-level security is enabled, a security token must be specified. For information about how to create a security token, see Creating and assigning security tokens.