How do I update Dynatrace OneAgent?

To update Dynatrace OneAgent, follow the instructions below for your operating system.

Update Dynatrace OneAgent on Windows or Linux

For Windows and Linux, we've built an auto-update mechanism into Dynatrace OneAgent so you don't have to worry about manually updating the OneAgents running in your environment.

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.

Note:
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.

Note:
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 receive an alert 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 OneAgent or download the latest version, click the Update button next to the name of the host you're interested in.
    Note: The Update button appears only if the installed version of OneAgent on a specific host is outdated and if it is a full-stack OneAgent—this button doesn't appear with PaaS and standalone OneAgents.
  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 OneAgent installer, copy it manually to the target host, and perform installation directly on the target host.

Note:
OneAgent won't automatically update when it's first installed. By default, we wait 1440 minutes (24 hours) before allowing updates on EC2 hosts and 120 minutes on non-EC2 hosts.

Update Dynatrace OneAgent on Solaris (x86 and SPARC)

To update an installed OneAgent instance on Solaris:

Redo all steps of the initial installation but install OneAgent to a new directory.

Stop all monitored processes.

Rename the current OneAgent installation directory (for example, /opt/dynatrace/oneagent-old) using the following command:

mv /opt/dynatrace/oneagent /opt/dynatrace/oneagent-old.

This folder can be deleted following OneAgent update.

Rename the updated OneAgent folder to point to the original installation directory (for example, /opt/dynatrace/oneagent) using the following command:

mv /opt/dynatrace/oneagent-update /opt/dynatrace/oneagent

Restart all processes that are to be monitored.

Update Dynatrace OneAgent on IBM AIX

For v.141, use the standard Dynatrace OneAgent update supported for Windows and Linux.

For v.140 and below:

Redo all steps of the initial installation but install Dynatrace OneAgent into a new directory.

Stop all monitored processes.

Rename the current Dynatrace OneAgent installation directory (for example, /opt/dynatrace/oneagent-old) using the following command: mv /opt/dynatrace/oneagent /opt/dynatrace/oneagent-old. This folder can be deleted following Dynatrace OneAgent update.

Rename the updated Dynatrace OneAgent folder to point to the original installation directory (for example, /opt/dynatrace/oneagent) using the following command: mv /opt/dynatrace/oneagent-update /opt/dynatrace/oneagent

Restart all processes that are to be monitored.