This website uses Cookies. Click Accept to agree to our website's cookie use as described in our Privacy Policy. Click Preferences to customize your cookie settings.
Accept
Reject
Preferences
FAQ
Troubleshooting
Articles about how to solve the most common problems
cancel
Turn on suggestions
Auto-suggest helps you quickly narrow down your search results by suggesting possible matches as you type.
Showing results for 
Show  only  | Search instead for 
Did you mean: 
New Article

Premium High Availability setup for New Cluster

chiranjitdutta
Dynatrace Organizer
Dynatrace Organizer

on ‎15 Jan 2026 11:56 AM

Summary: This article provides a straightforward, step-by-step guide to setting up a new Premium High Availability (PHA) cluster. The official public document is available for reference. This guide is designed to simplify the installation process by including visual aids, such as screenshots, to make it easier to follow.

 

 

Basic Steps for PHA Deployment

Prerequisites for Premium HA (PHA) Deployment

Before setting up a Premium High Availability (PHA) cluster, it is essential to ensure that several prerequisites are met. The following checklist outlines the necessary steps and considerations to prepare your environment for a successful deployment:

1. License Verification

Confirm that your Dynatrace license includes Premium HA (PHA) capabilities. If PHA is not enabled, contact your Customer Success Manager (CSM) or Customer Solutions Engineer (CSE) to arrange for this feature to be activated. Refer to the documentation for more information.

2. Hardware and System Requirements

Ensure that all hardware and system requirements are fulfilled before installation. This includes verifying that the servers and infrastructure meet or exceed the minimum specifications outlined in the Managed hardware requirements documentation.

3. Cluster Node Ports Configuration

It is critical to configure cluster node ports for bi-directional connectivity. Without proper bi-directional communication, cluster nodes won't be able to interact as required, leading to failures during installation and operation. Refer to the  Managed Network Ports documentation for detailed configuration steps.

4. Mission Control Connectivity

Verify that the cluster can establish a connection to Dynatrace Mission Control. This connection is necessary to validate the license, monitor cluster health, and perform other essential functions. Note that Premium HA clusters require an online connection to Mission Control and are available only for Managed online clusters. See documentation.

5. SELinux Status

Check whether SELinux is enabled or disabled on all nodes. If SELinux is enabled, it must be set to ENFORCING mode for managed services to function correctly. Consult the Dynatrace Managed SELinux documentation for guidance on configuring SELinux.

6. Minimum and Maximum Cluster Node Requirements

A Premium HA cluster requires a minimum of six nodes, with three nodes located in each data center. The maximum supported configuration is thirty nodes, with up to fifteen nodes per data center. Ensure that your planned deployment meets these requirements to guarantee proper operation and high availability

 

Installation steps

Step 1: Installation in Datacenter 1 (DC1)

Begin the installation process by deploying the first cluster in Datacenter 1. This example uses three nodes for DC1. Please follow the standard installation procedure as outlined for your specific environment.

Once all three cluster nodes are installed in DC1, proceed with setting up Premium High Availability (HA) as per the documentation. During this stage, ensure that backup remains disabled, especially if it was previously enabled, until the entire setup process is fully completed.

Step 2: Inter-datacenter Communication Check

It is essential to confirm that nodes across both DC1 and DC2 can communicate with each other. To verify connectivity, execute the following command from a host in DC2, replacing with the appropriate IP address:

curl -k https://<DC-1-node-IP>/rest/health

Step 3: Setting Environment Variables

Set the required environment variables on every node in both datacenters. Below is a template for the variables you need to configure:

  • SEED_IP=x.x.x.5 – (IP address of the DC1 seed node)
  • DT_DIR=/opt/dynatrace-managed – (Directory where Dynatrace binaries are located)
  • NODES_IPS=$(echo '["x.x.x.14", "x.x.x.15", "x.x.x.16"]') – (List of DC2 node IPs)
  • API_TOKEN=dt0c01.GJBLXR5JSOBAZZDND355S2R3.xxxxxxxx – (API Token with ServiceProviderAPI scope from CMC)
  • DC1_NAME=datacenter1 – Consistent name for DC1 (confirm using ./cassandra-nodetool.sh status)
  • DC2_NAME=DC2 – Name for DC2 (can be any preferred value)

chiranjitdutta_19-1766398172823.png

 

Step 4: Configuration File Verification

