SaaS Upgrade Assistant

Latest Dynatrace

The SaaS Upgrade Assistant is a Dynatrace app that imports your Dynatrace Managed environment configuration. It enables Dynatrace Managed cluster administrators to navigate through a frictionless upgrade from their Dynatrace Managed on-premises deployment to the SaaS deployment model. A cluster administrator can import the configuration to the target SaaS environment and update it to align with SaaS environment requirements. The app ensures a faster migration and minimizes disruption to Dynatrace users by incorrect environment configuration. Automation eliminates time-consuming manual tasks, such as updating dashboard ownership or adjusting entity IDs that have changed between environments.

What can the SaaS Upgrade Assistant do?

Currently, with SaaS Upgrade Assistant you can:

  • Easily import configuration with a single click
  • Track configuration migration progress
  • Browse imported configurations and review failed configurations marked in red
  • Troubleshoot failed and skipped configurations with ease thanks to error messages
  • Fix a single configuration with an edit form or use bulk mode to update 100s of configurations at a time. You can leverage preview changes to make sure the update is correct.

How to export the configuration from Dynatrace Managed?

  1. Sign in to the Dynatrace Managed Cluster Management Console.
  2. Navigate to Environments page.
  3. Select an environment that you want to migrate from.
  4. Select the Export Configuration button.
  5. Confirm the operation and navigate to your target local directory to store the archive.

How to install, update, or uninstall SaaS Upgrade Assistant?

To install, update, or uninstall the SaaS Upgrade Assistant, in Dynatrace Hub, select SaaS Upgrade Assistant. Then select either Install, Update, or Uninstall to perform this action in your environment.

When you uninstall the SaaS Upgrade Assistant:

  • The upgrade status and any uploaded configurations are deleted.
  • Configurations that have already been deployed by the SaaS Upgrade Assistant will persist.

What versions is the SaaS Upgrade Assistant compatible with?

We recommend working on a configuration exported from the same major version of the Dynatrace Managed cluster and SaaS environment to avoid unnecessary false-positive failed configuration migrations. For example, your Dynatrace Managed cluster should be in version 1.284.123, and your SaaS environment should be in 1.284.89.