Skip to content

Commit 73ee408

Browse files
authored
Merge pull request #192919 from TheovanKraay/patch-6
changes to hybrid guidance for migration scenarios
2 parents c4dd164 + dae1817 commit 73ee408

File tree

1 file changed

+6
-0
lines changed

1 file changed

+6
-0
lines changed

articles/managed-instance-apache-cassandra/configure-hybrid-cluster.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -192,6 +192,9 @@ This quickstart demonstrates how to use the Azure CLI commands to configure a hy
192192
> [!NOTE]
193193
> If you want to add more datacenters, you can repeat the above steps, but you only need the seed nodes.
194194
195+
> [!IMPORTANT]
196+
> If your existing Apache Cassandra cluster only has a single data center, and this is the first time a data center is being added, ensure that the `endpoint_snitch` parameter in `cassandra.yaml` is set to `GossipingPropertyFileSnitch`.
197+
195198
1. Finally, use the following CQL query to update the replication strategy in each keyspace to include all datacenters across the cluster:
196199

197200
```bash
@@ -203,6 +206,9 @@ This quickstart demonstrates how to use the Azure CLI commands to configure a hy
203206
```bash
204207
ALTER KEYSPACE "system_auth" WITH REPLICATION = {'class': 'NetworkTopologyStrategy', 'on-premise-dc': 3, 'managed-instance-dc': 3}
205208
```
209+
210+
> [!IMPORTANT]
211+
> If you are using hybrid cluster as a method of migrating historic data into the new Azure Managed Instance Cassandra data centers, ensure that you run `nodetool repair --full` on all the nodes in your existing cluster's data center. You should run this only after all of the above steps have been taken. This should ensure that all historical data is replicated to your new data centers in Azure Managed Instance for Apache Cassandra. If you have a very large amount of data in your existing cluster, it may be necessary to run the repairs at the keyspace or even table level - see [here](https://cassandra.apache.org/doc/latest/cassandra/operating/repair.html) for more details on running repairs in Cassandra. Prior to changing the replication settings, you should also make sure that any application code that connects to your existing Cassandra cluster is using LOCAL_QUORUM. You should leave it at this setting during the migration (it can be switched back afterwards if required).
206212
207213
## Troubleshooting
208214

0 commit comments

Comments
 (0)