updated docs
2 files changed
tree: f17e4f48a276bb72c00a1af20cf62425219574a1
  1. .gitignore
  2. clean.yml
  3. consistency.yml
  4. opdk-backup.yml
  5. opdk-setup-log-files.yml
  6. README.md
  7. repair.yml
  8. requirements.yml
  9. rolling-restart.yml
  10. update-replication-factor.yml
README.md

Apigee OPDK Playbook Maintenance - Cassandra Replication Factor Change Runbook

This is an Ansible playbook that performs a modification of Cassandra replication factor on Apigee components with Zero Downtime.

Requirements and Usage

This playbook uses ansible-galaxy to download roles that are used by this playbook. Once roles are downloaded the playbook and be invoked in several ways. The playbook can be invoked in its entirety, a tag can be used to invoke a subset of playbook services or the playbook may be run manually. These ways of invoking the playbook are described below.

Download Roles

The playbook roles and their location is found in the requirements.yml file. This file is provided to ansible-galaxy so that the roles may be downloaded.

ansible-galaxy usage

ansible-galaxy install -r requirements.yml

Usage: replication_factor_update.yml

The replication_factor_update.yml requires that you specify the replication_factor, opdk_region and the hosts.

ansible-playbook replication_factor_update.yml -e hosts=dc-1-ds -e opdk_region=dc-1 -e replication_factor=3

Usage: update.yml

This playbook contains a convenience playbook that uses the replication_factor_update.yml and requires that you specify only the replication_factor.

ansible-playbook update.yml -vv -b -e replication_factor=3

Defined Tags

Playbook NameTag NameDescription
update.ymldc-1All tasks on dc-1 only
update.ymldc-2All tasks on dc-2 only
update.ymlrestartRestart apigee components other than ds profile components
replication_factor_update.ymlcacheUpdate ansible cache, includes apigee specific attributes
replication_factor_update.ymlupdateUpdate replication factor
replication_factor_update.ymlrepairPerform nodetool repair
replication_factor_update.ymlrestartRestart all apigee components on the node
replication_factor_update.ymlstopStop all apigee components on the node
replication_factor_update.ymlstartStart all apigee components on the node