Applies to Ready! API 2.0, last modified on May 16, 2017

In this tutorial, we modify a test created using the Creating Your First Load Test tutorial to run it on cloud agents instead of a local computer. We will use the public Amazon machine image provided by SmartBear. For instructions on creating a custom image, see Creating Custom Amazon Machine Images.

Requirements

To run LoadUI distributed cloud tests, you need to meet the following requirements:

  • The LoadUI NG Pro license must be active. Feel free to request a trial on our web site.

  • You need a cloud service profile. Currently, only Amazon is supported.

  • Open the port used for the connection on the local computer. By default, the agent uses port 1991 to communicate with LoadUI NG. If you use a proxy or firewall, allow network connections using these ports.

  • Make sure that you have network access to the cloud that will simulate the test.

Adding and Configuring Cloud Agents

  1. In the load test editor, switch to the Distribution page.

    API distributed cloud testing with Ready! API: The Distribution Page

    Click the image to enlarge it.

  2. Add a Cloud Agent. Click on the toolbar.

    API distributed cloud testing with Ready! API: The Add Cloud Agent Button
    • In the Add Cloud Agent dialog, make sure that the Amazon cloud provider is selected, and click .

      The Add Cloud Dialog
    • In the Add Amazon Cloud Credentials dialog, specify the profile name, your access key, and secret access key. Click OK in both dialogs.

      The Add Amazon Cloud Credentials Dialog
    • Select the created Cloud Agent. The Cloud Agent Controller editor will appear.

      API distributed cloud testing with Ready! API: The Cloud Agent Controller Editor

      Click the image to enlarge it.

    • Specify the Region and Zone of the cloud instance you want to use.

      Select SmartBear LoadUI NG Agent or your custom image as the Image. Ready! API will launch the specified count of cloud instances from the provided image that LoadUI NG can interact with.

      The Cloud Location Property
    • Input the number of agents and the type of the instance these agents will be run on. In this example, we use 10 agents run on the m3.medium instance. The type of the instance you need depends on how many virtual users you plan to simulate and how complex your underlying SoapUI NG test is.

      The Cloud Capacity Property
    • Now, drag the scenarios into the agents. If you add multiple scenarios, LoadUI NG will simulate all of them simultaneously.

      API distributed cloud testing with Ready! API: Created Cloud Test

      Click the image to enlarge it.

Switching to the Distributed Mode

By default, LoadUI NG does not run tests on agents. You need to switch it to the Distributed Mode before running your load test. To do this, use the drop-down list next to the play button and select Run scenarios on agents. After this, the load test will run on cloud agents.

API distributed cloud testing with Ready! API: Run Scenarios on Agents

Running the Test

To start the load test, click . LoadUI NG will first display the Price Check dialog. This dialog displays the price of your test. Click OK. LoadUI NG will start the required cloud instances and run the tests on them.

Checking Test Results

Switch to the Statistics page. On this page, add a new statistics group. When selecting statistics to display, you can choose them from the cloud agent you need. To display the statistics for the cloud agent, choose the agent name. To display overall test statistics, choose The sum of values for all agents. For more information about checking test results, see Statistics Page.

For details about load test results, see Viewing Test Results.

See Also

Test Assertions
Load Test Agents
Test Results