TABLECHOP(1)

NAME
tablechop - cassandra backup utility

SYNOPSIS
tablechop [-hdle] [ -k AWS_KEY ] [-s AWS_SECRET ] [--token AWS_TOKEN ] [-n NAME bucket path age

DESCRIPTION
tablechop Clean SSTables from S3. Scroll backwards through -listdir.json keys in chronological order collecting a "keeper" list until it reaches it's age cutoff. Deletes all keys not in that list.

OPTIONS

-k, --key=AWS_KEY
    Amazon S3 Key (defaults to AWS_ACCESS_KEY_ID in environment)

-s, --secret=AWS_SECRET
    Amazon S3 Secret (defaults to AWS_SECRET_ACCESS_KEY in environment)

--token=AWS_SECURITY_TOKEN
    Amazon S3 Token (defaults to AWS_SECURITY_TOKEN in environment)

-d, --debug
    run in debug mode, will not delete keys

-l, --list-deletes
    log every file being deleted

-e, --keep-existing
    keep files that still exist on this server regardless of age

-n, --name=NAME
    use this name to identify files uploaded from this host (defaults to your host's FQDN)

ENVIRONMENT

AWS_ACCESS_KEY_ID
    Amazon access key to be used if --aws-key is not specified

AWS_SECRET_ACCESS_KEY
    Amazon secret key to be used if --aws-secret is not specified

AWS_SECURITY_TOKEN
    Amazon security token to be used if --aws-token is not specified

TDEBUG
    If set, logs are emitted at the DEBUG level (default INFO)

DIAGNOSTICS
The following diagnostics may be issued on stderr:

Problem initializing S3 connection
    A server error was returned from the S3 API when trying to retrieve the bucket
Problem getting keys from S3 bucket
    A server error was returned from the S3 API when trying to list keys matching a pattern.
-listdir.json file should have a single key/value pair!
    The -listdir.json file downloaded from S3 did not contain a simple hash of keys and values.
S3 delete ERR, will try again later
    An uncaught exception occurred when trying to delete keys from the S3 bucket.

BUGS
Please report all bugs to the maintainers at https://github.com/JeremyGrosser/tablesnap/issues

AUTHORS
Jeremy Grosser <jeremy@synack.me> Jorge A Gallegos <kad@blegh.net>

SEE ALSO
tablesnap(1), tableslurp(1)