Update ActiveGate
- Latest Dynatrace
- 5-min read
Auto-update and One-click update functionalities are limited to host-based—using installer—deployment only.
To see a list of installed ActiveGates, go to 
Fleet Management > ActiveGate, Synthetic Engine, or zRemote.
For each ActiveGate, the list gives the current Version of the ActiveGate and any alerts and warnings. See ActiveGate health for details on alerts.
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 > 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.
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.
- See Configure ActiveGate for
custom.propertiesfile properties. - See Configure ActiveGate launcher for
launcheruserconfig.confproperties.
Manage update windows
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 > 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
- Go to Settings > Fleet management > ActiveGate version and updates > Manage update windows.
- Select Update window.
- Enter a name, set the recurrence (once, daily, weekly, or monthly), start time, timezone, and duration.
- Set a Valid during date range to limit when the window is active.
- Select Save.
Turn an update window on or off
On the Manage update windows tab, use the status toggle in the Status column to turn individual update windows on or off.
Turning off an update window pauses automatic updates for all entities assigned to it, unless they have other update windows assigned. Updates resume only when you turn the window back on.
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.