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>


Build and scale cloud native apps

Discover the benefits of DBaaS and why your apps deserve an upgrade.

Learn about NoSQL Databases

Learn about NoSQL databases with Apache Cassandra and Astra DB.

2022 Recap: A Year for Customers, Community, and Real-Time Data

Highlights from 2022 and a glimpse into the year ahead.

ViewingCompany

CCM 2.0 — DataStax Enterprise Support

Sign up for our Developer Newsletter