Try it free

Install Dynatrace Managed in offline mode

  • How-to guide
  • 4-min read

To install Dynatrace Managed in offline mode, follow the steps below.

Step 1

Review requirements

Step 2

Download and verify files

Step 3 optional

Retrieve software bill of materials file

Step 4

Run installer

Step 5

Activate license

Step 6

Upload agents bundle

Step 1 Review requirements

Ensure that your system meets the hardware requirements and system requirements.

The offline license turns off all features that need an internet connection, such as license reporting and health checks through Mission Control and automatic Managed Cluster updates. You're responsible for keeping Dynatrace Managed up to date and reporting license usage to Dynatrace.

For how offline mode differs from online mode, see Offline and online mode differences.

Avoid installing the data stores for Dynatrace Managed components on network or remote disks, because this can cause performance and stability issues.

Step 2 Download and verify files

  1. Download the following files from the activation email and copy them to the directory on your Linux host where you want to install Dynatrace Managed:

    • License file, named license-<license-name>-<creation-date>.lic, with the creation date in YYYY-MM-DD format, or license-<creation-date>.lic if the license has no name.
    • Dynatrace Managed installer (cluster installer)
    • OneAgent, RUM JavaScript, ActiveGate, and Synthetic installation packages (agents bundle)
    Activation email example
    Content of the Dynatrace Managed activation email
    Content of the Dynatrace Managed activation email

  2. Download the Dynatrace root certificate and the installer signature file using the links provided in the activation email.

    The Dynatrace Managed installer is digitally signed. Use OpenSSL and the Dynatrace root certificate to verify the installer's authenticity. The signature file has the same name as the installer with a .sig extension.

  3. Verify the installer file signature using this command.

    openssl cms -inform PEM -binary -verify -CAfile dt-root.cert.pem -in dynatrace-managed-<version>.sh.sig -content dynatrace-managed-<version>.sh > /dev/null

    Replace <version> with your Dynatrace Managed version.

    A successful verification returns Verification successful. On failure, you see Verification failure followed by details.

Step 3 optional Retrieve software bill of materials file

Follow the instructions in the optional step 3 of the Managed Cluster installation guide to retrieve a software bill of materials file.

Step 4 Run installer

Follow the instructions in Run installer (step 4) and Finalize (step 5) of the Managed Cluster installation guide. Use the --license-file parameter instead of a license key:

sudo /bin/sh dynatrace-managed-<version>.sh --license-file <license-file>

Replace <version> with your Dynatrace Managed version and <license-file> with the name of the license file. The activation email shows the filename.

Step 5 Activate license

Activate your license.

  1. Sign in to the Cluster Management Console.
  2. Go to Licensing and select Activate license.
    • If you have internet access, you're redirected to an external registration form (https://mcsvc.dynatrace.com/register.html) with all fields pre-filled. Verify the details and submit.
    • If you don't have internet access, open https://mcsvc.dynatrace.com/register.html in a browser with internet access and complete the form manually.
      • Required: License key and Cluster identifier
      • Optional: Installed version (the current Managed Cluster version) and Cluster admin email address (an email address through which Dynatrace product experts can contact Managed Cluster administrators in case of an emergency)
  3. Select Activate license. The next page confirms that the license has been activated.
  4. On the confirmation page, select Download license file to download the activated license file. It's named license-<license-name>-<creation-date>.lic or license-<creation-date>.lic.
    • The activated license file can have the same filename as the license file from the activation email, so your browser might save it with a suffix such as (1).
  5. Select Go to Licensing page.
  6. On the Licensing page, select > Apply license.
  7. Select the activated license file you downloaded in step 4.
    • After applying the license, the license status changes to Active.

Step 6 Upload agents bundle

Upload the agents bundle to the Managed Cluster.

  1. Sign in to the Cluster Management Console.

  2. Go to Settings > Automatic update.

  3. Select Upload installation package to upload it to the Managed Cluster.

    The Cluster Management Console shows Upload successful. In Installation packages, check that each package of the bundle has the status available.

Alternatively, you can manually copy the agents bundle to the following directory on your Linux machine:

/var/opt/dynatrace-managed/agents

Frequently asked questions

What can you do if an error occurred while uploading the installation package?

An installation package upload error typically occurs when attempting to upload a full package containing a Managed installer, OneAgent, RUM JavaScript, ActiveGate, and Synthetic. In this case, the package size exceeds the 2 GB upload limit.

  1. Sign in to the Cluster Management Console.
  2. Go to Settings > Automatic update.
  3. Select Upload installation package to upload only selected installation packages to the Managed Cluster.

Alternatively, you can manually copy installation packages to the following directories on each Cluster node.

  • Packages for the Managed Cluster:

    /opt/dynatrace-managed/installer/upgrade

  • Packages for OneAgent, RUM JavaScript, ActiveGate, and Synthetic:

    /var/opt/dynatrace-managed/agents
What can you do if there is a problem with the license?

If the license file is corrupted, the installation completes and the server starts, but it indicates a problem with the license. In this case, upload a new license in Cluster Management Console. For details, see How do you update the license?.

How do you update the license?

To update your license, follow these steps.

  1. Download the license file (license-<license-name>-<creation-date>.lic or license-<creation-date>.lic) from the license update email.
  2. Sign in to the Cluster Management Console.
  3. Go to Licensing and apply the new license.
How do you obtain diagnostic data for further analysis?

In Cluster Management Console, you can download diagnostic data. For details, see Diagnostic archives.

What's next

  • Update the Managed Cluster with a semi-automatic Managed Cluster update.