Try it free

Update Dynatrace OneAgent on Windows

  • Latest Dynatrace
  • 1-min read

OneAgent installed in full-stack mode has a built-in, configurable auto-update mechanism.

See OneAgent update for an overview of OneAgent update, including how to monitor updates and how to create update windows.

Configure OneAgent updates

Go to Settings Settings > Fleet management > OneAgent version and updates. The page has two tabs: Configure updates and Manage update windows.

Version management

On the Configure updates tab, the Version management section controls which version OneAgents update to.

Use the Target version dropdown to set the version that serves as the default for new deployments and as the update target for existing OneAgents. Choose a rolling version policy (Latest version, Previous version, or Older version) or pin a specific version.

Update management

The Update management section controls when updates are applied. Use the Update mode dropdown to select one of the following options:

  • Auto-update as soon as Dynatrace releases—OneAgents update automatically as soon as a new version is released, without waiting for a scheduled window.
  • Auto-update during update windows—OneAgents update automatically, but only during the update windows you configure on the Manage update windows tab.
  • Auto-update disabled—not recommended, as it may put your OneAgents at risk of falling out of the supported version range.

For host-group- or host-level overrides, open Configure updates from the entity's details in Fleet Management Fleet Management.

System requirements

Disk space

For details, see OneAgent files and disk space requirements

Free memory

Your host requires 200 MB free memory to run OneAgent update.

Check installed version of OneAgent

Use one of these methods to check which version of OneAgent you currently have installed.

OneAgent command-line interface

Run oneagentctl with the --version parameter. For more information, see OneAgent configuration via command-line interface.

Host Overview

  1. Go to Hosts Hosts Classic.
  2. Click the host you are interested in.
  3. Expand Properties under the host's name. The installed version of OneAgent is included in the listed properties.

Deployment status

  1. Go to Deployment Status.
  2. Select the All hosts or Recently connected hosts tab.
  3. Expand the host entry you are interested in. The installed version of OneAgent is included in the information that shows up.