Update ActiveGate

• How-to guide
• 5-min read
• Updated on Jun 23, 2026

View installed ActiveGates and update status

To see a list of installed ActiveGates, go to Deployment Status > ActiveGates. For each ActiveGate, the list gives the current Version of the ActiveGate and the Update status (up to date, pending, or in progress).

The yellow warning icon indicates that your ActiveGate is behind by more than five versions. You should update these ActiveGates as soon as possible.

Automatic update

To manage the update functionality of a particular ActiveGate in the list, select the ActiveGate to expand the details.

Configure automatic updates

To configure how Environment ActiveGates update:

Update mode

The update mode controls when an Environment ActiveGate applies a pending update.

For existing environments, the update mode keeps your previous behavior: if auto-update was turned on, it becomes Automatic (earliest convenience); if it was turned off, it becomes No automatic updates.

Target version

Select which ActiveGate version Dynatrace should converge on.

The selector displays the current main version next to each stable preset (for example, Latest stable (currently 1.343)) so you can see which build each preset resolves to.

The Environment Deployment API treats the configured target version as the latest available for the environment. Build-unit protection prevents the cluster from pruning the installer for any version that's configured as a target.

Downgrade is prohibited: A configured target version is never used to roll an ActiveGate back to a lower version.

Update windows

You configure update windows once and share them between OneAgent and Environment ActiveGate. See Configure update windows on the OneAgent update page to list, create, edit, turn on, turn off, delete, and apply windows.

When the same window applies to ActiveGates, Dynatrace throttles concurrent updates per pool (see Concurrency and safety below).

Scope hierarchy

ActiveGate auto-update settings follow this override order:

By default (new environment installation), ActiveGates update at the earliest convenience to the latest eligible version.

Update now to target version

You update an individual ActiveGate manually from its own update settings, not from the environment-wide defaults: open the ActiveGate updates settings for that specific ActiveGate. For an ActiveGate set to No automatic updates that is on a version older than its configured target version, the settings show the version it will update to and provide an Update now to target version button. Select the button to trigger the update immediately.

Update now to target version is unavailable when the configured target version cannot be resolved (for example, the build is no longer present on the cluster).

Concurrency and safety

To preserve routing capacity for monitored hosts, Dynatrace throttles concurrent ActiveGate updates within each pool. A pool is defined by the combination of network zone, ActiveGate group, and ActiveGate purpose (for example, default routing or synthetic). By default:

Additional safeguards:

Limitations and scope

Programmatic access

Manual download and update

Manual download and update

You can also download and update your ActiveGate manually. You don't need to uninstall your current version of ActiveGate. Just install the new version over the old one, and the ActiveGate configuration will be migrated.

During an update, your ActiveGate configuration is preserved in the custom.properties and launcheruserconfig.conf files. These two files will not be overwritten during an update, but it's good practice to back them up before updating the ActiveGate.

Update status

The update status for an ActiveGate, as listed on the Deployment Status page, can assume the following values:

Up to date
The latest available ActiveGate version is installed on the respective host.

Update available
There is an update available for this ActiveGate version.

Update pending
Immediately after selecting Update ActiveGate, the status changes to Update pending and remains in this status until the update process begins. The status may also be listed as pending if:

Update in progress
The ActiveGate has requested and downloaded the new installation package from the server, and is currently in the process of installing it or re-connecting to the server.

Update problem
In this case you will see the old version number displayed for the ActiveGate.
Possible problems are:

Unknown
The connection to this ActiveGate has been lost and no status can be determined.
This status can also be displayed if an ActiveGate was successfully removed: In this case, Deployment Status will continue to display the uninstalled ActiveGate with update status Unknown for seven days.