• INSTALL *

To install upload_s3 you will need:

1. cmake 2.6
2. openssl
3. libcurl
4. libxml2
5. glib2

$ cd $ mkdir -p build && cmake .. $ make && sudo make install

• USAGE *

Assume you already have Amazon AWS account. Go to the https://aws-portal.amazon.com/gp/aws/developer/account/index.html?action=access-key and get access key ID and secret access key.

Go to the S3 console: https://console.aws.amazon.com/s3/home . Create a bucket, name it something like "backup.example.com".

Using this information, create a configuration file for upload_s3:

$ su

cat > /etc/upload_s3.ini

[upload_s3] aws_key=ZZZZZZZZZZZZZZZZZZZZ aws_secret=ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ bucket=backup.example.com ^D

chmod go-rwx /etc/upload_s3.ini

Let the fun begin!

Create a backup, using tar, dar, zip or something else. Crypt it somehow, using pgp, gpg, ccrypt or something. You will have a big file named, for example /tmp/backup-YYYYMMDD.dar.cpt . Now it is a time to upload it to Amazon S3 using command:

upload_s3 -c /etc/upload_s3.ini -pC /tmp/backup-YYYYMMDD.dar.cpt

Bingo!

To place file into some specific directory on S3 side, you can use optional "prefix" parameter after filename. For example:

upload_s3 -c /etc/upload_s3.ini -pC /tmp/backup-YYYYMMDD.dar.cpt dayly-backups/

will upload file to "dayly-backups/backup-YYYYMMDD.dar.cpt" on Amazon side.

• OPTIONS *

upload_s3 --help

Usage: upload_s3 [OPTION...] - Amazon S3 upload utility

Help Options: -h, --help Show help options

Application Options: -c, --config Configuration file -t, --test Exit with status 0 if file exists, 1 otherwise -C, --continue Continue existing upload if any -k, --keep Keep existing file (overwrite by default) -d, --delete=M Delete existing uploads in progress older than M days (0 stand for all) -p, --progress Show upload progress -v, --verbose Verbose operation