Schedule and Distribute Test Automation in qTest Launch 1.5.1

As of qTest Launch 1.5.1, Elite users are able to schedule and distribute test execution jobs for Test Runs, Requirements, and Test Cases across multiple automation host machines in qTest Launch.

  • Non-Tosca test cases or test runs will be distributed across the selected Agents, and will run in sequential order in every Host.

  • Tosca test cases or test runs will be executed by Tosca DEX agent in qTest Launch.

The Non-Tosca and Tosca test cases/test runs can be selected to run within the same schedule.

This article is for qTest Launch 1.5.1 and later; these versions are only compatible with qTest Manager 9.7+. If you are using qTest Launch 1.4.1 that is compatible with qTest 9.6.x, refer to this article.

Schedule Test Execution in Launch

To schedule your test execution in Launch, follow the steps below:

  1. In Launch, select Schedule Tests. The "Schedule Test Runs: Select Cases" dialog displays.

  2. Enter the name of the newly scheduled job in the Schedule Name field.

  3. Select your qTest Manager Project.

  4. Select folder location for the Test Results
    • Select the down arrow icon in Test Result Folder to display Releases and/or Test Cycles in a tree structure for the currently selected project
    • Select a Release/Cycle and CONFIRM LOCATION to save.

      Note: You can only select a destination for test results if the selected object type is either Requirements or Test Cases. In other words, if you selected Test Runs as the object type, the results are submitted to the selected Test Runs, so no location needs to be set up for the test results

  5. Filter objects to schedule tests by project and project type:
    • Requirements

    • Test Cases

    • Test Runs

  6. Once the object filter is chosen, you can search for object(s) by name. Objects that match the filter or the search criteria are shown in the left panel under the tree structure.

  7. Move the object to the right panel which displays the objects that are being scheduled to run.
    • To move individual items, select the blue plus sign icon.

    • To move multiple objects, 'ctrl+click' and select the name of the objects and then the Add to Test Run icon.

    • RETAIN MODULE STRUCTURE: when this option is selected, the result will be submitted to the Test Results Folder under the same structure as the selected modules

  8. Select NEXT. The Select Hosts and Agents screen displays.

  9. Select hosts and agents that will execute your test.
      • Only Online hosts are available for test scheduling

      • The test cases or test runs you selected in previous Select Cases screen will be distributed across the selected hosts using the ratio: # of selected test cases (or test runs) / # of selected hosts

  10. Choose the appropriate execution schedule type:
    • RUN NOW: for immediate execution. By selecting this option you will be moved to step 11

    • SET SCHEDULE: to schedule for the future
      • In the Schedule Test Run: Set Schedule modal, choose the Select Date on the calendar to schedule the start date. Today's date will be the default.

      • Select Time to begin running the schedule.

      • If you want the schedule to repeat, select the Repeat checkbox, and choose the repeat cadence from the drop-downs.
        • Note: the hourly repeat option is only available if you're scheduling for automation host 2.2 or later
      • Select the appropriate End time radio buttons.

      • The number of test cases scheduled to run will display, along with the Host and Agent information.

      • Select RUN NOW for immediate execution of your schedule, or CONFIRM to begin your schedule on the selected date/time you chose earlier.

  11. By selecting RUN NOW on either Select Hosts and Agents or Schedule Test Run screen, or by selecting CONFIRM on Schedule Test Run screen, you will be presented with the Test Runs Summary screen. This screen shows the detail information of the schedule job. This screen also indicates that the job has been successfully created. Select DONE to finish your job scheduling.

You will be back to the Home page. From there, select the JOBS view option to view the newly created scheduled job. If you follow this example, you'll see the new schedule has created 2 jobs that are distributed between 2 hosts.

At any point in time, you can select the Job schedule to view its details.

Maintenance Hints:

  • You cannot edit a scheduled job. You would need to cancel the currently scheduled job and create a new one.

  • If you do not want a scheduled job to run anymore, simply cancel it.