Check whether custom.settings exist for Cassandra and Elasticsearch. For new installations, this file may not be present. If it does exist, contact Dynatrace support for guidance on required changes.

Step 5: Reconfiguration in DC1

On the Datacenter 1 nodes, execute the following command to reconfigure Elasticsearch for Premium HA. You can monitor its progress using tail -f nohup.out

sudo nohup $DT_DIR/installer/reconfigure.sh --only els --premium-ha on &

 Step 6: Installation in Datacenter 2 (DC2)

Copy the installer setup to all DC2 nodes. This can be done by navigating to the CMC, selecting 'Deployment status', then 'Add cluster node', and using the provided wget command to download the installer on each DC2 node.

Before proceeding, set the datacenter name for DC2. Run the following command from the DC1 SEED node, ensuring variables $DC2_NAME and $NODES_IPS are correctly set as per step 3:

curl -ikS -X POST -d "{\"newDatacenterName\" : \"$DC2_NAME\", \"nodesIp\" :$NODES_IPS}" https://$SEED_IP/api/v1.0/onpremise/multiDc/migration/datacenterTopology?Api-Token=$API_TOKEN -H "accept: application/json" -H "Content-Type: application/json"

The command output will confirm the operation's success.

chiranjitdutta_20-1766398192804.png

Step 7: Firewall Rule Configuration for DC2

Open the required firewall rules for DC2 nodes by executing the following command from the DC1 seed node:

curl -ikS -X POST -d "$NODES_IPS" https://$SEED_IP/api/v1.0/onpremise/multiDc/migration/clusterNodes/currentDc?Api-Token=$API_TOKEN -H "accept: application/json" -H "Content-Type: application/json"

chiranjitdutta_21-1766398279136.png

Take note of the REQUEST ID generated by the above command, as it will be required in subsequent steps. Set this as an environment variable on the SEED node:

export REQ_ID=<Generated REQUEST ID>

Verify that the firewall rule has been applied; the status should be 200

 chiranjitdutta_22-1766398279136.png

Step 8: Sequential Installation of DC2 Nodes

Install the DC2 nodes one at a time—don't perform installations in parallel. Wait a few minutes after each node installation before proceeding to the next. Use the following command on each DC2 node:

sudo /bin/sh ./managed-installer.sh --install-new-dc --premium-ha on --datacenter $DC2_NAME --seed-auth $API_TOKEN

 After installing all DC2 nodes, check the nodekeeper status for DC2 by executing the following command from the Seed Node in DC1:

curl -ikS https://$SEED_IP/api/v1.0/onpremise/multiDc/migration/nodekeeper/healthCheck?Api-Token=$API_TOKEN -H "accept: application/json" -H "Content-Type: application/json"

 chiranjitdutta_23-1766398310766.png

Step 9: Cassandra Replication

Initiate Cassandra replication from DC1 to DC2 by running the following command from the DC1 seed node. The response should include a status of 200 and will generate a Request ID, which should be set as an environment variable on the SEED node.

curl -ikS -X POST https://$SEED_IP/api/v1.0/onpremise/multiDc/migration/cassandra/currentDc?Api-Token=$API_TOKEN -H "accept: application/json" -H "Content-Type: application/json"

 chiranjitdutta_24-1766398364532.png

Check the replication status from the DC1 Seed Node; the status should show as 200

chiranjitdutta_25-1766398390463.png

To initiate replication with DC2, use the command below from the SEED node. Set the new Request ID as an environment variable and check the replication status for DC2, ensuring a 200 response

curl -ikS -X POST https://$SEED_IP/api/v1.0/onpremise/multiDc/migration/cassandra/newDc?Api-Token=$API_TOKEN -H "accept: application/json" -H "Content-Type: application/json”

 chiranjitdutta_26-1766398409098.png

Check the Replication status from the Seed node for DC2; this should be 200 status.

curl -ikS -X GET https://$SEED_IP/api/v1.0/onpremise/multiDc/migration/cassandra/newDc/$REQ_ID?Api-Token=$API_TOKEN -H  "accept: application/json" -H  "Content-Type: application/json"

 chiranjitdutta_27-1766398443438.png

Step 10: Cassandra Rebuild in DC2

Rebuild Cassandra on the DC2 node by executing the following command from the SEED node. This rebuild might take a few minutes to hours, depending on the database size

