Creating a Cadence cluster

Getting started

A Cadence cluster requires an Apache Cassandra® cluster to connect to for its persistence layer.

You can either connect to an Instaclustr managed Apache Cassandra® cluster or an externally created cluster. Our recommendation is that you use the Instaclustr managed Cassandra option as we have automated numerous steps in that process to make the linking to Cadence streamlined. Information on which steps have been automated is provided in the next section.

If you already have an external Cassandra cluster, or would like to use the Advanced Visibility feature in Cadence, read this article on using non-instaclustr resources for more information.

Instaclustr managed clusters

In this section, we will walk through creating a Cassandra cluster and a Cadence cluster, and linking them together.

When you use the Instaclustr platform in this way, the following operations are handled automatically for you:

  1. Firewall rules will automatically get configured on the Cassandra cluster for Cadence nodes.
  2. Authentication between Cadence and Cassandra will get configured, including client encryption settings.
  3. The Cadence default & visibility keyspaces will be created automatically in Cassandra.
  4. A link will be created between the two clusters, ensuring you don’t accidentally delete the Cassandra cluster before Cadence.

Step 1 – Create an Apache Cassandra® cluster

For a step by step guide of creating an Apache Cassandra® cluster, you can read this guide.

For an abbreviated guide, you can do as follows:

  1. Log into the Instaclustr Console and click the Create Cluster button. This will take you to the wizard for creating a new cluster.

  2. Give your cluster a name, select Apache Cassandra as the application, select your desired Cloud Service Provider and click Next.

  3. Under the Cassandra Setup page, select Apache Cassandra version 3.11.8.2.
    • Note: Instaclustr Managed Cadence does not currently support Cassandra 4.x due to some compatibility issues. We are working on a solution.
  4. Under the Data Centre options, select: 
    • Data Centre Region, 
    • Cluster Network address block, 
    • The number of nodes for your application, 
    • Your desired node size.
    • Note : Free trial users should use the defaults (i.e. 3 developer sized nodes).

  5. The Confirmation section displays a brief summary of your cluster configurations and pricing details.
    If you are happy with the cluster configuration and have accepted the terms and conditions, click the Create Cluster button to start provisioning the cluster.

  6. Provisioning a cluster can take some time depending on the responsiveness of the underlying cloud provider. There are separate status indicators for the overall cluster provisioning state.

  7. You have now finished creating your Cassandra cluster, congratulations! All your clusters will be listed on the left sidebar of the console. You can view your cluster’s configuration details by navigating to the Details page.

Step 2 – Create a Cadence cluster

Now that we have a running Cassandra cluster, we can create a Cadence cluster and link them together:

  1. On the console, click the Create Cluster button again, this time we will select the Cadence application.

  2. On the Cadence Setup page, we can select the version of Cadence. We are currently only offering Cadence 0.22.4.
    We can also choose to configure our cluster with Advanced Visibility. This will require an additional Apache Kafka® and OpenSearch / Elasticsearch cluster before we can get started. For this exercise, we will leave that option disabled.

  3. On the Cadence Dependency Setup page we can now select our previously created Cassandra cluster as the Cadence persistence store.
    If there are multiple Cassandra clusters running in your account, you can use the drop down to select the one you want to use with Cadence.

    In addition to selecting which Cassandra cluster to link to, we can select how they are linked and communicate over the network:

    • Separate VPC (default) – Instaclustr will create the Cadence and Cassandra clusters in separate virtual networks and they will communicate over public IP addresses.
    • VPC Peering – Instaclustr will create the Cadence and Cassandra clusters in separate virtual networks and those two networks will be peered together.

      • This configuration is most applicable if your Cassandra cluster is set to Private RPC Broadcast or Private Network Cluster where client-server communication is over private ip addresses.
      • This method is only available on AWS right now. Other cloud providers will be getting this functionality in near future.
    • Cassandra VPC – Instaclustr will provision the Cadence cluster into the same virtual network as the Cassandra cluster.
      • This configuration can be useful if you need to minimise cross-vpc data transfer costs.
  4. Under the Data Centre section, 
    • Select a Data Centre Region,
    • A cluster network address block (Note : Provide a non-overlapping CIDR block for VPC Peering and Cassandra VPC option),
    • The number of nodes for your application,
    • The desired node size.

  5. The Confirmation section displays a brief summary of your cluster configurations and pricing details.
    If you are happy with the cluster configuration and have accepted the terms and conditions, click the Create Cluster button to start provisioning the cluster.

  6. Just as with the Cassandra cluster, provisioning a cluster can take some time depending on the responsiveness of the underlying cloud provider. There are a few additional automated steps required to link these clusters that take place at this time.
  7. You have now finished creating your Cadence cluster! Now you can focus on creating incredible workflows and leave the cluster operations to us.
    You can view your cluster’s configuration details by navigating to the Details page, and the Connection Info page will help you get started, or navigate to the Cadence Web to start exploring the Cadence Workflow UI.

Please contact [email protected] if you have any questions.

By Instaclustr Support
Need Support?
Experiencing difficulties on the website or console?
Already have an account?
Need help with your cluster?
Contact Support
Why sign up?
To experience the ease of creating and managing clusters via the Instaclustr Console
Spin up a cluster in minutes