diff --git a/documentation/sphinx/source/backups.rst b/documentation/sphinx/source/backups.rst index 274e0d2dc29..abb02747000 100644 --- a/documentation/sphinx/source/backups.rst +++ b/documentation/sphinx/source/backups.rst @@ -61,6 +61,35 @@ By default, the FoundationDB packages are configured to start a single ``backup_ If instead you want to perform a backup to the local disk of a particular machine or machines which are not network accessible to the FoundationDB servers, then you should disable the backup agents on the FoundationDB servers. This is accomplished by commenting out all of the ``[backup_agent.]`` sections in :ref:`foundationdb.conf `. Do not comment out the global ``[backup_agent]`` section. Next, start backup agents on the destination machine or machines. Now, when you start a backup, you can specify the destination directory (as a Backup URL) using a local path on the destination machines. The backup agents will fetch data from the database and store it locally on the destination machines. +Blobstore Access Permisions +=========== + +If a remote blobstore like AWS S3 is used to store the backup data, you should ensure to restrict the backup agent permissions as much as possible. +You can either use the same policy for the ``backup_agent`` and ``fdbbackup`` or separate those. +Note: Your actual required permissions might be different, depending on your setup and requirements. + +Required permissions for the ``backup_agent`` and ``fdbbackup`` at the bucket level: + +:: + + s3:ListBucket + + +Required permissions for the ``backup_agent`` and ``fdbbackup`` at the object level for a specific bucket: + +:: + + s3:AbortMultipartUpload + s3:PutObject + s3:GetObject + s3:DeleteObject + s3:ListBucketMultipartUploads + s3:ListMultipartUploadParts + +Note: If you want that the ``backup_agent`` or ``fdbbackup`` can create a bucket, you have to add the ``s3:CreateBucket`` permission. +If you want to encrypt the data at rest in S3 you have to make sure that S3 is properly configured and that the `backup_agent` and `fdbbackup` have access to [KMS] +For additional information read the AWS S3 documention for `Policy Actions `_ or the equivalent documentation for your blobstore. + Backup URLs ===========