Add zfSnap script from the legacy branch of the github project:
https://github.com/zfsnap/zfsnap/tree/legacy Usefull to take snapshot with Timestamp and TTL and use in the snapsend script.
This commit is contained in:
parent
23a711608a
commit
3df3bc5744
|
|
@ -0,0 +1,455 @@
|
||||||
|
#!/bin/sh
|
||||||
|
|
||||||
|
# "THE BEER-WARE LICENSE":
|
||||||
|
# <graudeejs@yandex.com> wrote this file. As long as you retain this notice you
|
||||||
|
# can do whatever you want with this stuff. If we meet some day, and you think
|
||||||
|
# this stuff is worth it, you can buy me a beer in return. Aldis Berjoza
|
||||||
|
|
||||||
|
# wiki: https://github.com/graudeejs/zfSnap/wiki
|
||||||
|
# repository: https://github.com/graudeejs/zfSnap
|
||||||
|
# Bug tracking: https://github.com/graudeejs/zfSnap/issues
|
||||||
|
|
||||||
|
readonly VERSION=1.11.1
|
||||||
|
|
||||||
|
# commands
|
||||||
|
ESED='sed -E'
|
||||||
|
zfs_cmd='/sbin/zfs'
|
||||||
|
zpool_cmd='/sbin/zpool'
|
||||||
|
|
||||||
|
# global variables
|
||||||
|
readonly ttl_pattern="([0-9]+y)?([0-9]+m)?([0-9]+w)?([0-9]+d)?([0-9]+h)?([0-9]+M)?([0-9]+[s])?"
|
||||||
|
test_mode="${test_mode:-false}" # When set to "true", Exit won't really exit
|
||||||
|
|
||||||
|
# Exit program with given status code
|
||||||
|
Exit() {
|
||||||
|
IsTrue $test_mode || exit $1
|
||||||
|
}
|
||||||
|
|
||||||
|
Note() {
|
||||||
|
echo "NOTE: $*" > /dev/stderr
|
||||||
|
}
|
||||||
|
|
||||||
|
Err() {
|
||||||
|
echo "ERROR: $*" > /dev/stderr
|
||||||
|
}
|
||||||
|
|
||||||
|
Fatal() {
|
||||||
|
echo "FATAL: $*" > /dev/stderr
|
||||||
|
exit 1
|
||||||
|
}
|
||||||
|
|
||||||
|
Warn() {
|
||||||
|
echo "WARNING: $*" > /dev/stderr
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
readonly OS=`uname`
|
||||||
|
case $OS in
|
||||||
|
'FreeBSD')
|
||||||
|
;;
|
||||||
|
'SunOS')
|
||||||
|
ESED='sed -r'
|
||||||
|
if [ -d "/usr/gnu/bin" ]; then
|
||||||
|
export PATH="/usr/gnu/bin:$PATH"
|
||||||
|
else
|
||||||
|
Fatal "GNU bin direcotry not found"
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
'Linux')
|
||||||
|
ESED='sed -r'
|
||||||
|
;;
|
||||||
|
'Darwin')
|
||||||
|
zfs_cmd='/usr/sbin/zfs'
|
||||||
|
zpool_cmd='/usr/sbin/zpool'
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
Fatal "Your OS isn't supported"
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
|
||||||
|
# Returns 0 if argument is "true"
|
||||||
|
IsTrue() {
|
||||||
|
case "$1" in
|
||||||
|
true)
|
||||||
|
return 0
|
||||||
|
;;
|
||||||
|
false)
|
||||||
|
return 1
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
Fatal "must be true or false"
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
}
|
||||||
|
|
||||||
|
# Returns 0 if argument is "false"
|
||||||
|
IsFalse() {
|
||||||
|
IsTrue "$1" && return 1 || return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# Converts seconds to TTL
|
||||||
|
Seconds2TTL() {
|
||||||
|
# convert seconds to human readable time
|
||||||
|
xtime=$1
|
||||||
|
|
||||||
|
years=$(($xtime / 31536000))
|
||||||
|
xtime=$(($xtime % 31536000))
|
||||||
|
[ ${years:-0} -gt 0 ] && years="${years}y" || years=""
|
||||||
|
|
||||||
|
months=$(($xtime / 2592000))
|
||||||
|
xtime=$(($xtime % 2592000))
|
||||||
|
[ ${months:-0} -gt 0 ] && months="${months}m" || months=""
|
||||||
|
|
||||||
|
days=$(($xtime / 86400))
|
||||||
|
xtime=$(($xtime % 86400))
|
||||||
|
[ ${days:-0} -gt 0 ] && days="${days}d" || days=""
|
||||||
|
|
||||||
|
hours=$(($xtime / 3600))
|
||||||
|
xtime=$(($xtime % 3600))
|
||||||
|
[ ${hours:-0} -gt 0 ] && hours="${hours}h" || hours=""
|
||||||
|
|
||||||
|
minutes=$(($xtime / 60))
|
||||||
|
[ ${minutes:-0} -gt 0 ] && minutes="${minutes}M" || minutes=""
|
||||||
|
|
||||||
|
seconds=$(($xtime % 60))
|
||||||
|
[ ${seconds:-0} -gt 0 ] && seconds="${seconds}s" || seconds=""
|
||||||
|
|
||||||
|
echo "${years}${months}${days}${hours}${minutes}${seconds}"
|
||||||
|
}
|
||||||
|
|
||||||
|
# Converts TTL to seconds
|
||||||
|
TTL2Seconds() {
|
||||||
|
# convert human readable time to seconds
|
||||||
|
echo "$1" | sed -e 's/y/*31536000+/g; s/m/*2592000+/g; s/w/*604800+/g; s/d/*86400+/g; s/h/*3600+/g; s/M/*60+/g; s/s//g; s/\+$//' | bc -l
|
||||||
|
}
|
||||||
|
|
||||||
|
# Converts datetime to seconds
|
||||||
|
Date2Timestamp() {
|
||||||
|
case $OS in
|
||||||
|
'FreeBSD' | 'Darwin' )
|
||||||
|
date -j -f '%Y-%m-%d_%H.%M.%S' "$1" '+%s'
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
date_normal="`echo $1 | $ESED -e 's/\./:/g; s/(20[0-9][0-9]-[01][0-9]-[0-3][0-9])_([0-2][0-9]:[0-5][0-9]:[0-5][0-9])/\1 \2/'`"
|
||||||
|
date --date "$date_normal" '+%s'
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
}
|
||||||
|
|
||||||
|
# Check validity of TTL
|
||||||
|
ValidTTL() {
|
||||||
|
printf "$1" | grep -E "^${ttl_pattern}$" > /dev/null
|
||||||
|
}
|
||||||
|
|
||||||
|
Help() {
|
||||||
|
cat << EOF
|
||||||
|
${0##*/} v${VERSION} by Aldis Berjoza
|
||||||
|
|
||||||
|
Syntax:
|
||||||
|
${0##*/} [ generic options ] [ options ] zpool/filesystem ...
|
||||||
|
|
||||||
|
GENERIC OPTIONS:
|
||||||
|
-d = Delete old snapshots
|
||||||
|
-e = Return number of failed actions as exit code.
|
||||||
|
-F age = Force delete all snapshots exceeding age
|
||||||
|
-n = Only show actions that would be performed
|
||||||
|
-s = Don't do anything on pools running resilver
|
||||||
|
-S = Don't do anything on pools running scrub
|
||||||
|
-v = Verbose output
|
||||||
|
-z = Force new snapshots to have 00 seconds!
|
||||||
|
-zpool28fix = Workaround for zpool v28 zfs destroy -r bug
|
||||||
|
|
||||||
|
OPTIONS:
|
||||||
|
-a ttl = Set how long snapshot should be kept
|
||||||
|
-D pool/fs = Delete all zfSnap snapshots of specific pool/fs (ignore ttl)
|
||||||
|
-p prefix = Use prefix for snapshots after this switch
|
||||||
|
-P = Don't use prefix for snapshots after this switch
|
||||||
|
-r = Create recursive snapshots for all zfs file systems that
|
||||||
|
follow this switch
|
||||||
|
-R = Create non-recursive snapshots for all zfs file systems that
|
||||||
|
follow this switch
|
||||||
|
|
||||||
|
LINKS:
|
||||||
|
wiki: https://github.com/graudeejs/zfSnap/wiki
|
||||||
|
repository: https://github.com/graudeejs/zfSnap
|
||||||
|
Bug tracking: https://github.com/graudeejs/zfSnap/issues
|
||||||
|
|
||||||
|
EOF
|
||||||
|
Exit 0
|
||||||
|
}
|
||||||
|
|
||||||
|
# Removes zfs snapshot
|
||||||
|
RmZfsSnapshot() {
|
||||||
|
if IsTrue $zpool28fix && [ "$1" = '-r' ]; then
|
||||||
|
# get rid of '-r' parameter
|
||||||
|
RmZfsSnapshot $2
|
||||||
|
return
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [ "$1" = '-r' ]; then
|
||||||
|
SkipPool $2 || return 1
|
||||||
|
else
|
||||||
|
SkipPool $1 || return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
zfs_destroy="$zfs_cmd destroy $*"
|
||||||
|
|
||||||
|
# hardening: make really, really sure we are deleting snapshot
|
||||||
|
if echo $* | grep -q -e '@'; then
|
||||||
|
if IsFalse $dry_run; then
|
||||||
|
if $zfs_destroy > /dev/stderr; then
|
||||||
|
IsTrue $verbose && echo "$zfs_destroy ... DONE"
|
||||||
|
else
|
||||||
|
IsTrue $verbose && echo "$zfs_destroy ... FAIL"
|
||||||
|
IsTrue $count_failures && failures=$(($failures + 1))
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
echo "$zfs_destroy"
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
echo "FATAL: trying to delete zfs pool or filesystem? WTF?" > /dev/stderr
|
||||||
|
echo " This is bug, we definitely don't want that." > /dev/stderr
|
||||||
|
echo " Please report it to https://github.com/graudeejs/zfSnap/issues" > /dev/stderr
|
||||||
|
echo " Don't panic, nothing was deleted :)" > /dev/stderr
|
||||||
|
IsTrue $count_failures && [ $failures -gt 0 ] && Exit $failures
|
||||||
|
Exit 1
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# Returns 1 if zfs operations on given pool should be skipped
|
||||||
|
SkipPool() {
|
||||||
|
if IsTrue $scrub_skip; then
|
||||||
|
for i in $scrub_pools; do
|
||||||
|
if [ `echo $1 | sed -e 's#/.*$##; s/@.*//'` = $i ]; then
|
||||||
|
IsTrue $verbose && Note "No action will be performed on '$1'. Scrub is running on pool."
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
fi
|
||||||
|
if IsTrue $resilver_skip; then
|
||||||
|
for i in $resilver_pools; do
|
||||||
|
if [ `echo $1 | sed -e 's#/.*$##; s/@.*//'` = $i ]; then
|
||||||
|
IsTrue $verbose && Note "No action will be performed on '$1'. Resilver is running on pool."
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
fi
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
if IsFalse $test_mode; then
|
||||||
|
[ $# = 0 ] && Help
|
||||||
|
[ "$1" = '-h' -o $1 = "--help" ] && Help
|
||||||
|
fi
|
||||||
|
|
||||||
|
ttl='1m' # default snapshot ttl
|
||||||
|
force_delete_snapshots_age=-1 # Delete snapshots older than x seconds. -1 means NO
|
||||||
|
delete_snapshots="false" # Delete old snapshots?
|
||||||
|
verbose="false" # Verbose output?
|
||||||
|
dry_run="false" # Dry run?
|
||||||
|
prefix="" # Default prefix
|
||||||
|
prefixes="" # List of prefixes
|
||||||
|
delete_specific_fs_snapshots="" # List of specific snapshots to delete
|
||||||
|
delete_specific_fs_snapshots_recursively="" # List of specific snapshots to delete recursively
|
||||||
|
zero_seconds="false" # Should new snapshots always have 00 seconds?
|
||||||
|
scrub_pools="" # List of pools that are scrubbing
|
||||||
|
resilver_pools="" # List of pools that are resilvering
|
||||||
|
pools="" # List of pools
|
||||||
|
get_pools="false" # Should I get list of pools?
|
||||||
|
resilver_skip="false" # Should I skip pools that are resilvering?
|
||||||
|
scrub_skip="false" # Should I skip pools that are scrubbing?
|
||||||
|
failures=0 # Number of failed actions.
|
||||||
|
count_failures="false" # Should I count failed actions?
|
||||||
|
zpool28fix="false" # Workaround for zpool v28 zfs destroy -r bug
|
||||||
|
|
||||||
|
while [ "$1" = '-d' -o "$1" = '-v' -o "$1" = '-n' -o "$1" = '-F' -o "$1" = '-z' -o "$1" = '-s' -o "$1" = '-S' -o "$1" = '-e' -o "$1" = '-zpool28fix' ]; do
|
||||||
|
case "$1" in
|
||||||
|
'-d')
|
||||||
|
delete_snapshots="true"
|
||||||
|
shift
|
||||||
|
;;
|
||||||
|
|
||||||
|
'-v')
|
||||||
|
verbose="true"
|
||||||
|
shift
|
||||||
|
;;
|
||||||
|
|
||||||
|
'-n')
|
||||||
|
dry_run="true"
|
||||||
|
shift
|
||||||
|
;;
|
||||||
|
|
||||||
|
'-F')
|
||||||
|
force_delete_snapshots_age=`TTL2Seconds $2`
|
||||||
|
shift 2
|
||||||
|
;;
|
||||||
|
|
||||||
|
'-z')
|
||||||
|
zero_seconds="true"
|
||||||
|
shift
|
||||||
|
;;
|
||||||
|
|
||||||
|
'-s')
|
||||||
|
get_pools="true"
|
||||||
|
resilver_skip="true"
|
||||||
|
shift
|
||||||
|
;;
|
||||||
|
|
||||||
|
'-S')
|
||||||
|
get_pools="true"
|
||||||
|
scrub_skip="true"
|
||||||
|
shift
|
||||||
|
;;
|
||||||
|
|
||||||
|
'-e')
|
||||||
|
count_failures="true"
|
||||||
|
shift
|
||||||
|
;;
|
||||||
|
|
||||||
|
'-zpool28fix')
|
||||||
|
zpool28fix="true"
|
||||||
|
shift
|
||||||
|
;;
|
||||||
|
|
||||||
|
esac
|
||||||
|
done
|
||||||
|
|
||||||
|
if IsTrue $get_pools; then
|
||||||
|
pools=`$zpool_cmd list -H -o name`
|
||||||
|
for i in $pools; do
|
||||||
|
if IsTrue $resilver_skip; then
|
||||||
|
$zpool_cmd status $i | grep -q -e 'resilver in progress' && resilver_pools="$resilver_pools $i"
|
||||||
|
fi
|
||||||
|
if IsTrue $scrub_skip; then
|
||||||
|
$zpool_cmd status $i | grep -q -e 'scrub in progress' && scrub_pools="$scrub_pools $i"
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
fi
|
||||||
|
|
||||||
|
readonly date_pattern='20[0-9][0-9]-[01][0-9]-[0-3][0-9]_[0-2][0-9]\.[0-5][0-9]\.[0-5][0-9]'
|
||||||
|
if IsFalse $zero_seconds; then
|
||||||
|
readonly tfrmt='%Y-%m-%d_%H.%M.%S'
|
||||||
|
else
|
||||||
|
readonly tfrmt='%Y-%m-%d_%H.%M.00'
|
||||||
|
fi
|
||||||
|
|
||||||
|
IsTrue $dry_run && zfs_list=`$zfs_cmd list -H -o name`
|
||||||
|
ntime=`date "+$tfrmt"`
|
||||||
|
while [ "$1" ]; do
|
||||||
|
while [ "$1" = '-r' -o "$1" = '-R' -o "$1" = '-a' -o "$1" = '-p' -o "$1" = '-P' -o "$1" = '-D' ]; do
|
||||||
|
case "$1" in
|
||||||
|
'-r')
|
||||||
|
zopt='-r'
|
||||||
|
shift
|
||||||
|
;;
|
||||||
|
'-R')
|
||||||
|
zopt=''
|
||||||
|
shift
|
||||||
|
;;
|
||||||
|
'-a')
|
||||||
|
ttl="$2"
|
||||||
|
echo "$ttl" | grep -q -E -e "^[0-9]+$" && ttl=`Seconds2TTL $ttl`
|
||||||
|
ValidTTL "$ttl" || Fatal "Invalid TTL: $ttl"
|
||||||
|
shift 2
|
||||||
|
;;
|
||||||
|
'-p')
|
||||||
|
prefix="$2"
|
||||||
|
prefixes="$prefixes|$prefix"
|
||||||
|
shift 2
|
||||||
|
;;
|
||||||
|
'-P')
|
||||||
|
prefix=""
|
||||||
|
shift
|
||||||
|
;;
|
||||||
|
'-D')
|
||||||
|
if [ "$zopt" != '-r' ]; then
|
||||||
|
delete_specific_fs_snapshots="$delete_specific_fs_snapshots $2"
|
||||||
|
else
|
||||||
|
delete_specific_fs_snapshots_recursively="$delete_specific_fs_snapshots_recursively $2"
|
||||||
|
fi
|
||||||
|
shift 2
|
||||||
|
;;
|
||||||
|
|
||||||
|
esac
|
||||||
|
done
|
||||||
|
|
||||||
|
# create snapshots
|
||||||
|
if [ $1 ]; then
|
||||||
|
if SkipPool $1; then
|
||||||
|
if [ $1 = `echo $1 | $ESED -e 's/^-//'` ]; then
|
||||||
|
zfs_snapshot="$zfs_cmd snapshot $zopt $1@${prefix}${ntime}--${ttl}"
|
||||||
|
if IsFalse $dry_run; then
|
||||||
|
if $zfs_snapshot > /dev/stderr; then
|
||||||
|
IsTrue $verbose && echo "$zfs_snapshot ... DONE"
|
||||||
|
else
|
||||||
|
IsTrue $verbose && echo "$zfs_snapshot ... FAIL"
|
||||||
|
IsTrue $count_failures && failures=$(($failures + 1))
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
printf "%s\n" $zfs_list | grep -m 1 -q -E -e "^$1$" \
|
||||||
|
&& echo "$zfs_snapshot" \
|
||||||
|
|| Err "Looks like zfs filesystem '$1' doesn't exist"
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
Warn "'$1' doesn't look like valid argument. Ignoring"
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
shift
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
|
prefixes=`echo "$prefixes" | sed -e 's/^|//'`
|
||||||
|
|
||||||
|
# delete snapshots
|
||||||
|
if IsTrue $delete_snapshots || [ $force_delete_snapshots_age -ne -1 ]; then
|
||||||
|
|
||||||
|
if IsFalse $zpool28fix; then
|
||||||
|
zfs_snapshots=`$zfs_cmd list -H -o name -t snapshot | grep -E -e "^.*@(${prefixes})?${date_pattern}--${ttl_pattern}$" | sed -e 's#/.*@#@#'`
|
||||||
|
else
|
||||||
|
zfs_snapshots=`$zfs_cmd list -H -o name -t snapshot | grep -E -e "^.*@(${prefixes})?${date_pattern}--${ttl_pattern}$"`
|
||||||
|
fi
|
||||||
|
|
||||||
|
current_time=`date +%s`
|
||||||
|
for i in `echo $zfs_snapshots | xargs printf "%s\n" | $ESED -e "s/^.*@//" | sort -u`; do
|
||||||
|
create_time=$(Date2Timestamp `echo "$i" | $ESED -e "s/--${ttl_pattern}$//; s/^(${prefixes})?//"`)
|
||||||
|
if IsTrue $delete_snapshots; then
|
||||||
|
stay_time=$(TTL2Seconds `echo $i | $ESED -e "s/^(${prefixes})?${date_pattern}--//"`)
|
||||||
|
[ $current_time -gt $(($create_time + $stay_time)) ] \
|
||||||
|
&& rm_snapshot_pattern="$rm_snapshot_pattern $i"
|
||||||
|
fi
|
||||||
|
if [ "$force_delete_snapshots_age" -ne -1 ]; then
|
||||||
|
[ $current_time -gt $(($create_time + $force_delete_snapshots_age)) ] \
|
||||||
|
&& rm_snapshot_pattern="$rm_snapshot_pattern $i"
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
|
if [ "$rm_snapshot_pattern" != '' ]; then
|
||||||
|
rm_snapshots=$(echo $zfs_snapshots | xargs printf '%s\n' | grep -E -e "@`echo $rm_snapshot_pattern | sed -e 's/ /|/g'`" | sort -u)
|
||||||
|
for i in $rm_snapshots; do
|
||||||
|
RmZfsSnapshot -r $i
|
||||||
|
done
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
# delete all snapshots
|
||||||
|
if [ "$delete_specific_fs_snapshots" != '' ]; then
|
||||||
|
rm_snapshots=`$zfs_cmd list -H -o name -t snapshot | grep -E -e "^($(echo "$delete_specific_fs_snapshots" | tr ' ' '|'))@(${prefixes})?${date_pattern}--${ttl_pattern}$"`
|
||||||
|
for i in $rm_snapshots; do
|
||||||
|
RmZfsSnapshot $i
|
||||||
|
done
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [ "$delete_specific_fs_snapshots_recursively" != '' ]; then
|
||||||
|
rm_snapshots=`$zfs_cmd list -H -o name -t snapshot | grep -E -e "^($(echo "$delete_specific_fs_snapshots_recursively" | tr ' ' '|'))@(${prefixes})?${date_pattern}--${ttl_pattern}$"`
|
||||||
|
for i in $rm_snapshots; do
|
||||||
|
RmZfsSnapshot -r $i
|
||||||
|
done
|
||||||
|
fi
|
||||||
|
|
||||||
|
|
||||||
|
IsTrue $count_failures && Exit $failures
|
||||||
|
Exit 0
|
||||||
|
# vim: set ts=4 sw=4 expandtab:
|
||||||
Loading…
Reference in New Issue