Update Dynatrace OneAgent on AIX

OneAgent installed in full-stack mode has a built-in auto-update mechanism, 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.

Auto-update security

OneAgent auto-update mechanism is secure.

  • OneAgent communication is encrypted.
  • OneAgent installers are signed and the signature is verified for each downloaded installer package. If the verification fails, the auto-update attempt is aborted.

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

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.

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.

How to check the currently installed version of OneAgent

To check which version of OneAgent you 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. Select Hosts from the navigation menu.
  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. Select Deployment status from the navigation menu.
  2. Click 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.