Ansible provisioning/maintenance tasks for Cassandra. Can be used to install & manage upgrades for a DCE/DSE based Cassandra cluster, OpsCenter & Spark
Usage:
- Create the servers for Cassandra and Datastax OpsCenter
- Define an Ansible inventory (see inventory/example.hosts) for your environment
- Run the playbook to install Cassandra + Datastax OpsCenter
Inventory configuration:
| Inventory group | Variable | Options | Default | Description |
|---|---|---|---|---|
| cassandra_nodes | dc | DC1, DC2, ... | - | data center of node |
| cassandra_nodes | rack | RAC1, RAC2, ... | - | rack of node |
| cassandra_nodes | repair_weekday | MON,TUE,WED,THU,FRI,SAT,SUN | - | day(s) to run repair on node |
| cassandra_nodes | repair_start_hour | 00-23 | 03 | hour to start cron based repair |
| cassandra_nodes | repair_start_minute | 00-59 | 0 | minute to start cron based repair |
| cassandra_nodes | seed | true, false | - | is the node a seed |
| cassandra_nodes | node_ip | true, false | - | IP for internal cluster communications |
| cassandra_nodes | spark_enabled | true, false | false | enable Spark on node (DSE only) |
| cassandra_nodes | s3_backup_enabled | true, false | false | enable S3 backups |
| cassandra_nodes | s3_backup_environment | aws, riakcs | - | environment for S3 backups |
| cassandra_nodes | s3_backup_host | host | - | S3 host (for non-AWS) |
| cassandra_nodes | s3_backup_bucket | bucket | - | S3 bucket where to store backups |
| cassandra_nodes | s3_backup_keyspaces | keyspace,keyspace,... | - | Cassandra keyspaces to backup (comma separated) |
| cassandra_nodes | s3_backup_access_key | access_key | - | S3 access key |
| cassandra_nodes | s3_backup_secret_key | secret_key | - | S3 secret key |
| --- | --- | --- | --- | |
| opscenter_nodes | node_ip | true, false | - | IP for internal cluster communications |
| --- | --- | --- | --- | |
| all_cassandra_nodes | deployment_environment | aws, euca | - | environment for installation |
| all_cassandra_nodes | install_version | dce, dse | - | Cassandra to install (dce=Datastax Community Edition, dse=Datastax Enterprise Edition) |
| all_cassandra_nodes | dse_username | DSE username | - | DSE username (only for DSE install) |
| all_cassandra_nodes | dse_password | DSE password | - | DSE password (only for DSE install) |
Requirements:
- Ansible 2.0 or later
- Nodes running Ubuntu 14.04 or later
- Node have the following installed: git
Running:
- Check out main cassandra.yml comments for typical running options (e.g. new install, upgrade, cron/backup only updates etc)
Spark setup: Typical way of setting up the environment would be to define 2 Cassandra data centers: one for real-time transactions (plain Cassandra) and another for analytics workloads (Cassandra with co-located Spark nodes). You can also use the playbook without installing Spark.