curl -ikS -X POST https://$SEED_IP/api/v1.0/onpremise/multiDc/migration/cassandra/rebuild?Api-Token=$API_TOKEN -H "accept: application/json" -H "Content-Type: application/json"

 chiranjitdutta_28-1766398505370.png

Monitor the rebuild process using. The rebuild is complete when the response contains "error:false".

If "error:true" appears, consult Dynatrace support.

curl -ikS -X GET https://$SEED_IP/api/v1.0/onpremise/multiDc/migration/cassandra/rebuild?Api-Token=$API_TOKEN -H "accept: application/json" -H "Content-Type: application/json"

 chiranjitdutta_29-1766398505373.png

Step 11: Elasticsearch Replication

Start Elasticsearch replication in DC2 nodes by running the following command from the SEED node. This will generate a REQUEST ID to be set as an environment variable

curl -ikS -X POST https://$SEED_IP/api/v1.0/onpremise/multiDc/migration/elasticsearch?Api-Token=$API_TOKEN -H "accept: application/json" -H "Content-Type: application/json"

 chiranjitdutta_30-1766398539498.png

To monitor progress, run The replication should show 200 status and the response should look like the screenshot below

curl -ikS -X GET https://$SEED_IP/api/v1.0/onpremise/multiDc/migration/elasticsearch/$REQ_ID?Api-Token=$API_TOKEN -H "accept: application/json" -H "Content-Type: application/json"

 chiranjitdutta_31-1766398539500.png

To further verify data replication, execute it. It should return a 200 status and a message as "Elasticsearch Migration is finished..."

curl -ikS -X GET https://$SEED_IP/api/v1.0/onpremise/multiDc/migration/elasticsearch/indexMigrationStatus?Api-Token=$API_TOKEN -H "accept: application/json" -H "Content-Type: application/json”

 chiranjitdutta_32-1766398539488.png

Step 12: Server Migration and Service Startup in DC2

Begin the server migration by starting OneAgent and NGINX on the DC2 nodes. Run the following command from the SEED node to start the migration and generate a REQUEST ID, which must be set as an environment variable to verify cluster readiness:

curl -ikS -X POST https://$SEED_IP/api/v1.0/onpremise/multiDc/migration/server?Api-Token=$API_TOKEN -H "accept: application/json" -H "Content-Type: application/json"

 chiranjitdutta_33-1766398598789.png

To check cluster readiness, execute the command below. This will take some time to show 200 as it is starting the services in the DC2 nodes

curl -ikS -X GET https://$SEED_IP/api/v1.0/onpremise/multiDc/migration/server/$REQ_ID?Api-Token=$API_TOKEN -H "accept: application/json" -H "Content-Type: application/json”

 chiranjitdutta_34-1766398598774.png

Step 13: Nodekeeper Migration

Finally, migrate nodekeeper by executing the following command from the DC1 Seed node.

curl -ikS -X POST https://$SEED_IP/api/v1.0/onpremise/multiDc/migration/nodekeeper/currentDc?Api-Token=$API_TOKEN -H "accept: application/json" -H "Content-Type: application/json”

 chiranjitdutta_35-1766398632301.png

Check the migration status using. Allow some time for the status to update to 200, confirming successful migration

curl -ikS -X GET https://$SEED_IP/api/v1.0/onpremise/multiDc/migration/nodekeeper/currentDc/status?Api-Token=$API_TOKEN -H "accept: application/json" -H "Content-Type: application/json”

 chiranjitdutta_36-1766398632299.png

 

chiranjitdutta_37-1766398632303.png

 

Note: All this activity needs a stable connection. If ports are not opened correctly, the setup will fail in the middle, and you may need to start again or rebuild the datacenter.

 

What's next

If this article did not help, please open a support ticket, mention that this article was used, and provide the following:

  • a link to the Managed Cluster (CMC -> Licensing)
  • a screenshot of the error that you see during deployment
  • Managed Cluster logs (here)


What to read next

HannahM_0-1768410179389.pngPremium High Availability

HannahM_1-1768410196025.pngManaged Network Ports

HannahM_2-1768410197555.pngManaged hardware requirements

HannahM_3-1768410198278.pngSet up a cluster

HannahM_4-1768410199151.pngCluster node ports

HannahM_5-1768410199954.pngEnable or disable SELinux

Version history
Last update:
‎15 Jan 2026 09:01 AM
Updated by:
Dynatrace Guide