Running a QuerySurge™ Test Suite

Versions: 8.0+

IN THIS SECTION

• Test Suites
• Scheduling a One-time Scenario Execution
• Triggering a Quick Run

Test Suites

---

All of your Test Suites can be accessed via the list view on the Test Suites tab of the Scheduling view. From here, you can create, copy, delete, and search for Test Suites. Most importantly, though, you can run Scenarios comprised of Test Suites.

Once you have decided which Test Suites you want to use, right-click on one of the selected Test Suites to see your options: Run Now, Copy Test Suite, and Delete. If you have selected a single Test Suite, all options will be enabled. If you have selected two or more Test Suites, the Edit Test Suite and Copy Test Suite options will be disabled.

 TOP OF PAGE

Scheduling a One-time Scenario Execution

---

To run one or more Test Suites together, you can create a one-time Scenario execution. Scenarios can be executed right away, or scheduled to execute at a future date and time of your choosing. Please note that while one-time Scenario executions can be scheduled to run at a future date and time, they are qualitatively different than Recurring Schedules.

1. In the Test Suite list, click on the button to open the Scheduling wizard.
   
   Alternatively, you can click the down-arrow on the right side of the button and select One-time Execution. This bypasses the Schedule Type selection card shown above.
   
2. Select the One-time radio button and click the Next button to advance to the next card.
   
3. Enter a Scenario Name.
4. Use the and buttons to add and remove Test Suites from the Scenario.
5. Optionally, select a date and time from the Set All Dates to menus.
6. Optionally, select an Agent from the Set All Agents as menu.
7. Optionally, select or add Asset Tags to the Scenario.
   
8. Click the Save button.

Scenario Settings

1. Set All Dates to specifies the date and time each Test Suite in the Scenario will begin executing.
2. Set All Agents as specifies the Agent that will execute each Test Suite in the Scenario.
3. Asset Tags allow you to tag a Scenario with one or more values. You can select an existing tag, or create a new one. You may also check the Include Inherited Suite Tags box to include tags that might already be associated with any of the added Test Suites.

Adding Test Suites

1. Use the button to add a Test Suite to the Scenario.
2. Use the dropdown menu in the Test Suite column to to select from a list of available Test Suites.

Individual Test Suite Settings

1. Agent specifies the Agent that will execute the Test Suite. You have the option to select a different Agent for each Test Suite in a Scenario.
2. Scheduled Date & Time of Run specifies the date and time the Test Suite will begin executing. You have the option to select a different date and time to start each Test Suite in a Scenario.

Removing Test Suites

1. Select one or more Test Suites to remove.
2. Use the  button to remove the selected Test Suite(s).

NOTE: Each Test Suite you add to your Scenario will be assigned to Any Agent and will run Now. These are the default settings unless you choose a specific Agent or Schedule Date & Time of Run. As discussed, these settings can be configured at the Scenario or individual Test Suite level. This is where you can configure any elaborate scheduling of your test executions. To view your execution once it begins running, navigate to the Run Dashboard.

NOTE: Any Agents you assign to a Scenario or an individual Test Suite must be online and available before your executing can proceed.

 TOP OF PAGE

Triggering a Quick Run

---

If you wish to bypass the Scenario configuration, you can trigger a quick run of a Test Suite (or more than one Test Suite). The Scenario creation will occur automatically, and will execute immediately using the first available Agent.

1. Highlight one or more Test Suites for execution.
2. Right-click one of the selected Test Suites and select Run Now.
   
3. Optionally, edit the generated Scenario name.
4. Optionally, select or add Asset Tags to the Scenario.
   
5. Click the OK button.

This will automatically redirect you to the Run Dashboard, where your Scenario will have been created and will be executing.

NOTE: At least one Agent must be online and available for your executing to proceed.

 TOP OF PAGE