Upload updates manually in offline Dynatrace managed deployment

[marek_kapusto]

How to manually upload updates on managed offline installation?

[marek_kapusto · Accepted solution]

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: server.zip and agents.zip
3. Unpack agents.zip into: /var/opt/dynatrace-managed/agents
4. Unpack server.zip into: /var/opt/dynatrace-managed/installer/upgrade

[Radoslaw_Szulgo · Accepted solution]

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)

[eric_speed]

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?

[Radoslaw_Szulgo · Accepted solution]

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

[eric_speed]

With the recent release of Agent AND Active Gate of version: 1.237.242.20220421-112038, 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?

[Julius_Loman]

@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?

[eric_speed]

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.

[Julius_Loman]

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.

[marek_kapusto]

It will automatically distribute updates across all cluster nodes.

[VictorG]

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?

[Radoslaw_Szulgo]

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