Update Cluster ActiveGate
This page will soon be available only on the dedicated Dynatrace Managed Documentation site. Update your bookmarks.
To see a list of installed ActiveGates, select Deployment status > ActiveGates from the navigation menu. 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.
ActiveGates in containers are deployed and uploaded using cloud-specific tooling. For example, Kubernetes uses custom resource definitions.
To manage the update functionality of a particular ActiveGate in the list, select the ActiveGate to expand the details.
To use the auto-update feature, make sure that the Automatic updates toggle for the ActiveGate is turned on. This means that when a new version of ActiveGate becomes available, a new installation package will be downloaded to the particular host, and the new version of ActiveGate will be installed. This is the default setting for new environments. For existing environments, the setting remains unchanged.
The availability check is performed at 30-minute intervals.
To perform the update immediately, select Update. This functionality is available only if the Automatic updates toggle is turned off for the particular ActiveGate.
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
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.
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.
There is an update available for this ActiveGate version.
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
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.
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.
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 Deployment status will continue to display the uninstalled ActiveGate with update status
Unknown for seven days.