Dependencies:
- libuuid (sometimes part of e2fsprogs)
- sqlite3
+ - Python (2.5 or later)
+ - boto, the python interface to Amazon's Web Services (for S3 storage)
+ http://code.google.com/p/boto
+ - paramiko, SSH2 protocol for python (for sftp storage)
+ http://www.lag.net/paramiko/
Building should be a simple matter of running "make". This will produce
an executable called "cumulus".
specified, the entire snapshot is restored.
+Remote Backups
+--------------
+
+The cumulus-util command can operate directly on remote backups. The
+--store parameter accepts, in addition to a raw disk path, a URL.
+Supported URL forms are
+ file:///path Equivalent to /path
+ s3://bucket/path Storage in Amazon S3
+ (Expects the AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY
+ environment variables to be set appropriately)
+ sftp://server/path Storage on sftp server
+ (note that no password authentication or password protected
+ authorization keys are not supported atm and config options
+ like port or individual authorization keys are to be
+ configured in ~/.ssh/config and the public key of the
+ server has to be in ~/.ssh/known_hosts)
+
+To copy backup snapshots from one storage area to another, the
+cumulus-sync command can be used, as in
+ $ cumulus-sync file:///cumulus s3://my-bucket/cumulus
+
+Support for directly writing backups to a remote location (without using
+a local staging directory and cumulus-sync) is slightly more
+experimental, but can be achieved by replacing
+ --dest=/cumulus
+with
+ --upload-script="cumulus-store s3://my-bucket/cumulus"
+
+
Alternate Restore Tool
---------------------
+----------------------
The contrib/restore.pl script is a simple program for restoring the
-contents of a Cumulus snapshot. It is not as full-features as the
+contents of a Cumulus snapshot. It is not as full-featured as the
restore functionality in cumulus-util, but it is far more compact. It
could be stored with the backup files so a tool for restores is
available even if all other data is lost.