Update the solution - Distributed Load Testing on AWS
Troubleshooting updates from versions prior to v3.3.0Updating regional stacksAWS Systems Manager Application Manager

Update the solution

Updating the solution applies the latest features, security patches, and bug fixes to your deployment. If you have previously deployed the solution, follow this procedure to update the CloudFormation stack to the latest version.

Important

Before updating, ensure no load tests are currently running. The update process may temporarily disrupt the solution’s availability.

  1. Sign in to the CloudFormation console, select your existing CloudFormation stack, and select Update stack.

  2. Select Make a direct update.

  3. Select Replace existing template.

  4. Under Specify template:

    1. Select Amazon S3 URL.

    2. Copy the link of the latest template.

    3. Paste the link in the Amazon S3 URL box.

    4. Verify that the correct template URL shows in the Amazon S3 URL text box.

    5. Choose Next.

    6. Choose Next again.

  5. Under Parameters, review the parameters for the template and modify them as necessary. Refer to Launch the stack for details about the parameters.

  6. Choose Next.

  7. On the Configure stack options page, choose Next.

  8. On the Review page, review and confirm the settings.

  9. Select the box acknowledging that the template might create IAM resources.

  10. Choose View change set and verify the changes.

  11. Choose Update stack to deploy the stack.

You can view the status of the stack in the AWS CloudFormation console in the Status column. You should receive a UPDATE_COMPLETE status in approximately 15 minutes.

Note

If you experience Amazon Cognito authentication issues while logging in from your browser after stack upgrade, please refresh your browser (Ctrl+Shift+R on Windows/Linux or Cmd+Shift+R on Mac) to clear cached data and try again.

Troubleshooting updates from versions prior to v3.3.0

Note

This section applies only to updates from versions prior to v3.3.0. If you are updating from v3.3.0 or later, follow the standard update procedure above.

  1. Download the distributed-load-testing-on-aws.template.

  2. Open the template and navigate to Conditions: and look for DLTCommonResourcesAppRegistryCondition

  3. You should see something similar to the following:

    Conditions:
DLTCommonResourcesAppRegistryConditionCCEF54F8:
Fn::Equals:
- "true"
- "true"

  4. Change the second true value to false:

    Conditions:
DLTCommonResourcesAppRegistryConditionCCEF54F8:
Fn::Equals:
- "true"
- "false"

  5. Use the customized template to update your stack.

  6. This update removes app registry-related resources from the stack, allowing the update to complete successfully.

  7. Perform another stack update using the latest template URL to add back the app registry application resources to your stack.

Updating regional stacks

If you have deployed the solution in multiple Regions, you must update each regional stack separately. Follow the standard update procedure for each regional CloudFormation stack in the Regions where you have deployed testing infrastructure.

AWS Systems Manager Application Manager

After updating the solution, AWS Systems Manager Application Manager provides an application-level view into the solution and its resources. You can use Application Manager to:

  • Monitor resources, costs for deployed resources across stacks and AWS accounts, and logs from a central location.

  • View operations data for the solution’s resources in the context of an application, such as deployment status, CloudWatch alarms, resource configurations, and operational issues.