#!/bin/bash
#
# backup-script system for cloning systems using rsync
-# Copyright (c)2008-2013 Alexander Barton, alex@barton.de
+# Copyright (c)2008-2015 Alexander Barton <alex@barton.de>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# Please read the file COPYING, README and AUTHORS for more information.
#
-NAME=`basename $0`
-CONF_D="/etc/backup-script.d"
+NAME=$(basename "$0")
PIDFILE="/var/run/$NAME.pid"
DRYRUN=0
destinations=""
# Default settings, can be overwritten in backup-script.conf:
+conf_d="/etc/backup-script.d"
pre_exec=""
post_exec=""
+default_source_root="/"
default_target=""
default_user="root"
default_ssh_args_add=""
default_compress=1
default_ping=1
default_local=0
+default_generations=0
+default_job_pre_exec=""
+default_job_post_exec=""
Usage() {
echo "Usage: $NAME [<options>] [<system> [<system> [...]]]"
echo
echo " -p, --progress Show progress, see rsync(1)."
- echo " -d, --dry-run Test run only, don't copy any data."
+ echo " -n, --dry-run Test run only, don't copy any data."
echo
echo "When no <system> is given, all defined systems are used."
echo
CleanUp
echo -n "Aborted: "; date
echo
+ sleep 3
exit 9
}
+ExecJob() {
+ local what="$1"
+ local cmd="$2"
+
+ echo "Running job ${what}-exec command ..."
+ [ "$local" -eq 0 ] \
+ && cmd="$ssh_cmd ${user}@${system} $cmd"
+ echo -n "Start date (${what}-exec): "; date
+ echo "$cmd"
+ if [ "$DRYRUN" -eq 0 ]; then
+ $SHELL -c "$cmd"; local ret=$?
+ else
+ echo " *** Trial run, not executing ${what}-exec command!"
+ ret=0
+ fi
+ [ $ret -eq 0 ] \
+ && echo "The ${what}-exec command completed with status 0, OK." \
+ || echo "The ${what}-exec command completed with ERRORS, code $ret!"
+ return $ret
+}
+
+GetFS() {
+ local dir="$1"
+
+ while [ -n "$dir" ]; do
+ findmnt -fn -o FSTYPE --raw "$dir" 2>/dev/null; local r=$?
+ if [ $r -eq 0 ]; then
+ return 0
+ elif [ $r -eq 127 ]; then
+ echo "UNKNOWN"
+ return 1
+ fi
+ dir=$(dirname "$dir") || return 1
+ done
+}
+
+CreateSubvolume() {
+ local volume="$1"
+ local fs
+ local dir
+
+ dir=$(dirname "$volume")
+ fs=$(GetFS "$dir")
+ case "$fs" in
+ "btrfs")
+ btrfs subvolume create "$volume" >/dev/null || return 1
+ ;;
+ "zfs")
+ zfs create "$(echo "$volume" | cut -c2-)" || return 1
+ ;;
+ *)
+ echo "CreateSubvolume: Incompatible FS type \"$fs\" on \"$dir\"!"
+ return 9
+ esac
+ return 0
+}
+
+CloneSubvolume() {
+ local source="$1"
+ local volume="$2"
+ local snapshot="$3"
+ local dir
+ local fs
+ local link_name
+
+ dir=$(dirname "source")
+ fs=$(GetFS "$source")
+ case "$fs" in
+ "btrfs")
+ btrfs subvolume snapshot "$source" "$snapshot" >/dev/null || return 1
+ ;;
+ "zfs")
+ zfs snapshot "$snapshot" || return 1
+ link_name="$(echo "$snapshot" | cut -d@ -f2-)"
+ ln -s \
+ "$volume/.zfs/snapshot/$link_name" \
+ "$(dirname "$volume")/$link_name"
+ ;;
+ *)
+ echo "CloneSubvolume: Incompatible FS type \"$fs\" on \"$source\"!"
+ return 9
+ esac
+ return 0
+}
+
+RenameSubvolume() {
+ local source="$1"
+ local target="$2"
+ local fs
+
+ fs=$(GetFS "$source")
+ case "$fs" in
+ "btrfs")
+ mv "$source" "$target" || return 1
+ ;;
+ "zfs")
+ zfs rename \
+ "$(echo "$source" | cut -c2-)" \
+ "$(echo "$target" | cut -c2-)" \
+ || return 1
+ ;;
+ *)
+ echo "RenameSubvolume: Incompatible FS type \"$fs\" on \"$source\"!"
+ return 9
+ esac
+ return 0
+}
+
+DeleteSubvolume() {
+ local volume="$1"
+ local fs
+ local id
+ local snapshot
+
+ fs=$(GetFS "$volume")
+ case "$fs" in
+ "btrfs")
+ btrfs subvolume delete "$volume" >/dev/null || return 1
+ ;;
+ "zfs")
+ id="$(basename "$volume")"
+ if [ -h "$volume" ]; then
+ snapshot="$(dirname "$volume")/current@$id"
+ else
+ snapshot="$volume"
+ fi
+ zfs destroy -r "$(echo "$snapshot" | cut -c2-)" >/dev/null || return 1
+ [ -h "$volume" ] && rm "$volume"
+ ;;
+ *)
+ echo "DeleteSubvolume: Incompatible FS type \"$fs\" on \"$volume\"!"
+ return 9
+ esac
+ return 0
+}
+
+Initialize_Last_SysTarget_Snapshot() {
+ sys_target="$1"
+ unset last
+ unset snapshot
+
+ fs=$(GetFS "$sys_target")
+ case "$fs" in
+ "btrfs")
+ # Search directory of last generation, if any
+ last=$(ls -1d "$sys_target"/[0-9]* 2>/dev/null | sort -r | head -n1)
+ if [ -n "$last" ]; then
+ if [ ! -d "$last" ]; then
+ echo "Last snapshot \"$last\" seems not to be a directory!? \"$system\" skipped!"
+ echo
+ return 1
+ fi
+ fi
+ sys_target="$sys_target/$(date +%Y%m%d-%H%M%S)"
+ snapshot="$sys_target"
+ ;;
+ "zfs")
+ # On ZFS, the last generation is always named "current"
+ [ -e "$sys_target/current" ] \
+ && last="$sys_target/current" \
+ || last=""
+ snapshot="$(echo "$sys_target/current" | cut -c2-)@$(date +%Y%m%d-%H%M%S)"
+ sys_target="$sys_target/current"
+ ;;
+ *)
+ echo "Initialize_Last_SysTarget_Snapshot: Incompatible FS type \"$fs\" on \"$sys_target\"!"
+ return 1
+ esac
+ return 0
+}
+
while [ $# -gt 0 ]; do
case "$1" in
"-n"|"--dry-run")
esac
done
+trap GotSignal SIGINT
+
+echo -n "Started: "; date
+
+for conf in "/etc/backup-script.conf" "${conf_d}/backup-script.conf"; do
+ if [ -r "$conf" ]; then
+ echo "Reading configuration: \"$conf\" ..."
+ source "$conf"
+ fi
+done
+echo
+
if [ $# -ge 1 ]; then
- for s in $@; do
- if [ ! -r "${CONF_D}/$s" ]; then
- echo "$NAME: Can' read \"${CONF_D}/$s\"!"
+ for s in "$@"; do
+ if [ ! -r "${conf_d}/$s" ]; then
+ echo "$NAME: Can' read \"${conf_d}/$s\"!"
exit 1
fi
- sys="$sys ${CONF_D}/$s"
+ sys="$sys ${conf_d}/$s"
done
else
- sys=${CONF_D}/*
+ sys="${conf_d}/"*
fi
-trap GotSignal SIGINT
-
-echo -n "Started: "; date
-echo
-
-[ -r "${CONF_D}/backup-script.conf" ] && source "${CONF_D}/backup-script.conf"
-
# check and create PID file
if [ -e "$PIDFILE" ]; then
echo "Lockfile \"$PIDFILE\" already exists."
for f in $sys; do
[ -r "$f" -a -f "$f" ] || continue
- system=`basename $f`
- case "$system" in
+ fname=$(basename "$f")
+ case "$fname" in
"backup-script.conf"|*.sh)
continue
;;
esac
# Set global defaults
+ system="$fname"
user="$default_user"
+ source_root="$default_source_root"
target="$default_target"
ssh_args_add="$default_ssh_args_add"
rsync_args_add="$default_rsync_args_add"
compress="$default_compress"
ping="$default_ping"
local="$default_local"
+ generations="$default_generations"
+ job_pre_exec="$default_job_pre_exec"
+ job_post_exec="$default_job_post_exec"
+
+ # Compatibility with backup-pull(1) script: Save global values ...
+ pre_exec_saved="$pre_exec"
+ post_exec_saved="$post_exec"
+
+ # Compatibility with backup-pull(1) script: Set defaults
+ unset host
+ unset source
+ unset pre_exec
+ unset post_exec
# Read in system configuration file
source "$f"
+ # Compatibility with backup-pull(1) script: Fix up configuration
+ [ "$system" = "$fname" -a -n "$host" ] \
+ && system="$host"
+ [ "$source_root" = "$default_source_root" -a -n "$source" ] \
+ && source_root="$source"
+ [ -z "$job_pre_exec" -a -n "$pre_exec" ] \
+ && job_pre_exec="$pre_exec"
+ [ -z "$job_post_exec" -a -n "$post_exec" ] \
+ && job_post_exec="$post_exec"
+
+ # Compatibility with backup-pull(1) script: Restore global values ...
+ pre_exec="$pre_exec_saved"
+ post_exec="$post_exec_saved"
+
+ # Validate configuration
+ [ "$system" = "localhost" -o "$system" = "127.0.0.1" ] && local=1
+
+ [ "$system" = "$fname" ] \
+ && systxt="\"$system\"" \
+ || systxt="\"$fname\" [\"$system\"]"
[ "$local" -eq 0 ] \
- && echo "Working on \"$system\" ..." \
- || echo "Working on \"$system\" (local system) ..."
+ && echo "Working on $systxt ..." \
+ || echo "Working on $systxt (local system) ..."
count_all=$count_all+1
echo; continue
fi
- sys_target="$target/$system"
- if [ "$DRYRUN" -eq 0 ]; then
- mkdir -p "$sys_target" >/dev/null 2>&1
+ sys_target="$target/$fname"
+ sys_root="$sys_target"
+ if [ "$DRYRUN" -eq 0 -a ! -e "$sys_target" ]; then
+ if [ $generations -gt 0 ]; then
+ CreateSubvolume "$sys_target"
+ else
+ mkdir -p "$sys_target"
+ fi
if [ $? -ne 0 ]; then
echo "Can't create \"$sys_target\"!? \"$system\" skipped!"
- echo continue
+ echo; continue
fi
fi
echo "OK, host \"$system\" seems to be alive."
fi
+ if [ $generations -gt 0 ]; then
+ # Make sure no old backup is stored in system directory
+ if [ -e "$sys_target/.stamp" ]; then
+ # There seems to be a genearation-less backup in the
+ # target directory!
+ echo "Target directory \"$sys_target\" seems to be unclean!? \"$system\" skipped!"
+ echo; continue
+ fi
+
+ Initialize_Last_SysTarget_Snapshot "$sys_target" || continue
+
+ if [ -n "$last" -a ! -e "$last/.stamp" ]; then
+ # Old backup directory without "stamp file", continue
+ echo "Found incomplete snapshot in \"$last\", reusing and renaming it ..."
+ RenameSubvolume "$last" "$sys_target"
+ if [ $? -ne 0 ]; then
+ echo "Failed to rename last snapshot \"$last\" to \"$sys_target\"!? \"$system\" skipped!"
+ echo; continue
+ fi
+ elif [ -n "$last" ]; then
+ # Old backup directory found, create new snapshot
+ echo "Found last snapshot in \"$last\"."
+ if [ "$DRYRUN" -eq 0 ]; then
+ CloneSubvolume "$last" "$sys_target" "$snapshot"; r=$?
+ if [ $r -ne 0 ]; then
+ echo "Can't create snapshot \"$snapshot\" of \"$last\", code $r!? \"$system\" skipped!"
+ echo; continue
+ fi
+ echo "Created new snapshot in \"$snapshot\"."
+ else
+ echo " *** Trial run, not creating new snapshot in \"$sys_target\"!"
+ fi
+ else
+ # No old backup found, create new subvolume
+ if [ "$DRYRUN" -eq 0 ]; then
+ CreateSubvolume "$sys_target"; r=$?
+ if [ $r -ne 0 ]; then
+ echo "Can't create subvolume \"$sys_target\", code $r!? \"$system\" skipped!"
+ echo; continue
+ fi
+ echo "Created new subvolume in \"$sys_target\"."
+ else
+ echo " *** Trial run, not creating new subvolume \"$sys_target\"!"
+ fi
+ fi
+ fi
+
ssh_cmd="ssh"
[ -n "$ssh_args_add" ] && ssh_cmd="$ssh_cmd $ssh_args_add"
+ # execute job "pre-exec" command, if any
+ if [ -n "$job_pre_exec" ]; then
+ ExecJob pre "$job_pre_exec" ; ret=$?
+ if [ $ret -ne 0 ]; then
+ [ $ret -ne 99 ] && count_started=$count_started+1
+ echo "Pre-exec command failed, \"$system\" skipped!"
+ echo; continue
+ fi
+ fi
+
+ # prepare (remote) command ...
cmd="rsync --archive"
[ "$compress" -ne 0 ] && cmd="$cmd --compress"
- cmd="$cmd --rsh=\"$ssh_cmd\" --delete --delete-excluded --sparse"
+ [ "$local" -eq 0 ] && cmd="$cmd --rsh=\"$ssh_cmd\""
+ cmd="$cmd --delete --delete-excluded --sparse"
[ "$VERBOSE" -gt 0 ] && cmd="$cmd --progress"
- cmd="$cmd --exclude=/dev --exclude=/proc --exclude=/sys"
- cmd="$cmd --exclude=/run --exclude=/tmp --exclude=/var/tmp"
- cmd="$cmd --exclude=/media --exclude=/mnt --exclude=/net"
- cmd="$cmd --exclude=/var/cache/apt --exclude=/var/log"
+ if [ "$source_root" = "$default_source_root" ]; then
+ cmd="$cmd --exclude=/dev --exclude=/proc --exclude=/sys"
+ cmd="$cmd --exclude=/run --exclude=/tmp --exclude=/var/tmp"
+ cmd="$cmd --exclude=/media --exclude=/mnt --exclude=/net"
+ cmd="$cmd --exclude=/var/cache/apt --exclude=/var/log"
+ fi
[ -n "$exclude_args_add" ] && cmd="$cmd $exclude_args_add"
[ -n "$rsync_args_add" ] && cmd="$cmd $rsync_args_add"
[ "$local" -eq 0 ] \
- && cmd="$cmd ${user}@${system}:/ $sys_target/" \
- || cmd="$cmd / $sys_target/"
+ && cmd="$cmd ${user}@${system}:$source_root $sys_target/" \
+ || cmd="$cmd $source_root $sys_target/"
- echo "Calling: $cmd"
+ echo "Backing up to \"$sys_target\" ..."
echo -n "Start date: "; date
+ echo "$cmd"
count_started=$count_started+1
- rm -f "$sys_target/.stamp"
-
+ ok=0
+
if [ "$DRYRUN" -eq 0 ]; then
+ rm -f "$sys_target/.stamp"
$SHELL -c "$cmd"; ret=$?
echo "code=$ret" >"$sys_target/.stamp"
else
exit 1
fi
+ echo -n "End date: "; date
if [ $ret -eq 0 -o $ret -eq 24 ]; then
[ $ret -eq 24 ] && count_ok_vanished=$count_ok_vanished+1
echo "System \"$system\" completed with status $ret, OK."
[ "$DRYRUN" -gt 0 ] || count_ok=$count_ok+1
+ ok=1
else
echo "System \"$system\" completed with ERRORS, code $ret!"
fi
- echo -n "End date: "; date
+
+ # execute job "post-exec" command, if any
+ if [ -n "$job_post_exec" ]; then
+ ExecJob post "$job_post_exec"
+ fi
+
+ if [ $generations -gt 0 ]; then
+ # Update "latest" symlink
+ if [ "$DRYRUN" -eq 0 ]; then
+ rm -f "$sys_root/latest"
+ ln -s "$sys_target" "$sys_root/latest"
+ fi
+ # Clean up old generations
+ declare -i gen_count=$generations+2
+ to_delete=$(ls -1t "$sys_root" 2>/dev/null | tail -n+$gen_count | sort)
+ if [ -n "$to_delete" -a $ok -eq 1 ]; then
+ [ "$DRYRUN" -eq 0 ] \
+ && echo "Deleting old backup generations (keep $generations) ..." \
+ || echo " *** Trial run, not deleting old generations:"
+ for delete in $to_delete; do
+ dir="$sys_root/$delete"
+ if [ ! -e "$dir/.stamp" ]; then
+ echo "Not deleting \"$dir\", not a backup directory!?"
+ continue
+ fi
+ last=$(stat "$dir/.stamp" 2>/dev/null | grep "^Modify: " \
+ | cut -d':' -f2- | cut -d. -f1)
+ echo "Removing backup from" $last "..."
+ if [ "$DRYRUN" -eq 0 ]; then
+ DeleteSubvolume "$dir"
+ [ $? -eq 0 ] || \
+ echo "Failed to delete \"$dir\"!"
+ fi
+ done
+ echo -n "Clean up finished: "; date
+ elif [ -n "$to_delete" ]; then
+ echo "There have been errors, not cleaning up old generations!"
+ else
+ echo "Nothing to clean up."
+ fi
+ fi
destinations="$destinations $target"
echo
echo -n "Done: "; date
echo
-echo " - $count_all jobs defined,"
-echo " - $count_started jobs started,"
+[ $count_all -eq 1 ] && s="" || s="s"
+echo " - $count_all job$s defined,"
+[ $count_started -eq 1 ] && s="" || s="s"
+echo " - $count_started job$s started,"
echo " - $count_ok done without errors."
echo