Nikhil Karnik

David Marx

DataStax powers the Right-Now Enterprise with the always-on, distributed cloud database built on Apache Cassandra™ and designed for hybrid cloud. So let's get started.

There are several options to install DSE which are <a href="https://docs.datastax.com/en/install/6.7/install/installTOC.html">documented here</a>. In this tutorial, I will use the Lifecycle Manager (LCM) which allows you to easily provision, configure, and install DataStax Enterprise clusters.

<img alt="Deployment Architecture" data-entity-type="file" data-entity-uuid="49f75e48-b622-4be6-8893-2d288b1b388c" src="https://www.datastax.com/sites/default/files/inline-images/image2.png" />

In this tutorial for simple functional testing, I have used t2.medium instance type on AWS which is sufficient.

Here are some guidelines to consider as you plan your Enterprise implementation <a href="https://docs.datastax.com/en/dse-planning/doc/planning/planningHardware.html">https://docs.datastax.com/en/dse-planning/doc/planning/planningHardware.html</a>

<h2>1.) Provision your Virtual Machine on AWS</h2>

&nbsp; &nbsp; &nbsp; &nbsp;a.) Configure Security Rules

&nbsp;

Navigate on AWS to Services → Compute →(Click on) EC2

On the left-hand side, you will see Network and Security →Security Groups →(Click on) Create Security Group

I have created a new security group as highlighted below. Note the name of this security group “sg-00365e9a79b7a4f3a”. It will be used as we add the inbound rules for internode communication.

<img alt="Internode Communication" data-entity-type="file" data-entity-uuid="c4b2c02d-089b-455b-8730-e409016c89b2" src="https://www.datastax.com/sites/default/files/inline-images/image15.png" />

Edit the Inbound Security rules to look like below.

<a href="https://docs.datastax.com/en/dse/6.7/dse-admin/datastax_enterprise/security/secFirewallPorts.html">Reference</a>

<img alt="Inbound Security Rules" data-entity-type="file" data-entity-uuid="e5198914-9ac7-4cd9-b4e9-a9dcd6210cb2" src="https://www.datastax.com/sites/default/files/inline-images/image19.png" />

&nbsp;

<img alt="Edit Inbound Rules" data-entity-type="file" data-entity-uuid="80eda8e5-1e1e-4e61-99b5-eab6ca52def7" src="https://www.datastax.com/sites/default/files/inline-images/image14.png" />

You don’t need to make any changes to the Outbound Rule.

&nbsp; &nbsp; &nbsp; &nbsp;b.) Create Virtual Machine on EC2

We will create 4 VM’s. One for OpsCenter and 3 for the distributed database Nodes

So navigate to Service → Compute → EC2 → Launch Instance → Search for “Ubuntu Server 16.04 LTS (HVM), SSD Volume Type”

<img alt="Choose AMI" data-entity-type="file" data-entity-uuid="b11327a6-8943-416e-bdd9-359bac2e4c17" src="https://www.datastax.com/sites/default/files/inline-images/image21.png" />

Change Instance Type to T2.Medium

<img alt="Choose an Instance Type" data-entity-type="file" data-entity-uuid="36c9be4d-af48-487c-8fe3-08ecb8cb8a0a" src="https://www.datastax.com/sites/default/files/inline-images/image23.png" />

Click: Next Configure Instance Details and change Number of instances to 4

<img alt="Configure Instance Details" data-entity-type="file" data-entity-uuid="16e75f91-d69e-4ceb-8b45-d3ed80c2e1f8" src="https://www.datastax.com/sites/default/files/inline-images/image17.png" />

You can keep the storage default, which is 8GB, for this initial functional test. (You will need to consider adding additional storage “as needed” for your test case). Click on Add Tags.

Click on Next: Configure Security Group.

Use the existing security group which we created before.

<img alt="Configure Security Group" data-entity-type="file" data-entity-uuid="fd20a58d-2b42-4342-aecc-2807296ac0f6" src="https://www.datastax.com/sites/default/files/inline-images/image27.png" />

