Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 46 lines (35 sloc) 2.291 kb
d7fd22c initial commit
The SoftLayer Developer Network authored
1 softlayer-object-storage-backup
c5fefbe Added details for usage
Kevin Landreth authored
2 ===============================
3
4 SoftLayer's object storage backup script. Works like rsync, but with our object storage service!
5
6 This script is indended to be used purely as a backup operation!
7 It will not make you run faster or jump higher. It might save you from a really
8 bad day though.
9
10 Features
11 --------
12
13 * Rsync-like delta backups - only changed/new files are uploaded saving you time/bandwidth.
14 * Retention policies - deleted/updated files are kept for any desired length of time. These can also be disabled.
15 * Threaded - Copying can always be the longest part, so backups are done in the background as
16 file comparisions are being performed.
17 * MD5 support - Swift automatically sets a default hash (md5) for every object. We support file
18 comparisions using this hash instead of time/size variance.
19 * Open source - MIT licensed (as is the object storage library).
20
21 Usage
22 =====
23
678b227 @CrackerJackMack Documentation cleanups
CrackerJackMack authored
24 1. Download/install [object_storage](https://github.com/softlayer/softlayer-object-storage-python)
25 2. Download slbackup.py
26 3. run ```./slbackup.py --help```
27 4. run ```./slbackup.py --example > ~/.slbackup``` to get a config
28 5. run ```nano ~/.slbackup``` and put your credentials in there
29 6. run with the desired options.
30
31 I also [blogged about it](http://sldn.softlayer.com/blog/klandreth/Deglazing-slbackuppy-Usage-Object-Storage-Kitchen)
c5fefbe Added details for usage
Kevin Landreth authored
32
33 Known issues/limitations
34 ========================
35
678b227 @CrackerJackMack Documentation cleanups
CrackerJackMack authored
36 * Requires [python 2.6 or higher](https://github.com/softlayer/softlayer-object-storage-backup/issues/5). Most modern distros should have this, but for the others, the
37 [python26 package](http://dl.fedoraproject.org/pub/epel/5/x86_64/repoview/python26.html) should help those
38 with production systems.
39 * 5GB file limitation: Swift does support [large files](http://swift.openstack.org/overview_large_objects.html)
c5fefbe Added details for usage
Kevin Landreth authored
40 using Manifest files, but this script does not currently deal with this properly. Not sure how to deal with
41 object fragments during file comparision. Uploading and making the manifests is easy.
42 * Windows Support: Tried to write the script in a way that supported windows. However, it is not tested yet.
678b227 @CrackerJackMack Documentation cleanups
CrackerJackMack authored
43 * Restoration: Restoring files is an operation left to the admin right now.
44 [FUSE is handy](https://github.com/redbo/cloudfuse) for that kine of work.
45
Something went wrong with that request. Please try again.