Try it free

Convert Managed Cluster from offline to online

  • How-to guide
  • 3-min read

To convert a Managed Cluster from offline to online mode, follow the steps below.

Step 1 Review requirements

Confirm that your Managed Cluster meets the following requirements before you start the conversion.

  • Dynatrace Managed version 1.338+
  • SSH access with sudo capability to all Cluster nodes
  • Cluster API token with the Service Provider API scope
  • Managed Cluster connectivity to Mission Control (the conversion script verifies this)
  • Proxy, if needed (see Configure internet proxy)
  • Healthy Cassandra and Elasticsearch
  • All nodes up and running
  • Managed Cluster not 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 turned off. You receive an online license key, which you need to run the conversion script.

Step 3 Run conversion script

Run the script on each 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 choose whether the script installs a self-monitoring OneAgent, add --install-agent on or --install-agent off. The default is off.

If the script hasn't converted all 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]

If the conversion fails on a node, rerun the script on that node. The script is idempotent, and the Managed Cluster stays in maintenance mode until all nodes convert to online.

When the script finishes on the last Cluster node, it displays a message that confirms the conversion of all Cluster nodes.

To confirm that the conversion is complete, go to Cluster Management Console > Home > Events and find the following event:

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 Managed Cluster isn't in maintenance mode.