Controlled update

In a controlled update rollout, you choose specific Agents on which to install an update. This enables you to test the update on a subset of Agents before installing it on all of the remaining Agents. The process for choosing Agents includes defining criteria, such as the type of Agent or a specific Agent Group, that when met determines whether the update is installed. Agents that do not match the specified criteria do not have the update installed.


AppMon 2018 October

For AppMon 2018 October and later, use the Enforce Agent version feature instead.

Controlled update process overview

The following diagram shows the necessary steps for performing a controlled update rollout.


Download the update from the AppMon product download site. You can also download updates using the Community Portal link on the Updates pane. Extract the contents to local temp folder on the Client machine.

In the AppMon Client click Tools > Manage Updates. The Dynatrace Server Settings dialog box appears and displays the Updates pane.

The AppMon Client must be connected to an AppMon Server to enable the Manage Updates menu command. For the standalone Client, you must first select the AppMon Server on which the update should be installed. For the Webstart Client, the Server from which you started the Webstart Client is the only Server available.

Click Select File and navigate to the update*.dtf you want to install. Select the file and click Open to add the update file to the Server. Click Next.

You can also open Windows file explorer separately to navigate to and double-click the desired update*.dtf file to open the wizard with the file already selected.

The Wizard prompts you to verify installing the update. Click OK. The wizard uploads the file for installation and shows the upload progress.

An error message displays if the update is currently is use. If this happens, you must deactivate and re-install the update. See Online license activation and deactivation for more information.

Click Next when the upload completes. The Configure Rollout Action page appears.

Select Controlled Install and select the update version from the list if enabled, if not already selected. Click Next. The Configure Agent Rollout page appears.

On the Configure Agent Rollout page, choose one of the following options:

  • Agent Group: Control the Agent rollout by Agent Group and System Profile. Only bootstrap Agents that match the selected System Profile or Agent Group are updated. If you select an entire System Profile node, all Agents that match this System Profile are updated.
  • Host: Control the Agent rollout by Host and Agent name. Only Agents that are running selected hosts and have one of the selected Agent names are updated. If you select an entire host node, all Agents that run on the host are updated.

Additionally, you can refine both rollout options by adding specific technologies to the rollout configuration criteria. For example, if you select a whole System Profile node, but only the technology Java, then only Agents that match the System Profile and are Java Agents are updated.

Click Next. On the Selected Agent Rollout Overview page, verify that all Agents that you want to update are shown.

Click Next to complete the remaining steps of the wizard.

Configure controlled update rollouts

Perform the following steps to change the configuration of an existing controlled update rollout.

Access the Updates tab of the Dynatrace Server settings.

On the Management tab, select the version you want to change and click Manage.

On the Configure Rollout Action page, select Controlled Install and click Next.

On the Configure Agent Rollout page, you can change the configuration for selecting Agents on which to install the update.

Apply the update changes. The new rollout configuration deploys to the AppMon Collector(s).

Restart the affected Agent tiers and complete the steps of the wizard.


Restarting the AppMon Server, Collector or Client is not needed when changing the rollout configuration.

Post-installation considerations for a controlled update rollout

After successfully completing a controlled update rollout, deployed Agents can be at different versions. As a result, installing a newer update is not allowed until you perform a complete install and update Agents to the same update version. You can also roll back the installed update before installing a newer update to achieve the same Agent version consistency.

The diagram below shows the available options for installing update to replace Update that was installed using the controlled update rollout option.

See Troubleshooting product updates for information on resolving controlled rollout issues.