---
layout: post
title: "Encrypted remote backup with rsync and dm-crypt: Part 1/2"
date: 2013-02-20 22:41
comments: true
categories: [server, shell]
cover: /images/cover/avatar.png
keywords: rsync, backup, timemachine, linux, ssh, hardlinks, encrypt
description: Backing up data to server
---
# Choose the right tool
Rsync is an ultimate tool for backup purposes. It offers transmitting data
remotely and securely over SSH. Also, it offers ```--link-dest``` option which
guarantees files are not duplicated in a filesystem thanks to [hard links](http://en.wikipedia.org/wiki/Hard_link).
By the way, the same way it does proprietary [Apple Time Machine](http://www.apple.com/osx/apps/#time-machine).
# Start writing a script
Sure, we will use many more other useful options, not just ```--link-dest```. Here's a simplified version of my
backup script:
{% codeblock lang:bash %}{% raw %}
#!/bin/env bash
date=`date "+%Y-%m-%d_%H:%M"`
rsync -av \
--delete \
--delete-excluded \
--compress-level=9 \
--numeric-ids \
--rsync-path="sudo rsync" \
--exclude-from=/root/.rsync/home-cinan \
--link-dest=/mnt/current-backup/home \
/home/cinan -e ssh
sync-user@machine:incomplete_backup-$date/home/
mv incomplete_backup-$date backup-$date && rm -rf current-backup && ln -s backup-$date current-backup
{% endraw%}{% endcodeblock %}
<!-- more -->
Explanation:
- ```-a``` typical option for backup, archive mode (recursive copy, copy symlinks
as symlinks, preserve ownerships). Preserving ownerships works only if rsync
is run on our backup machine with root rights -- see ```--rsync-path option```.
- ```-v``` be verbose, but not too much
- ```--delete``` delete extraneous files from destination directories
- ```--delete-excluded``` also delete excluded files from destination directories
- ```--compress-level=9``` highest compression level (CPU is fast, network ain't)
- ```--numeric-ids``` don't map uid/gid to users/groups
- ```--rsync-path=<some-path>``` to preserve ownerships we need to run rsync as
root on our backup machine.
- ```--exclude-from=<some-path>``` exclude some directories and files from backup
- ```--link-dest=<some-path>``` magic. Hardlink unchanged files to files in
\<some-path\> directory
- ```/home/cinan``` directory to backup
- ```-e ssh``` specify the remote shell to use
- ```<path>``` directory where will be backup saved
- ```mv ... & rm ... && ln``` mark the newest backup as complete. Delete the old backup
link directory (don't worry, you won't lose your data, it's just a symlink)
and symlink the newest backup to current-backup directory (useful for future
backups which will use this directory in ```--link-dest```).
*On the bottom of this article I'll show complete script.*
Keep an eye on slashes! There's a huge difference between /home/cinan and
/home/cinan/ (source directory). Without the final slash, rsync will copy the
directory in its entirety. With the trailing slash, it will copy the contents of
the directory but won't recreate the directory.
# Little bit of security
Before running the script, sacrifice more of your time for sake of security. The
```--rsync-path``` option can be quite dangerous. On server-side setup rrsync first.
Basically it allow sync-user to run rsync in defined something-like-chroot
environment. Read more about rrsync [here](http://www.v13.gr/blog/?p=216).
Now you can run the script. First time it can take longer time but future backups are
incremental, so rsync will transmit only changed files.
# Impact of hard links
Every time the backup process create a new directory called backup-$date.
Thanks to that it's really easy to get files from 22nd Oct 2013 or 29 Nov 2013.
Also, it is space efficient solution because of hardlinks. If file ```dir/a```
exists in backup from 1st Jan 2013 and also from 10th Feb 2013, data of the file
is saved on HDD only once. However, it doesn't mean if you delete a file from January
backup directory then the same file will be deleted in February backup directory --
the February backup file preserves.
Look at directory sizes. First backup is the biggest, other directory sizes are just diffs.
{% img center /images/backup-2.png Size of my backups %}
# More complete script
It isn't very robust, but it works and I'm happy with it.
{% codeblock lang:bash %}{% raw %}
cmd="rsync -av \
--delete \
--delete-excluded \
--compress-level=9 \
--numeric-ids \
--rsync-path=\"sudo rsync\" \
--exclude-from=/root/.rsync/EXCLUDE_FROM \
--link-dest=~/current-backup/TO \
FROM -e ssh backup@cinan.remote:incomplete_backup-$date/TO/"
#tuples EXCLUDE_FROM, FROM, TO
paths=( "home-cinan-exclude" "\/home\/cinan" "home"
"root-exclude" "\/root\/" "root"
"empty" "\/var\/spool" "var"
"empty" "\/var\/lib\/pacman" "var\/lib"
"empty" "\/boot\/" "boot"
)
let "paths_peak=${#paths[@]} / 3 - 1"
for i in `seq 0 $paths_peak`; do
EXCLUDE_FROM=${paths[$i*3+0]}
FROM=${paths[$i*3+1]}
TO=${paths[$i*3+2]}
ssh backup@cinan.remote "mkdir -p incomplete_backup-$date/$TO"
eval `echo $cmd | sed -e 's/EXCLUDE_FROM/'"$EXCLUDE_FROM"'/;s/FROM/'"$FROM"'/;s/TO/'"$TO"'/g'` 2>> /tmp/system_backup_errors
done
ssh backup@cinan.remote "mv incomplete_backup-$date backup-$date && rm -rf current-backup && ln -s backup-$date current-backup"
{% endraw %}{% endcodeblock %}
# I want my data encrypted
Check out 2/2 part.