Welcome
Test Execution Specialist Guide
This guide describes tasks that you can perform on schedules, test execution with custom code, and Extending HCL DevOps Test Performance (Test Performance) to support other protocols. This guide is intended for testers or test execution specialists.
Running schedules with performance testing
After you have added the user groups, tests, and other items to a schedule, and you are satisfied that it represents a realistic workload, you run the schedule.
Automating tests from command line
You can run a schedule from the command line. You can also set preferences to export results after the run completes from the command line or from the workbench. Together, these features let you run tests and analyze results without opening the workbench. You can even write scripts to process the exported results.
Stopping the test run from a command line
After you run the test from the command-line interface (CLI), you can stop the test run to use additional parameters in your test run.

Release Notes
This document includes information about the new features introduced, features deprecated or removed, defects fixed, and known issues identified in this version of HCL DevOps Test Performance (Test Performance). You can also find the installation and upgrade instructions along with the contact information of HCL Customer Support.
System Requirements
This document includes information about hardware and software requirements for HCL DevOps Test Performance (Test Performance) 2023.12 (11.0.0).
Getting Started
This guide provides an overview and describes the task flows to get you started with HCL DevOps Test Performance (Test Performance). This guide is intended for new users.
Tutorials
This section contains the tutorials which explains the main features of HCL DevOps Test Performance (Test Performance).
Samples
This section describes about the sample project which can be used with HCL DevOps Test Performance (Test Performance) to test the functionality of an application.
Administrator Guide
This guide describes how to install HCL DevOps Test Performance (Test Performance). After you install the product, you can perform administration tasks such as license configuration and integration with other products. This guide is intended for administrators.
Test Author Guide
This guide describes how to create test scripts in HCL DevOps Test Performance (Test Performance) and enhances tests by applying different test elements such as dataset, variables, and verification points. This guide is intended for testers.
Test Execution Specialist Guide
This guide describes tasks that you can perform on schedules, test execution with custom code, and Extending HCL DevOps Test Performance (Test Performance) to support other protocols. This guide is intended for testers or test execution specialists.
- Running schedules with performance testing
  After you have added the user groups, tests, and other items to a schedule, and you are satisfied that it represents a realistic workload, you run the schedule.
  - Running a local schedule or test
    You can run a test locally or a schedule, in this context, is used to refer to VU Schedule and Rate Schedule on remote locations with a default launch configuration.
  - Running a long run mode SAP GUI test
    When running a SAP GUI test that could last for many hours and could use up the operating system resources, you can choose to run the test with the Long Run Mode process. It is an external process that restarts automatically after the specified number of SAP sessions are over. So, tests of longer duration tests are more likely to finish.
  - Running long duration Citrix tests
    When tests exceed many hours, resource consumption issues can cause problems for the Citrix clients. The long run mode increases the reliability of long duration tests with the Citrix protocol by running the test using multiple processes.
  - Testing with Docker images
    HCL DevOps Test Performance (Test Performance), HCL DevOps Test UI (Test UI), and Test Performance Agent are available for download as Docker images. You can use them to fulfill the continuous testing aspects of your DevOps lifecycle.
  - Adjusting delays in HTTP tests
    You can configure HTTP tests to use client-side processing delays. Client-side processing delays wait for the first character or last character that is received in a response for a previous request in order to better emulate the work done on the client computer. You can also scale the recorded delays in HTTP tests to change the rate at which a test runs.
  - Setting a launch configuration
    Instead of using the default launch configuration, you can specify the file name for the execution results, the name of the folder for the execution results, and, for a test, the number of users.
  - Running a configured schedule
    If you do not use the default launch configuration, you can configure the schedule and then run it.
  - Configuring multiple host names for a location
    You can run several locations on the same computer by configuring multiple host names for a location. This configuration affects all tests running at that location; all tests will run with the configured port.
  - Automating tests from command line
    You can run a schedule from the command line. You can also set preferences to export results after the run completes from the command line or from the workbench. Together, these features let you run tests and analyze results without opening the workbench. You can even write scripts to process the exported results.
    - Creating a command-line config file
      You can create a command-line config file from HCL DevOps Test Performance (Test Performance) which you can use while running tests or schedules from the Command-line interface (CLI) and Maven.
    - Activating secure storage of dataset passwords
      You can store the encrypted dataset passwords in the Eclipse secure storage location, so that when you run the tests from the command line, HCL DevOps Test Performance (Test Performance) automatically uses the password and completes the test run.
    - Configuring to export report counters automatically
      When you run a test or schedule from the Command-line interface (CLI), you can configure HCL DevOps Test Performance (Test Performance) to export reports automatically.
    - Command-line parameters
      You can find the information about parameters that you can use while running tests from the command-line interface (CLI).
    - Running a test or schedule from a command line
      You can run a test or schedule without opening HCL DevOps Test Performance (Test Performance) by using the command-line interface (CLI).
    - Running multiple tests from the command line
      When you want to run multiple tests, schedules or compound tests that are in a project folder, you can select and run those tests by using any of the command options such as "*" or testType from the command line.
    - Stopping the test run from a command line
      After you run the test from the command-line interface (CLI), you can stop the test run to use additional parameters in your test run.
  - Controlling caches size
    If you use an infinite loop and the number of cached responses in a test increases exponentially, you can set a limit to cache for a user group in the schedule.
  - Increasing memory allocation
    The virtual users that access your web server require memory to prepare requests, send requests, and receive responses. Because the amount of memory is not automatically set on remote computers, you might receive an out-of-memory error. To correct this situation, increase the memory allocation for that computer.
  - Controlling execution of web analytic reports
    When a schedule is in the running state, you can perform the following actions from the web analytics reports to cater to your need.
  - Debugging HTTP tests
    If a test does not behave as expected during playback, you can use the protocol data and test log to assist in debugging the test.
  - Debugging Citrix tests
    The Citrix dashboard is an optional panel that displays detailed information and control commands for each virtual user during the run of a schedule. This is useful for debugging your tests and allows you to pause, interact, resume, or stop the execution of individual virtual user sessions.
