X-Git-Url: http://git.vrable.net/?p=cumulus.git;a=blobdiff_plain;f=README;h=2dec5389873c5565b88f01a90010efc3167e5c8d;hp=027ca6159eb9319dd7bed94f3ab81cf622a6efea;hb=HEAD;hpb=3bc33ec7dbd11f87bfd6942743b0d48163486952

diff --git a/README b/README
index 027ca61..2dec538 100644
--- a/README
+++ b/README
@@ -6,6 +6,13 @@ How to Build
 Dependencies:
   - libuuid (sometimes part of e2fsprogs)
   - sqlite3
+  - Python (2.7 or later, or 3.2 or later)
+  - Python six, a Python 2/3 compatibility library
+    https://pypi.python.org/pypi/six
+  - 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".
@@ -136,11 +143,40 @@ should be restored (this directory should initially be empty).
 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.