Convert Managed Cluster from offline to online

  • How-to guide
  • 3-min read

To convert a Managed Cluster from offline to online mode, complete the following steps.

Step 1

Review requirements

Step 2

Request online license

Step 3

Run conversion script

Step 4

Verify conversion

Step 1 Review requirements

  • Dynatrace Managed version 1.338+
  • SSH access with sudo capability to all Dynatrace Managed Cluster nodes
  • Cluster API token with the Service Provider API scope
  • Cluster connectivity to Mission Control (the conversion script verifies this)
  • Proxy (if needed, see How to configure internet proxy for cluster)
  • Cassandra and Elasticsearch are healthy.
  • All nodes are up and running.
  • The cluster isn't in maintenance mode.

Step 2 Request online license

Contact your Dynatrace sales representative and request a Dynatrace Managed license in online mode with automatic updates disabled.

Step 3 Run conversion script

Run the script on each Managed Cluster node sequentially to convert it from offline to online mode:

/bin/sh /opt/dynatrace-managed/installer/convert-to-online.sh --api-token <api-token-value> --online-license <online-license-key>
  • Required Replace <api-token-value> with your API token.
  • Required Replace <online-license-key> with your online license key.
  • Optional To enable or disable installation of a self-monitoring OneAgent, add parameter and value --install-agent on or --install-agent off. Default is off.

If the script hasn't converted all Managed Cluster nodes yet, it outputs the following message at the end:

Not all nodes have finished the conversion to online successfully yet. IDs of nodes left to convert: [2]

Step 4 Verify conversion

After the script runs, it displays a message confirming that all Managed Cluster nodes are converted.

If you find the following event under Cluster Management Console > Home > Events, the conversion is complete.

Your Dynatrace Managed cluster has exited maintenance mode due to the end of node conversion to online.

Frequently asked questions

Where can you generate an API token?

In the Cluster Management Console, go to Home > Settings > API tokens > Cluster tokens > Generate token.

For details, see Cluster API authentication.

What happens if a conversion to online fails on a node?

A Managed Cluster stays in maintenance mode until all nodes convert to online. The script is idempotent and can be rerun.

Where can you find logs of the executed script?

By default, the script stores logs in:

/var/opt/dynatrace-managed/logs/installer/

What prechecks are performed at the beginning of the script?

At the beginning of the script, the following prechecks run:

  1. Cassandra and Elasticsearch are healthy.
  2. All nodes are up and running.
  3. The cluster isn't in maintenance mode.