Philip Thompson

<h2>Introduction</h2>

<p>The Cassandra Cluster Manager is a command line tool authored by Apache Cassandra™ committer and PMC member Sylvain Lebresne that sets up Cassandra clusters on localhost. I am currently a maintainer for CCM, adding features and fixing bugs as part of my job as a Test Engineer for Apache Cassandra. For an overview of CCM, please see&nbsp;<a href="https://www.datastax.com/dev/blog/ccm-a-development-tool-for-creating-local-cassandra-clusters">this blog post by Tyler Hobbs.</a>&nbsp;In this post, I'd like to bring you up to speed on the latest CCM improvements, particularly how you can now run a local DataStax Enterprise cluster from the comfort of your command prompt!</p>

<h2>CCM 2.0</h2>

<p>In late October, CCM 2.0 was released, adding support for DataStax Enterprise. It also added support for running on Windows with Cassandra 2.1. CCM is a python package which can be installed from PyPI with&nbsp;<code>pip install ccm</code>, or installed from&nbsp;<a href="https://github.com/pcmanus/ccm">source</a>. For setup, installation, and usage instructions, see the&nbsp;<a href="https://github.com/pcmanus/ccm/blob/master/README.md">README</a>.</p>

<h2>Using Apache Cassandra with CCM</h2>

<p dir="ltr">CCM lets you create Apache Cassandra clusters on localhost as a development tool. Setting up a three node cluster of the latest version is as easy as:</p>

<p><code>ccm create test_cluster -v 2.1.2</code><br />
<code>ccm populate -n 3</code><br />
<code>ccm start</code></p>

<p>which can be simplified to&nbsp;<code>ccm create test_cluster -v 2.1.2 -n 3 -s</code>.</p>

<p dir="ltr">From here you can run&nbsp;<code>ccm status</code>&nbsp;to confirm you have three Cassandra instances running on localhost. You can access your cluster with any DataStax driver, cqlsh, or nodetool. A cluster created with CCM provides all of the functionality of a real Apache Cassandra cluster. CCM also provides a convenient python API to use instead of the command line interface.</p>

<h2>Downloading DataStax Enterprise</h2>

<p dir="ltr">Downloading DSE via CCM requires a username and password, which you can get from https://www.datastax.com/download. When creating a dse cluster with an undownloaded version, you will need to include your username and password on the command line:</p>

<table border="0" cellpadding="0" cellspacing="0">
	<tbody>
		<tr>
			<td>
			<p><code>ccm create dse_cluster --dse --dse-username=user@example.com --dse-password=redacted -v 4.5.2</code></p>
			</td>
		</tr>
	</tbody>
</table>

<p dir="ltr">From then on, anytime you create a cluster using that version, you will not need to include your username and password. The downloaded version is stored alongside cassandra in ~/.ccm/repository/$VERSION</p>

<h2>Using DSE</h2>

<p dir="ltr">CCM is an excellent way to interact with DataStax Enterprise. You can set up an Analytics datacenter, a Cassandra datacenter, and a Solr datacenter, all on your laptop!</p>

<p dir="ltr">To use Datastax Enterprise instead of Apache Cassandra with CCM, clusters must be created with the --dse command line option,&nbsp;<code>ccm create dse_cluster --dse -v 4.5.2 -n 3 -s</code>. This will give you a fully featured DataStax Enterprise cluster with Solr and Hadoop integration. To set a node’s workload, use&nbsp;<code>ccm node1 setworkload [cassandra|solr|hadoop|spark]</code>.</p>

<p dir="ltr">A number of new node commands have been added to interact with nodes in DSE clusters. These commands allow you to use the DSE features that are unavailable when using Apache Cassandra.</p>

<p><code>ccm node1 [hive|spark|hadoop|pig|sqoop]</code></p>

<p dir="ltr">All of the normal CCM commands can be run against DSE clusters. Here is a code example on how to set up a three datacenter cluster with Cassandra, Solr, and Analytics:</p>

<p><code>ccm create dse_cluster --dse -v 4.5.2 -n 1:1:1</code><br />
<code>ccm node2 setworkload solr</code><br />
<code>ccm node3 setworkload spark</code><br />
<code>ccm start</code></p>

<h2>Conclusion</h2>

<p>CCM 2.0 provides an easy way for you to test and interact with a fully featured DataStax Enterprise cluster. When using DataStax Enterprise, please respect the terms of the license. Remember, CCM is explicitly not intended for production use or performance testing. If you have any issues, please report them&nbsp;<a href="https://github.com/pcmanus/ccm/issues/">on github</a>. Pull Requests are appreciated!</p>


CCM 2.0 — DataStax Enterprise Support

Philip Thompson

Share

More Company

DataStax Astra DB Nabs Three Prestigious 2023 TrustRadius “Best of” Awards, Dominates the Vector Databases Category

DataStax Has Achieved ISO 27001 Certification

Keeping the Momentum Rolling with Google Cloud

My Internship Journey: A Dive into AI

NoSQL and Vector DB
for Generative AI,
Instantly, At Scale

Philip Thompson

Share

More Company

DataStax Astra DB Nabs Three Prestigious 2023 TrustRadius “Best of” Awards, Dominates the Vector Databases Category

DataStax Has Achieved ISO 27001 Certification

Keeping the Momentum Rolling with Google Cloud

My Internship Journey: A Dive into AI

NoSQL and Vector DBfor Generative AI,Instantly, At Scale

NoSQL and Vector DB
for Generative AI,
Instantly, At Scale