- Extending test execution with custom code
  You can extend how you run your tests by writing custom Java™ code and calling the code from the test. You can also specify that results from the tests that are affected by your custom code be included in reports.
- Extending DevOps Test Performance to support other protocols
  The HCL DevOps Test Performance (Test Performance) Extensibility Software Development Kit (SDK) enables you to create extensions to support testing new protocols without modifying the core product code. You can create an extension that provides functionality for testing other protocols in addition to the HTTP protocol support that is standard in Test Performance.
Test Manager Guide
This guide describes how to keep track of the performance of the application by evaluating the test results. This guide is intended for test managers.
Troubleshooting Guide
This guide describes how to analyze and resolve some of the common problems that you might encounter while you work with HCL DevOps Test Performance (Test Performance).
Reference Guide
This guide describes, additional topics to gain more knowledge about HCL DevOps Test Performance (Test Performance).
All Guides (PDFs)
You can find the link to view or download the content of the release notes, system requirements, and persona guides of HCL DevOps Test Performance (Test Performance) as a PDF file.
Security Considerations
You can take certain actions to ensure that your installation is secure, customize your security settings, and set up user access controls.
Notices
This document provides information about copyright, trademarks, terms and conditions for the product documentation.

Stopping the test run from a command line

After you run the test from the command-line interface (CLI), you can stop the test run to use additional parameters in your test run.

Before you begin

You must have initiated a test run from CLI. See Running a test or schedule from a command line.

Procedure

Open the command prompt.

Run the following command to change the directory to the cmdline directory:

cd <cmdline_directory_path>

For example,

cd C:\Program Files\HCL\DevOpsTest\cmdline

Based on the operating system that you used to install Test Performance, you can locate the cmdline directory as follows:

Operating system	The default path to the directory
Windows®	C:\Program Files\HCL\DevOpsTest\cmdline
Linux™	/opt/HCL/DevOpsTest/cmdline
Mac	/Application/HCL/DevOpsTest/cmdline

Run the following command to stop the test run after a while:
```
cmdline -workspace workspace_full_path -stoprun
```
For example,
```
cmdline -workspace "C:/Users/HCL/devopstest/workspace" -stoprun 
```
The test run stops after a few seconds of execution of the command and the status is displayed on CLI. The test log is generated and you can view it from Test Performance.
Note: If you have used the -exportlog parameter when running the test, the test logs are stored in the specified location and also in Test Performance.
Run the following command to stop the test run immediately:
```
cmdline -workspace workspace_full_path -abandonrun
```
For example,
```
cmdline -workspace "C:/Users/HCL/devopstest/workspace" -abandonrun
```
The test run stops immediately and the status is displayed on CLI. However, the test log is not generated.

Results

You have stopped the test run from CLI.