Click Review and Launch. It will also ask you to create a new SSH key. Make sure to save it. Now you would have 4 VM’s ready.

<img alt="Launch Instance" data-entity-type="file" data-entity-uuid="161a78a9-258c-44a4-b763-1c61a6180aee" src="https://www.datastax.com/sites/default/files/inline-images/image11.png" />

Note: In AWS the IP address changes once you bounce the VM. So navigate to Network &amp; Security → Elastic IPs. Allocate 4 IP’s and associate them to the VM’s. This way we can preserve the IP address even if the VM’s gets rebooted.

<img alt="Allocate New Address" data-entity-type="file" data-entity-uuid="16f16a4b-e61a-457e-983c-02aff9a8ba0e" src="https://www.datastax.com/sites/default/files/inline-images/image20.png" />

<h2>2.) Install OpsCenter (Visual Management and Monitoring)</h2>

&nbsp; a.) Login to the OpsCenter Server on AWS

<code>ssh -i ".pem" ubuntu@</code>

&nbsp; &nbsp; &nbsp; &nbsp;b.) Install Python 2.7

<code>sudo apt update sudo apt install python2.7 python-pip python -V</code>

A successful python install should look

<img alt="Python Install" data-entity-type="file" data-entity-uuid="c2597c42-b9db-47d7-9f03-c09a0b66bc45" src="https://www.datastax.com/sites/default/files/inline-images/image1.png" />

&nbsp; &nbsp; &nbsp; &nbsp;c.) Install Java 1.8

<code>sudo apt-get update sudo apt-get install openjdk-8-jdk java -version</code>

<img alt="Java Version" data-entity-type="file" data-entity-uuid="27dd732a-604e-4048-99c7-ac18b01ea46e" src="https://www.datastax.com/sites/default/files/inline-images/image4.png" />

&nbsp; &nbsp; &nbsp; &nbsp;d.) Install OpsCenter

Add the datastax Repository File and a Key

<code>echo "deb https://DSA_email_address:downloads_key@debian.datastax.com/enterprise stable main" | sudo tee -a /etc/apt/sources.list.d/datastax.sources.list curl -L https://debian.datastax.com/debian/repo_key | sudo apt-key add - sudo apt-get update</code>

You can generate your " downloads_key " from <a href="https://academy.datastax.com/downloads">https://academy.datastax.com/downloads</a>

<img alt="Downloads Key" data-entity-type="file" data-entity-uuid="2bc0b517-1f35-49a5-a000-c8bb4a9c75b2" src="https://www.datastax.com/sites/default/files/inline-images/image10.png" />

<code>sudo apt-get install libaio1 sudo apt-get install opscenter=6.7.0 sudo service opscenterd start ps -ef|grep opscenter</code>

A successful startup of OpsCenter will show you a background process as below.

<img alt="OpsCenter" data-entity-type="file" data-entity-uuid="d464c9a1-557b-4ecd-83af-359f15aceb6f" src="https://www.datastax.com/sites/default/files/inline-images/image3.png" />

OpsCenter runs on Port 8888.

Lets validate using and access it using

http://:8888/

<img alt="DataStax OpsCenter" data-entity-type="file" data-entity-uuid="e12b2e5c-6231-4a53-b8bb-d54fb1235b12" src="https://www.datastax.com/sites/default/files/inline-images/image12.png" />

<h2>3.) Deploy a 3 node cluster using LCM (OpsCenter Life Cycle Management)</h2>

Access the OpsCenter as seen in the previous steps, select “create a new cluster” and click Get Started.

<img alt="Lifecycle Manager" data-entity-type="file" data-entity-uuid="d5fa7330-aba9-485b-8886-ba1aebe0e39f" src="https://www.datastax.com/sites/default/files/inline-images/image7.png" />

1. Add SSH Credential

OpsCenter LCM will use this key to access the VM’s created on AWS to deploy the cluster.

Enter Login User Name as: ubuntu

Copy paste the Private Key used to create the VM’s on AWS.

And Save.

<img alt="Add Credential" data-entity-type="file" data-entity-uuid="6139cac1-02ea-41e5-a639-edc791e6ec48" src="https://www.datastax.com/sites/default/files/inline-images/image9.png" />

