Update Dynatrace Managed

To run a successful update, you need at least 5 GB of available disk space on the partition where Dynatrace Managed is installed. For details see Managed hardware requirements.

Update of Dynatrace Managed consists of two steps:

  1. Downloading the update package.
  2. Performing the actual update.

Dynatrace Managed version updates are performed sequentially. For example, if your installed Managed version is 1.292 and you want to update it to version 1.296, first, you need to update to version 1.294 and then to 1.296.

Dynatrace Managed version 1.296+ You can update Dynatrace Managed faster by skipping certain versions. For example, you're able to update from Managed version 1.296 directly to 1.300.

However, you can skip a Managed version only if its installed version is divisible by 4. If a version is not eligible, you still have to update Dynatrace Managed sequentially. The following table illustrates the version logic:

Installed version
Can update to version
1.296
1.298 (only before 1.300 is released); 1.300
1.298
1.300
1.300
1.302 (only before 1.304 is released); 1.304
1.302
1.304

Update package download

By default, update packages are downloaded automatically as soon as they are available to your cluster.

However, if you need strict control over download packages, you can opt out from automatic download of updates. In that case, you need to update your license. Contact a Dynatrace product expert via live chat within your Dynatrace environment. For air-gapped deployment (not connected to Mission Control) or when you opt out from automatic download, you will receive an email notification whenever a new update package is available. It will contain a link to download the update packages, so you can upload it manually to the cluster.

Use Cluster Management Console (CMC) to upload the patch to the cluster. Go to Settings > Automatic update and select Upload. Cluster Management Console will propagate the update package to all of the nodes. If you do not want to use the UI, you can manually copy the extracted cluster installer files to the <INSTALLATION_DIR>/installer/upgrade directory on each cluster node.

For automatic updates, specify a convenient time for the system to upgrade itself (for example, during a maintenance window).

Update in progress

Your monitoring and cluster management pages won't be accessible during the upgrade process if your cluster consists of less than 3 nodes.

To define a start time for automatic updates:

  1. Go to Settings > Automatic update.

  2. Set the Install Dynatrace cluster updates automatically switch to the On position.

    This switch is disabled if your license doesn't allow to opt out from automatic updates. To change your license allowance, contact a Dynatrace product expert via live chat within your Dynatrace environment.

  3. Specify a weekly maintenance window start time. Dynatrace Managed updates will start at the time you specify.

After the Dynatrace cluster update is downloaded, a 24-hour waiting period is required before an automatic update can run. This means that an automatic update is attempted during the first scheduled maintenance window that occurs 24 hours after the download completes. For example, if you download a cluster update today and the maintenance window is scheduled for 1:00 AM tomorrow, your update will be executed in the following week, not tomorrow, because the 24-hour waiting period will not be finished by 1:00 AM tomorrow.

Manually triggered update

For manually triggered updates, you have to trigger the actual update with the user interface (go to Settings > Automatic update) or via the Cluster REST API. Once triggered, the update process is performed in the same way as in the automatic updates. Typically, you would use the manually triggered update if you wish to initiate the update outside scheduled maintenance window.

Manual update

For manual updates, you must manually initiate the update script on each node. Since the node that's being updated isn't operating, it's crucial that you manually update one node at a time: Wait until the node update completes before starting an update on the next node.

To manually update the cluster, perform this procedure for each node in sequence one node at a time:

  1. Find the update script in <INSTALLATION_DIR>/installer/upgrade

  2. Give the update script executable permissions. Use Linux chmod command.

    [root@localhost]# chmod +x dynatrace-managed-1.238.0.20220309-065315.sh

    1.238.0.20220309-065315 is an example installer script version. Installer script of an updated version by default is placed at <INSTALLATION_DIR>/installer/upgrade/, provided that your automatic version update process is turned on.

  3. As a root user, execute the update script. Once the update completes successfully, move to the next node and repeat the procedure.

    [root@localhost]# ./dynatrace-managed-1.238.0.20220309-065315.sh --upgrade
    [root@localhost]# ./dynatrace-managed-1.238.0.20220309-065315.sh --upgrade
    Starting Dynatrace 1.238.0.20220309-065315 installer ...              OK
    Testing connection to Dynatrace Mission Control ...                     OK
    Verifying system compatibility ...                                      OK
    Verifying disk space ...                                                OK
    Verifying Dynatrace directories ...                                     OK
    Verifying system privileges ...                                         OK
    Verifying system connectivity ...                                       OK
    Stopping Dynatrace ...                                                  OK
    Preparing system user for Dynatrace ...                                 OK
    Initializing upgrade ...                                                OK
    Checking user permissions ...                                           OK
    Checking file ownership ...                                             OK
    Downloading Dynatrace OneAgent. This may take a few minutes ...         OK
    Upgrading. This may take a few minutes ...                              OK
    Preparing connectivity settings ...                                     OK
    Setting up cluster configuration. This may take a few minutes ...       OK
    Starting Dynatrace. This may take up to half an hour ...                OK
    

    Upgrade completed successfully after 8 minutes 50 seconds.
    

    Dynatrace binaries are located in directory /opt/dynatrace-managed
    Dynatrace data is located in directory /var/opt/dynatrace-managed
    Dynatrace metrics repository is located in directory /var/opt/dynatrace-managed/cassandra
    Dynatrace Elasticsearch store is located in directory /var/opt/dynatrace-managed/elasticsearch
    Dynatrace server store is located in directory /var/opt/dynatrace-managed/server
    Dynatrace session replay store is located in directory /var/opt/dynatrace-managed/server/replayData
    You can now log into your Dynatrace Server at https://10.10.10.10
    

    [root@localhost]#

Dynatrace Managed version check

To check which Dynatrace Managed version you currently use:

  1. Log into Cluster Management Console or one of your monitoring environments.

  2. Open the User menu in the top right corner. The version number appears at the bottom right corner of the User menu.

Alternatively,

  1. Navigate to the home page of your Cluster Management Console, where you can view your Dynatrace Managed deployment status.

  2. Click a Dynatrace Managed node to open the overview page of this node. The installed version appears right under the title of the page.