The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Brackup::Target::Amazon - backup to Amazon's S3 service

EXAMPLE

In your ~/.brackup.conf file:

  [TARGET:amazon]
  type = Amazon
  aws_access_key_id  = ...
  aws_secret_access_key =  ....
  aws_prefix =  ....
  backup_prefix =  ....

CONFIG OPTIONS

All options may be omitted unless specified.

type

(Mandatory.) Must be "Amazon".

aws_access_key_id

(Mandatory.) Your Amazon Web Services access key id.

aws_secret_access_key

(Mandatory.) Your Amazon Web Services secret password for the above access key. (not your Amazon password)

aws_prefix

If you want to setup multiple backup targets on a single Amazon account you can use different prefixes. This string is used to name the S3 buckets created by Brackup. If not specified it defaults to the AWS access key id.

aws_location

Sets the location constraint of the new buckets. If left unspecified, the default S3 datacenter location will be used. Otherwise, you can set it to 'EU' for an AWS European data center - note that costs are different. This has only effect when your backup environment is initialized in S3 (i.e. when buckets are created). If you want to move an existing backup environment to another datacenter location, you have to delete its buckets before or create a new one by specifing a different aws_prefix.

backup_prefix

When storing the backup metadata file to S3, the string specified here will be prefixed onto the backup name. This is useful if you are collecting backups from several hosts into a single Amazon S3 account but need to be able to differentiate them; set your prefix to be the hostname of each system, for example.

SEE ALSO

Brackup::Target

Net::Amazon::S3 -- required module to use Brackup::Target::Amazon