Disable cross-cluster replication in Aiven for Apache Cassandra® beta#

This article provides you with instructions on how to discontinue the cross-cluster replication (CCR) for your Aiven for Apache Cassandra® service.

About disabling CCR#

When you enable CCR for your service, you connect it to another service, which results in creating a CCR pair of services. You can disable CCR for your service either by splitting the services constituting the CCR pair or by deleting one of them.

It’s recommended to use the Aiven console for disabling CCR.

Warning

As soon as you split the cluster, the two services constituting the CCR pair become independent. It’s not possible to recreate the CCR pair connecting back to the same service. To enable CCR on your service again, you can create a new service and CCR-connect it to your existing service.

Prerequisites#

  • Aiven account

  • Depending on the method you choose to use for disabling CCR

  • CCR enabled on a pair of Aiven for Apache Cassandra services

Disable CCR in the console#

In the console, use either of the two following methods to disable CCR on your service(s): split the services or delete one of them.

Split the services#

  1. Log in to the Aiven console.

  2. From the Current services view, select the service for which you’d like to disable CCR.

  3. In the Overview tab of the service’s page, navigate to Cross Cluster Replication and select Split cluster.

  4. In the Warning popup, get familiar with the consequences of splitting the cluster, make sure you understand the impact, and select Split cluster.

Result

You service no longer replicates to the other service since the services have been disconnected.

Delete a service#

To disable CCR on your service, delete the service that is connected to your services for CCR purposes.

  1. Log in to the Aiven console.

  2. From the Current services view, select an Aiven for Apache Cassandra service on which you’d like to enable CCR.

  3. In the Overview tab of the service’s page, navigate to the Cross Cluster Replication section and select the name of the service provided in the CCR description, which is supposed to take you to the service’s page.

  4. In the Overview tab of the service, select Delete service from the top right corner.

    Warning

    As soon as you delete the service where your data has been replicated, CCR gets disabled and your data is no longer replicated between regions.

  5. When in the Delete confirmation popup, make sure you understand the impact, copy-paste the service name, and select Delete.

Result

You’ve disabled CCR on your service by deleting one of the peer services in the CCR service pair.

Disable CCR with CLI#

You can disable CCR for your Aiven for Apache Cassandra service using the Aiven CLI to delete one of the services constituting the CCR pair.

Tip

Check out how to get started with the Aiven CLI in Aiven CLI.

Use the avn service terminate command to disable CCR on your service by deleting the service used as a sink for your replicated data.

avn service terminate ccr_peer_service_name

Disable CCR with API#

You can disable CCR for your Aiven for Apache Cassandra service(s) by calling the ServiceDelete endpoint to delete one of the services that constitute the CCR pair.

Note

In this instruction, the curl command line tool is used to interact with Aiven APIs.

Tip

Check out how to get started with Aiven APIs in Aiven API.

To call the ServiceDelete endpoint, specify the project name and the service name as path parameters and provide your token as a header in the request.

curl --request DELETE \
   --url https://api.aiven.io/v1/project/PROJECT_NAME/service/SERVICE_NAME \
   --header 'Authorization: Bearer YOUR_TOKEN'

More on Apache Cassandra CCR#

More on CCR with Aiven#