Running a test or schedule from a command line

You can run a test or schedule without opening HCL OneTest Performance by using the command-line interface (CLI).

Before you begin

About this task

The command-line syntax with the supported parameters is as follows:

cmdline -workspace <workspace_full_path> -project <proj_name or proj_relative_path> -eclipsehome <eclipse_full_path> -plugins <plugin_full_path> -schedule <sched_name or sched_rel_path> -suite <suite_name or suite_relative_path> -importzip <full_path_to_zip_file> -varfile <variable_file_full_path> -configfile <file_full_path> -results <result_file> -overwrite <"true" | "false"> -quiet -users <number_of_users> -vmargs <JVM_args> -rate <RateRunnerGroupName=iterationNumber1/duration, iterationNumber2/duration> -duration <Stage1=durationOfStage; Stage2=durationOfStage> -execsummaryreport <id_of_report> -stdout -publish <serverURL>#project.name=<projectName>&teamspace.name=<name_of_the _teamspace> -publish_for <ALL,PASS,FAIL,ERROR, INCONCLUSIVE> -labels <labelname1, labelname2> -exportlog <log_full_path> -exportstats <local_dir_path> -exportstatshtml <local_dir_path> -exportstatsformat <name of the file format> -compare <"result_path1, result_path2"> -exportstatreportlist <stats_list> -usercomments <"any user comment"> -publishreports <"STATS, TESTLOG"> -swapdatsets <existing_dataset_file_path:new_dataset_file-path> -timerange <"all, 5 Users, 10 Users"> -history <jaeger,testlog,null> -overridermlabels <"rmlabelname1,rmlabelname2"> -ignoreunhealthytranscations <"true" | "false"> -execsummary <path_to_local_dir>

Procedure

  1. Open the command prompt.
  2. Run the following command to change the directory to the cmdline directory:
    cd <cmdline_directory_path>
    For example,
    cd C:\Program Files\HCL\hclonetest\cmdline

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

    Operating system The default path to the directory
    Windows® C:\Program Files\HCL\hclonetest\cmdline
    Linux /opt/HCL/hclonetest/cmdline
    Mac /Application/HCL/hclonetest/cmdline
  3. Run the following command to run the test:
    cmdline -workspace workspace_full_path -project proj_rel_path -suite suite_name or suite_rel_path
    For example,
    cmdline -workspace "C:/Users/HCL/hclonetest/workspace" -project "/myproj/proj123" -suite "test1.testsuite"
    OR
    cmdline -workspace "C:/Users/HCL/hclonetest/workspace" -project "/myproj/proj123" -suite "Tests/test1.testsuite"
    Note: You can add an additional parameter to the preceding command according to your testing requirements and then run the test.
    The test run starts and the status is displayed on CLI.

Results

You have run the test from CLI.

What to do next

You can analyze the test results from HCL OneTest Performance. See Evaluating results in web analytic reports.

If you have published test results to HCL OneTest Server, then refer to the HCL OneTest Server documentation.