Dynatrace Managed in offline mode
Dynatrace Managed is also offered in an offline version. In this version, Dynatrace Managed is associated with an offline license. This is a special license that disables all features that require a connection to the internet, such as a connection to Dynatrace Mission Control to report license usage and health status or to update the cluster automatically to a newer version.
For Dynatrace Managed, we have a support policy of 4 months. It is your responsibility to keep Dynatrace Managed up to date.
Offline vs. online mode
| Installation step | Online mode (full or trial) | Offline mode |
|---|---|---|
| Installation - license1 | license key | license file |
| Installation - Mission Control connection checking | Yes (required) | No, skipped |
| Installation - License verification with Mission Control2 | Yes (required) | No, skipped |
| Installation - OneAgent self-monitoring download & installation | Yes (optional) | No, skipped |
| Server - updates download (including OneAgent, RUM JavaScript, ActiveGate, NGINX offsets)3 | Automatic from Mission Control | Manual from update e-mail |
| Server - certificates handling | Automatic from Mission Control | Only self-signed provided by default |
| Network - ports that are required | Ports for Dynatrace Managed | same as for online with the exception of Mission Control connection and live.dynatrace.com (for self-monitoring agent) |
| Mission Control - updates | Published updates are automatically synchronized with the cluster | Published update URLs are sent via email to license contacts |
| Mission Control - health check statistics | Every 5 minutes health-check is updated | No health-check stats available |
| Mission Control - license updates | Every 5 minutes license updates are synchronized with the cluster | License needs to be updated manually via Cluster UI |
| Mission Control - designates one part of the Premium HA cluster as primary (surviving) | Automatic from Mission Control | Not supported |
To install Dynatrace Managed in offline mode, the license file should be added via the –license-file <license-filename> command line parameter - no other option is required (the invitation email contains the installation instruction with the right parameter and the offline license file). The offline node is indicated in the installation log with offline mode is active entries.
License is verified by the server after start (not during installation) through a signature (hash) included in the license file. The license file is copied to the server's config directory. The path to this file is set in the license.file entry in the server's config.properties file.
The Dynatrace Server doesn't contain any installation packages either for OneAgent or ActiveGate (in online mode, both are automatically downloaded from Mission Control) so they must be added manually after installation. Users get the links for download by email.
Install Dynatrace Managed with offline license
Before installing Dynatrace Managed with an offline license, verify that the license.lic file and the cluster installer are downloaded or copied to your server machine. The license file, cluster installation file, and OneAgent bundles are provided in the invitation email.
Then follow the instructions to set up Dynatrace Managed, but instead of providing the license key as an installation parameter, you need to use the following command:
sudo /bin/sh dynatrace-managed-installer.sh --license-file license.lic
Activate the offline license
After installation, you need to activate your offline license to start monitoring.
- Log in to Cluster Management Console.
- Go to Licensing and select Activate license.
- If you have internet access, you are redirected to an external internet registration form (https://mcsvc.dynatrace.com/register.html) with all fields already completed. Please verify them.
- If you don't have internet access, use a browser that allows you to open
https://mcsvc.dynatrace.com/register.htmland complete the form manually.- Required: License key and Cluster identifier
- Optional: Installed version (the current cluster version) and Cluster admin email address (an email address through which Dynatrace product experts can contact cluster administrators in case of an emergency)
- Select Activate license. The next page confirms that the license has been activated.
- On the confirmation page, select Download license file to download the
license-activated.licfile. - Select Go to Licensing page.
- On the Licensing page, select More (…) > Apply license in the upper-right corner.
- Select the
license-activated.licfile you downloaded earlier. When the file is applied, the license status is displayed as Active.
Update the offline license
To update your license
- Download the
license.licfile from the invitation email. - Log in to Cluster Management Console.
- Go to Licensing and apply the license.
Update Dynatrace Managed
To update Dynatrace Managed, you have to download the installation packages and then upload the downloaded packages to your cluster.
Dynatrace Managed versions are released sequentially, but you can skip certain versions in the rollout process to update to a newer version faster. For installed Managed versions that allow for faster updates, we recommend waiting until the target version is released if you cannot complete the update process within one month.
The following table illustrates the version logic.
| Installed version | Can update to version |
|---|---|
| 1.306 | 1.308 |
| 1.304 | 1.306 (only before 1.308 is released); 1.308 |
| 1.302 | 1.304 |
| 1.300 | 1.302 (only before 1.304 is released); 1.304 |
If your installed Managed version is 1.300 and you want to update it to version 1.304, you can skip version 1.302 as soon as 1.304 is released.
If version 1.304 has not yet been released, you need to first update to version 1.302 and then to version 1.304. However, once version 1.304 is released, version 1.302 will no longer be available for download.
Please note that you can skip a Managed version only if its installed version is divisible by 4.
Download installation packages
The installation packages are not downloaded automatically from Mission Control. The invitation email contains a Cluster installer link. Select the link to download the installation packages for the cluster installer. Also, the invitation email contains an agents bundle link through which you can download the installation packages for OneAgent.
Alternatively, the next update can be downloaded from the URL included in the New updates available for Dynatrace Managed email.
Upload downloaded packages to your cluster
-
Log in to Cluster Management Console.
-
Go to Settings > Automatic update.
-
Select Upload installation package to upload all the downloaded packages to your cluster.
Alternatively, you can manually extract and copy files to
/opt/dynatrace-managed/installer/upgradefor cluster updatesand
/var/opt/dynatrace-managed/agentsfor OneAgent/RUM JavaScript/ActiveGate updates.
After uploading the packages, the cluster will behave in the same way as if they were downloaded automatically. OneAgent and ActiveGate will be available for download and installation. The cluster update will be performed automatically within the defined maintenance window, or you can trigger the update manually. For details, see Update Dynatrace Managed.
Frequently asked questions
An installation package upload error typically occurs when attempting to upload a full package containing a full Managed installer, OneAgent installers, JavaScript agents, a security gateway, and Synthetic. In this case, the package size exceeds the technical package upload limit (greater than 2 GB).
In Cluster Management Console > Automatic update, select Upload installation package to upload all the downloaded packages to the cluster.
Alternatively, you can manually extract and copy files to
/opt/dynatrace-managed/installer/upgrade for cluster updates
and
/var/opt/dynatrace-managed/agents for OneAgent/RUM JavaScript/ActiveGate updates.
If the license file is corrupted, the installation will be completed and the server will start, but it will indicate that there is a problem with the license. In this case, a new license can be uploaded in Cluster Management Console. For details, see Update the offline license.
In Cluster Management Console, you can download diagnostic data. For details, see Diagnostic archives for Dynatrace Managed installations.