Try it free

Reconfigure the IP address of a Cluster node

  • How-to guide
  • 2-min read

Cluster version 1.320+

As you develop your infrastructure, Dynatrace Managed aims to adapt to the dynamic nature of cloud-based data centers.

Dynatrace Managed relies on static IP addresses. The IP reconfiguration feature allows you to reconfigure the IP address on a node dynamically, so you don't need to remove the node and then install a new one.

For a successful IP address reconfiguration, your Managed Cluster must have at least three nodes.

If both the old and new IP addresses are assigned to the same machine, ensure that the routing table is configured to route all outgoing traffic to other Cluster nodes exclusively through the new IP address.

The IP address reconfiguration can also serve as an alternative to:

  • Migrate a Managed Cluster
  • Apply operating system patches to a node

Steps

Generate a token

  1. Go to Cluster Management Console > Settings > API tokens.
  2. Scroll down and select Cluster tokens.
  3. Select Generate token and enter a name in the Token name field.
  4. Turn on Service Provider API.
  5. Copy the token and save it somewhere safe, because you can access it only once.

Check the node data

Make sure all node data is available on the node you want to reconfigure. You can do it:

  • By copying the data to the node.
  • By mounting the disks.

Run the script

Run the script below on the node you want to reconfigure:

/opt/dynatrace-managed/installer/migrate-ip-local.sh --seed-auth <cluster-token>

Replace <cluster-token> with the token that you generated in Generate a token.

The script takes some time, even up to one hour. When it finishes, the node should be visible in the Managed Cluster under the new IP address.

Additionally, a Managed Cluster event notifies the Managed Cluster administrator that the IP reconfiguration is in progress.

FAQ

Where is the log of reconfiguration process located?

You can find the main log in /var/log/dynatrace/install.log on the reconfigured machine. Many components on all nodes take part in this process, so details of each step can be found in the relevant logs.

Can I run the script more than once?

Yes, you can run the script multiple times, but one at a time.

What if I have more than one network interface?

You need to specify the IP address you want to use for Dynatrace using the --cluster-ip <ip-for-dynatrace> parameter.

Can I change the IP address of more than one node simultaneously?

No, you can change only one node at a time.

What if any of the steps fail?

Check the log and try to fix the issue. Then, you can run the script again.

Related topics

  • Migrate a Managed Cluster
  • Apply operating system patches to a node