Overview of the system

– The vertical side sub-menu shows 3 items:
1.  Clusters – this area is where you go to access relevant to your clusters – backup/restore, monitoring, etc.
2.  Data – this is the tab to select when you want to import data or access your data via CQL shell.
3.  Access – this area is for account and user access functions.

help overview

– The top menu provides top-level links to pages you may need.  Contact, your account, and the home page for example.
– The horizontal sub-menu changes based on your vertical sub-menu selections.  This area houses further information about your clusters, data, or access management based on the area you have currently selected

Get Started

– click “get started” to create a cluster

help overview

Customer and Cluster Page

– You have a choice within the DataScale system – you can utilize your own AWS account, or you can create your cluster within ours and be billed from a single source.
– If you want to utilize your own AWS account, click on “Click here to add AWS account details”.  (Further help can be found under #4 AWS Account)

customer and cluster creation
A: Select a region is where you select the datacenter you’d like as your primary DC for your account

database region
B: Enter a Name for your cluster.  This must be a unique name not already utilized within our system

cluster name
C: Select a day and time for your preferred maintenance window

maintenance day

maintenance time
D: Select Cassandra version.  DataScale supports multiple versions of Apache Cassandra and DataStax Enterprise, please select the version you prefer to utilize.

cassandra version
E: Select Instance Type.  You can choose from Small, Medium, Large, or Sandbox instances.

instance types
F:  Select either number of nodes, or usable storage size required.  This selection will dynamically update storage, number of nodes, and Cluster Cost, CPU and RAM based on your selections.

number of nodes

storage capacity
G: Once all items are correct, select “Next” to go to billing information

cluster setup review

AWS Account Info

– If you wish to utilize our system to manage a cluster within your own VPC, you can set that connection here
– Enter AWS account info
– Enter AWS cloud API key
– Enter AWS cloud API secret
– Click “Update AWS Info” and our system will securely connect with your cluster

 

aws account information

Billing Information

– Your total monthly cost for your current configuration will be displayed at the top of the screen
– enter credit card number, CVC, and expiration dates

billing information
– You cannot continue from this page/add your card without accepting the DataScale terms of service and agreeing to pay for all accrued charges.  You may read the terms of service by clicking on the link.  If and when you agree, tick the box to indicate agreement.

accept terms of service
– Click “Add card & create cluster” to instigate the creation of your cluster

Cluster Creation

– Cluster creation requires both account setup on AWS as well as creation of the actual cluster.  You will see the two-part process occur.  First the cloud account is setup
– Once your cloud account is complete, the cluster will be set up

creating customer

creating cluster

Cluster information

– Opens the cluster operations along the horizontal sub-menu
– IPs, Credentials, .yaml file and general information is displayed

cluster overview

Clone

– If you want to clone your cluster, you can simply and easily do so under this tab
– Name your cluster
– Choose an instance type (Sandbox, Small, Medium, Large).  **Note: You must select instance types that are at least as large as your source instances
– Click “Clone Cluster” and the process will complete automatically

clone a cluster

Backup/Restore

– Click “Backup” to create a new backup of your cluster.
– If you have multiple backups, you can utilize the dropdown menu to select the backup from which you wish to restore.

backup and restore

Logs

–  The first time you utilize the log feature, you have to set up Kibana.

kibana needs to be set up
–  Click under “Time-field name” and select @timestamp

kibana add timestamp
–  You will then be brought to the “Discover” portion of Kibana.

kibana discover segment
–  For more help on Kibana, please see Kibana Help Here

Health

– The health tab will display DataDog’s “glance” feature by default.

health
–  For help with DataDog, please reference DataDog Help Here

Destroy a Cluster

– To destroy a cluster you must enter the cluster name and confirm with your password to prevent accidental destruction.

destroy a cluster

cluster destruction in progress

cloud teardown in progress
– Please Note: If this is your only active cluster, the system will automatically tear down your cloud setup (including logger node) immediately following cluster destruction.  Creating a new cluster will re-initialize your customer cloud setup.

CQL Shell

– CQL shell allows you to interact directly with your cluster via CQL
– Click on the CQL Shell submenu and the system will automatically connect to your cluster

cql shell

Import Data

– Currently the import data option on allows a sample import of twitter data for testing purposes
– To import this test data, click “Start Import”

import data
–  You will be prompted to enter your Twitter credentials, then the system will finish the import.

sample data

User Access

– If you wish to add users to your cluster, click “Add New User”

add new user
– Fill out the information and choose Regular or Privileged User Role

user roles
– Regular users can access the cluster, but cannot access admin functions (add users, billing)
– Privileged users can access the cluster as well as admin functions.

My Account

– My account allows you to modify your account information including phone number, password, etc.
– Access Token.  If you wish to regenerate your access token, click “Regenerate Token” to do so.
– 2-Factor Authentication.  If you wish to enable 2FA, you can do so by clicking “Enable” and following the prompts.

account modifications

Billing Details

– View your current monthly usage and billing details
– Update your payment card details by entering the required information in the fields and clicking “Update Card Details”

billing details modification