Running HCL OneTest API tests

You can use HCL OneTest™ Performance Extension for HCL OneTest API to run HCL OneTest API tests.

You can install both the products on the same machine, establish the connection, and run HCL OneTest API tests. See Testing with HCL OneTest API.

You also have the option to just import the projects to HCL OneTest Performance, add the tests to a schedule or compound test to run them. You can either use HCL OneTest Performance Agent or HCL OneTest API Agent to generate the load. You need a compound test or schedule that contains the HCL OneTest API tests.

Setting environment variable

To run the tests with HCL OneTest API Agent, set the environment variable INTEGRATION_TESTER_AGENT_HOME and point it to the HCL OneTest API Agent installation directory.
Set the environment variable for each agent
On Linux, set:
INTEGRATION_TESTER_AGENT_HOME=/opt/HCL/RIT-Agent
export INTEGRATION_TESTER_AGENT_HOME
echo $INTEGRATION_TESTER_AGENT_HOME

If the variable is not set, you will get a test log with error message when the compound or schedule test is run.

Error message when the environment variable is not set

Running the compound test or schedule

  • Click Run Compound Test or Run VU Schedule or Run Rate Schedule.

    After the run completes, the HCL OneTest API report displays statistics on the executed sequences and Timed Sections if some are defined in the tests.

HOT_API Performance Report

The report contains the following pages.

OVERALL
The Overall page provides this information:
  • A progress indicator that shows the state of the run.
  • On the left, a bar chart that shows the overall percentage of passed sequences, for the entire run. A sequence corresponds to a test run.
  • On the right, a bar chart that shows the overall percentage of passed timed sections, which are corresponding to individual sections within the steps of the tests.
Overall page of the report
SUMMARY
This page displays information about the run:
  • The number of users that are active and the number of users that have completed testing. This number is updated during the run.
  • The elapsed time (run duration)
  • The status of the run.
  • The Performance Requirements: validates the performance requirements that you set in a schedule.
The summary page also summarizes the data about the sequence run and timed sections: Total number of sequences that were started and the total number that have been completed, or failed, with a minimum and maximum rate.
Summary page of the report
SEQUENCE THROUGHPUT SUMMARY
This page shows a bar chart of average throughput in seconds for each sequence.
It provides times section throughput for each sequence. You can use the filters to have displayed results for one sequence only.
And if you add filters, you can see the timed sections throughput for each sequence.
Sequence throughput summary page of the report
SEQUENCE THROUGHPUT
This page shows the average throughput for all combined sequences during the last recorded interval over the time period. Click on one of the Total rate boxed to have one graph displayed at a time or click Select All to see all rates on the same graph.
The User Load graph shows active users compared to users that have completed testing. The table after the graph lists the number of active users, the number of users that have completed testing, and the total user count for the entire run.
Sequence throughput page of the report
SEQUENCE PERFORMANCE
The chart displays the response time of the sequences as the test progresses. You can apply a filter to see the timed sections of all sequences or the timed sections of a particular sequence.
The table under the chart shows the average duration for each section of a sequence, the standard deviation of the average response time, the passed rate.
Sequence performance page of the report
Feedback