How do I update Dynatrace?

We've built an auto-update mechanism into Dynatrace OneAgent so you don't have to worry about manually updating the agents that are running in your environment. You will always remain on the latest, most secure and most advanced version of Dynatrace OneAgent without having to worry about manually installing anything.

Automatic updates are turned off by default. You can enable auto-updates either globally for all Dynatrace OneAgent installations or for individual hosts only. With this later option, we won't notify you when instances of Dynatrace OneAgent are outdated. With automatic updates enabled, each time a new version is released, Dynatrace OneAgent automatically downloads all necessary binaries and libraries and installs them for you. No manual configuration is required.

Following Dynatrace OneAgent auto-updates, you must restart all server processes for continued deep-process monitoring.

Following updates, some components of Dynatrace OneAgent keep running in processes that are monitored by Dynatrace (for example, Java, .NET, Apache, and IIS). These processes will continue to be monitored with the previous version of Dynatrace OneAgent until they are restarted. Following restart, these processes will be monitored with the latest version of Dynatrace OneAgent.

Global auto-update across all hosts

To enable Dynatrace OneAgent automatic updates for all your hosts:

  1. Go to Settings > Preferences > Updates.
  2. Switch on Automatically update OneAgent instances.

Going forward, whenever a new version of Dynatrace OneAgent becomes available, all your installed instances of Dynatrace OneAgent will automatically download the update and upgrade their binaries and configuration files.

Installation of a specific version of Dynatrace OneAgent on all new hosts

To control which version of Dynatrace OneAgent is automatically installed on all new hosts:

  1. Go to Settings > Preferences > OneAgent updates.
  2. Disable automatic OneAgent udpates by setting the Automatically update all OneAgent instances switch to the Off position.
  3. From the drop-down list, select the version of Dynatrace OneAgent that is to be installed on all new hosts.

Note: The selected Dynatrace OneAgent version is also used for PaaS integrations.

Controlling auto-update for individual hosts

You can override global Dynatrace OneAgent updates for specific hosts via individual host settings.

To control auto-updates for specific hosts:

  1. Go to Settings > Monitoring > Monitoring overview.
  2. Click the Edit icon of the host you want to modify.
  3. On the Host settings page, click Updates from the menu on the left.
  4. Switch Dynatrace OneAgent automatic updates to either on or off.

Individual host settings override the global auto-update setting.

Manual updates on individual hosts

When a new version of Dynatrace OneAgent becomes available you'll see a notification on your home dashboard. Notifications are also displayed on the Monitoring overview page beside each host that contains an outdated version of Dynatrace OneAgent.

To view the status of an individual host:

  1. Go to Settings > Monitoring > Monitoring overview.
  2. Click the Hosts tab.
  3. To update Dynatrace OneAgent or download the latest version, click the UPDATE button next to the name of the host you're interested in.
  4. Click Update now (note: you need to have permissions to download the installer, otherwise the Update now button is disabled).

Alternatively, you can download the latest version of the Dynatrace OneAgent installer, copy it manually to the target host, and perform installation there directly on the target host.