Showing results for 
Show  only  | Search instead for 
Did you mean: 
Looking to upgrade from Dynatrace Managed to SaaS? See how

Upload updates manually in offline Dynatrace managed deployment

Dynatrace Helper
Dynatrace Helper

How to manually upload updates on managed offline installation?


Dynatrace Helper
Dynatrace Helper

Please follow the steps outlined below to apply Dynatrace cluster and agent updates.

  1. Download updates bundle archive
  2. Unpack updates archive e.g. to /tmp directory. You should get 2 files: and
  3. Unpack into: /var/opt/dynatrace-managed/agents
  4. Unpack into: /var/opt/dynatrace-managed/installer/upgrade

In case you download updates from a separate links:

1. Download a file

2. Extract to:

  • Dynatrace Managed cluster updates go to: /var/opt/dynatrace-managed/installer
  • Other files to /var/opt/dynatrace-managed/installer


Additionally, to update:

  • Nginx Offsets,
  • Go external metadata files,
  • revoked OneAgent versions files,

you need to call REST endpoint to apply them:


Auth token: ControlManagement (generate using Cluster Tokens API)


Nginx offset
Path: POST /api/v1.0/control/clusterManagement/goMetadataArchive/clusterManagement/nginxOffsetFile
form data param: "file" (binary)


Go metadata:
Path: POST /api/v1.0/control/clusterManagement/goMetadataArchive/deployBundle
form data param: "metadata-archive" (binary)


Revoked OneAgent versions files

Path: POST /api/v1.0/control/clusterManagement/badInstallerVersionsFile

form data param: "file" (binary)



Senior Product Manager,
Dynatrace Managed expert


Is it /var/opt/dynatrace-managed/installer or  /var/opt/dynatrace-managed/installer/upgrade?  Also, will it automatically distribute across all cluster nodes, or do does it need to be put on all the nodes?

You're right! It's "/installer/upgrade" 

Senior Product Manager,
Dynatrace Managed expert

With the recent release of Agent AND Active Gate of version:, this process doesn't work.  I am assuming since they are both the same exact version we have to manually merge the build-unit-agent.json?

@eric_speed the UI upload approach does not work for you? In Managed Offline the updates should be uploaded using UI. Or you are speaking out Managed (not the offline) version?

Certified Dynatrace Master | Alanata a.s., Slovakia, Dynatrace Master Partner

We are indeed offline.  We have essentially mimic the auto download process if connected to mission control.  We periodically check Mission Control for new bundles, download, and push them to one of the nodes in the cluster as discussed above.  This time we ran into issues with two of the bundles having the exact same version and overwriting the json file causing availability issues of said bundles in the cluster.  It was verified that via the UI process this does work successfully.  I rechecked to see if there was any new API for this vs vs copying it to a node but I did not see one.

I'd probably mimic the UI upload as well (login to the CMC and upload the file) instead of trying to upload it directly in the directories. The UI requests are actually quite simple to mimic.

Certified Dynatrace Master | Alanata a.s., Slovakia, Dynatrace Master Partner

Dynatrace Helper
Dynatrace Helper

It will automatically distribute updates across all cluster nodes.

Frequent Guest

We have Dynatrace Managed but the connection to Mission Control is very very slow and It can't finish download ActiveGate bundle. We have the Active Gates installation stopped for one week. is there a way to download ActiveGate update and mannually upload into the cluster nodes?

Yes, contact your CSM or Dynatrace ONE vi help chat. 

Senior Product Manager,
Dynatrace Managed expert

Featured Posts