&nbsp;

2. Add Config Profile

The config profile will deploy the version of DSE you wish to install. I have selected the latest version which is 6.7.2 from the drop-down box. And click Save.

<img alt="Config Profiles" data-entity-type="file" data-entity-uuid="1250b6cd-1511-4abd-b17b-ae6489eaffef" src="https://www.datastax.com/sites/default/files/inline-images/image6.png" />

3. Add Repository

OpsCenter LCM will connect to the repository and download the software.

<img alt="Repositories" data-entity-type="file" data-entity-uuid="a867c9f5-9e0f-41a3-8808-54ceebd11878" src="https://www.datastax.com/sites/default/files/inline-images/image8.png" />

4. Add a Cluster

Let's name the cluster.

Select ssh credentials

Select the repository

Select the config profile

Enter the OLD password as cassandra

Enter the new password as per your password policy

Click Save.

<img alt="Clusters" data-entity-type="file" data-entity-uuid="516d9ec0-5727-4b94-a38d-ac8a2cc9c9fe" src="https://www.datastax.com/sites/default/files/inline-images/image24.png" />

Click on the Cluster and a Datacenter tab will show up. Click the + sign on the datacenter tab and enter the below details.

Name for the DataCenter: DC1

Select the config profile from the drop-down box.

Select the ssh credentials.

Select the workload. In this example, I have selected a Cassandra WorkLoad.

<img alt="Cassandra Workload" data-entity-type="file" data-entity-uuid="b180f01a-8d62-474b-b332-a422b98c33bf" src="https://www.datastax.com/sites/default/files/inline-images/image22.png" />

Add the Nodes

Click on the + sign next to the nodes tab.

<img alt="Nodes" data-entity-type="file" data-entity-uuid="aa7a70ef-36c6-4b68-8249-833ebd44e96c" src="https://www.datastax.com/sites/default/files/inline-images/image5.png" />

Enter node name as N1

Enter Rack as Rack1

Enter the Private IP address of the VM that we created. Remember we

Select the ssh credentials and config profile from the drop-down box.

Click Save

<img alt="Add Node" data-entity-type="file" data-entity-uuid="abb48f8a-680d-47f5-9c69-903e06b10110" src="https://www.datastax.com/sites/default/files/inline-images/image25.png" />

Similarly, Add the other two nodes N2 &amp; N3 as seen below.<img alt="Add Nodes" data-entity-type="file" data-entity-uuid="87a41967-61bf-470e-91a5-4eab1faf70cf" src="https://www.datastax.com/sites/default/files/inline-images/image18.png" />

Click on the 3 dots you see next to the DEV in the Clusters Tab and click on install.

<img alt="Clusters Tab" data-entity-type="file" data-entity-uuid="291ddebe-26d1-4462-bfd2-1cb7472bd49b" src="https://www.datastax.com/sites/default/files/inline-images/image13.png" />

Keep the defaults and click Submit.

<img alt="Run Installation Job" data-entity-type="file" data-entity-uuid="b314e2c8-8d04-4e09-9cc3-8c52fe08c1ae" src="https://www.datastax.com/sites/default/files/inline-images/image16.png" />

In the next couple of minutes, OpsCenter LCM will download and install the software on all the 3 nodes and create a one single DSE Cluster ready to use.

As successful install would look like this.

<img alt="Lifecycle Manager" data-entity-type="file" data-entity-uuid="4ea5a336-bcd1-4b9c-943e-e79bf0ac04b7" src="https://www.datastax.com/sites/default/files/inline-images/image26.png" />

Click on OpsCenter URL to monitor and manage your cluster.

<img alt="OpsCenter" data-entity-type="file" data-entity-uuid="874794e0-5865-422e-954e-1e1a4cafceb2" src="https://www.datastax.com/sites/default/files/inline-images/image28.png" />

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.

ViewingTechnical How To’s

Hands-on Tutorial to Install DataStax Enterprise on AWS Cloud in 3 Easy Steps

Sign up for our Developer Newsletter