How do I update Dynatrace OneAgent?

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 on by default. You can disable 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, as 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 > OneAgent updates.
  2. Switch on Automatically update all 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 updates 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.

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

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 button (the pencil icon) of the host you are interested in.
  3. On the Host settings page, click OneAgent updates from the menu on the left. Then you will be able to see the current version of OneAgent running on the specific host.
  4. Switch off Apply Global updates settings for OneAgent updates.
  5. Switch on Update Dynatrace OneAgent on this host automatically.

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. In addition, warning symbols are displayed on the Monitoring overview page beside each host that contains an outdated version of Dynatrace OneAgent.

To manually update OneAgent running on 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.
    Note: The button appears only if the installed version of Dynatrace OneAgent on the specific host is outdated and only in case of full stack OneAgents—i.e. for PaaS and stand-alone OneAgents, the button won't appear.
  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.

Dynatrace OneAgent will not automatically update if it has been recently installed. By default, we wait 1440 minutes (24 hours) before allowing updates on EC2 hosts and 120 minutes on non-EC2 hosts.