Cassandra Launcher (and Cluster Launcher)
This project has two offerings. They are:
- Cassandra Launcher - An easy to use, interactive command line interface that allows you to deterministically launch a DataStax Community or DataStax Enterprise cluster in under a minute. This component also comes with a fully scriptable interface for cluster launches straight from the command line.
- Cluster Launcher - A great tool that combines both Amazon's EC2 and Rackspace's Cloudservers into a single tool that allows for deterministicly easy clustering, keyless ssh, and interactive prompts for choosing your environment. No longer must you search for images IDs or wait past page reloads for a cluster since this is all done on the client side.
python-pip are installed, then run:
pip install cassandralauncher
Start the program once to copy the default
Exit the program and edit
~/.clusterlauncher.conf with your appropriate authentication parameters.
EC2/RAX Plain Cluster Launcher
- Select Cluster, Confirm.
- Select EC2 or RAX, Destroy, Cluster, Confirm.
THIS MUST BE DONE! IF NOT YOUR AWS ACCOUNT WILL GET A HUGE BILL. TAKE IT FROM ME!
Disclaimer: Even though these tools try their best to keep track of launched clusters, it is always best to ensure that all clusters are terminated periodically. This is especially true in cases where AWS/RAX was unable to tag the machine as they were launched. If the tools were unable to tag said machines, they will forever ignore them since we would rather not even present the option to kill a cluster these tools did not launch.
Sample Run for Cassandra Launcher
Welcome to DataStax' Cassandra Cluster Launcher! No existing clusters currently running! Cluster Name: Test Cluster Total Nodes: 4 Version:  Community  Enterprise 1 Username: riptano Password: Realtime Nodes: 2 CFS Replication Factor: 2 Starting an EC2 cluster of type m1.large with image ami-fd23ec94... Ensuring DataStax pem key exists on AWS... Ensuring DataStax pem key exists on filesystem... Ensuring DataStax pem key's permissions are acceptable... Configuring ports... Launching cluster... Waiting for cluster... Cluster booted successfully! Unprimed Connection Strings: ssh -i /Users/joaquin/DataStaxLauncher.pem firstname.lastname@example.org ssh -i /Users/joaquin/DataStaxLauncher.pem email@example.com ssh -i /Users/joaquin/DataStaxLauncher.pem firstname.lastname@example.org ssh -i /Users/joaquin/DataStaxLauncher.pem email@example.com OpsCenter Address: http://18.104.22.168:8888 Note: You must wait 60 seconds after Cassandra becomes active to access OpsCenter. Waiting 10 seconds for EC2 instances to warm up... Priming connections... The authenticity of host '22.214.171.124 (126.96.36.199)' can't be established. RSA key fingerprint is d5:c7:7c:39:a7:33:5a:5c:71:03:a4:68:2f:ba:b9:59. Are you sure you want to continue connecting (yes/no/all)? all Creating a keyless SSH ring... Waiting for the agent tarball to be created... Installing OpsCenter Agents... Primed Connection Strings: ssh -i /Users/joaquin/DataStaxLauncher.pem -o UserKnownHostsFile=/Users/joaquin/ds_known_hosts firstname.lastname@example.org ssh -i /Users/joaquin/DataStaxLauncher.pem -o UserKnownHostsFile=/Users/joaquin/ds_known_hosts email@example.com ssh -i /Users/joaquin/DataStaxLauncher.pem -o UserKnownHostsFile=/Users/joaquin/ds_known_hosts firstname.lastname@example.org ssh -i /Users/joaquin/DataStaxLauncher.pem -o UserKnownHostsFile=/Users/joaquin/ds_known_hosts email@example.com Choose the cluster to destroy:  None  jcasares - DataStaxAMI Time: 12-16-11 02:21 Size: 4 1 Confirm you wish to terminate jcasares - DataStaxAMI Time: 12-16-11 02:21 Size: 4 by pressing 'y'. y Termination command complete.
Sample Run for Cluster Launcher
host1:~ joaquin$ clusterlauncher Choose your Cloud Testing Host:  EC2  Rackspace 1 Choose your Cloud Command:  Create  Destroy 0 Choose your Cluster Size: 3 Choose your Testing Operating System:  CentOS  Debian  Fedora  Ubuntu 0 Choose your Operating System Version:  5.4  5.5  5.6 2 Starting a Rackspace cluster of flavor 4 with image 77... Configuring ports... Launching cluster... Waiting for cluster... Cluster booted successfully! Connection Strings: ssh firstname.lastname@example.org ssh email@example.com ssh firstname.lastname@example.org Private IPs: 10.183.0.156, 10.183.1.74, 10.183.2.204 Public IPs: 188.8.131.52, 184.108.40.206, 220.127.116.11 host1:~ joaquin$ clusterlauncher Choose your Cloud Testing Host:  EC2  Rackspace 1 Choose your Cloud Command:  Create  Destroy 1 Choose the cluster to destroy:  jcasares-CentOS-5.6-Size-3-Time-11-07-11-20.33  jcasares-CentOS-5.6-Size-3-Time-11-07-11-21.18 0 Confirm you wish to kill jcasares-CentOS-5.6-Size-3-Time-11-07-11-20.33 by pressing 'y'. y Termination command complete.
Programmatically Launching Cassandra Clusters
to display all options.
clusterlauncher does not have this functionality, but is easily scriptable at the Python level calling ec2.py or rax.py. See
clusterlauncher.py for how to do this.
My cluster is not done launching one (or several) of my nodes. What did I do wrong?
Nothing. EC2 does this from time to time. You can either continue on to do basic testing, or terminate this cluster and try again. Using EC2 off it's peak hours helps in this scenario.