Try it free

Update ActiveGate

  • Latest Dynatrace
  • 1-min read
Limitations

Auto-update and One-click update functionalities are limited to host-based—using installer—deployment only.

  • Containerized ActiveGate update behavior

To see a list of installed ActiveGates, go to

  • Latest Dynatrace Fleet Management Fleet Management > ActiveGate, Synthetic Engine, or zRemote.
  • Dynatrace Classic Deployment Status > ActiveGates.

For each ActiveGate, the list gives the current Version of the ActiveGate and any alerts and warnings. See ActiveGate health for details on alerts.

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

ActiveGates in containers are deployed and uploaded using cloud-specific tooling. For example, Kubernetes uses custom resource definitions.

Automatic update

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

Configure ActiveGate updates

Go to Settings Settings > Fleet management > ActiveGate 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 ActiveGates 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 ActiveGates.

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—ActiveGates update automatically as soon as a new version is released, without waiting for a scheduled window.
  • Auto-update during an update window—ActiveGates 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 ActiveGates at risk of falling out of the supported version range.

Go to Settings > Updates > ActiveGate updates.

  • Auto-update—turn on the Automatic updates at earliest convenience toggle for the ActiveGate. When a new version is available, the installation package is downloaded and installed automatically. This is the default setting for new environments; existing environments retain their current setting. The availability check runs at 30-minute intervals.
  • One-click update—to update immediately, select Update. This option is available only when the Automatic updates at earliest convenience toggle is turned off.

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.

  • Install an Environment ActiveGate.

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.

  • See Configure ActiveGate for custom.properties file properties.
  • See Configure ActiveGate launcher for launcheruserconfig.conf properties.

Manage update windows

Latest Dynatrace

Update windows let you schedule automatic ActiveGate updates to occur only during specific time periods. To use update windows, set the Update mode to Auto-update during an update window under Update management.

To view and manage update windows, go to Settings Settings > Fleet management > ActiveGate version and updates and select the Manage update windows tab. The list shows each window's name, recurrence, start time, timezone, duration, and validity period.

Create an update window

  1. Go to Settings Settings > Fleet management > ActiveGate version and updates > Manage update windows.
  2. Select Update window.
  3. Enter a name, set the recurrence (once, daily, weekly, or monthly), start time, timezone, and duration.
  4. Set a Valid during date range to limit when the window is active.
  5. Select Save.

Enable or disable an update window

On the Manage update windows tab, use the status toggle in the Status column to enable or disable individual update windows.

Disabling an update window pauses automatic updates for all entities assigned to it, unless they have other update windows assigned. Updates resume only when the window is manually re-enabled.

Edit or delete an update window

On the Manage update windows tab, open the menu next to the update window and select Edit or Delete.

You can only delete update windows that are not assigned to any entities.

Update status

Dynatrace Classic

The update status for an ActiveGate 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:

  • The cluster is currently upgrading.
  • The maximum number of concurrent update downloads has been reached and the ActiveGate is waiting to resume the download.

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:

  • ActiveGate downloaded the new installer, but the installation was not attempted or was not performed successfully; consequently ActiveGate is still at the old version. Check the ActiveGate auto-updater logs and installer logs for the reason why the installation was not attempted or failed.
  • ActiveGate downloaded the new installer but then failed to re-connect to the server (was lost). Check the ActiveGate installer logs for the reason why the installation failed.
  • There are no installers available for ActiveGate.
  • Update is on hold because—on another Environment—there were update problems with the offered version of ActiveGate.

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, the uninstalled ActiveGate continues to appear with update status Unknown for seven days.