Troubleshooting Backup Service errors
Solutions to errors encountered when using the Backup Service.
If you encounter errors when backing up or restoring using the Backup Service, follow these instructions to make sure your environment is configured correctly.
Amazon S3 errors
If you are using an Amazon S3 location for storing backups or commit logs, you might encounter
errors if the permissions or authentication keys have been changed since the backup job was
created. Input updated authentication tokens with permissions to write to the specified bucket
name.
Important: The Backup Service requires control
over the data and structure of its destination locations. The backup destinations
must be dedicated for use only by OpsCenter. Any additional directories or
files in those destinations can prevent the Backup Service from properly conducting
a Backup or Restore operation.
Insufficient privileges as an AWS IAM (Identity Access Management) user causes an
authentication error that displays the message "Unable to authenticate against AWS with the
provided key and secret." Ensure the user has base privileges as well as the privilege for the
ListAllMyBuckets
action:"Action": "s3:ListAllMyBuckets"
Actions to consider for granting
AWS IAM user privileges:CreateBucket
GetBucketLocation
ListBucket
ListAllMyBuckets
PutObject
GetObject
DeleteObject
Agent errors
All the nodes in your cluster must use Java 8 for the Backup Service to work.
The agent and DataStax Enterprise user either must be the same (the default), or the agent user must have the correct permissions to read and modify the files owned by the DataStax Enterprise user.