mirror of
https://github.com/jimsalterjrs/sanoid.git
synced 2024-09-10 10:52:45 +02:00
1514 lines
54 KiB
Perl
Executable file
1514 lines
54 KiB
Perl
Executable file
#!/usr/bin/perl
|
|
|
|
# this software is licensed for use under the Free Software Foundation's GPL v3.0 license, as retrieved
|
|
# from http://www.gnu.org/licenses/gpl-3.0.html on 2014-11-17. A copy should also be available in this
|
|
# project's Git repository at https://github.com/jimsalterjrs/sanoid/blob/master/LICENSE.
|
|
|
|
$::VERSION = '2.0.0';
|
|
|
|
use strict;
|
|
use warnings;
|
|
use Data::Dumper;
|
|
use Getopt::Long qw(:config auto_version auto_help);
|
|
use Pod::Usage;
|
|
use Time::Local;
|
|
use Sys::Hostname;
|
|
|
|
# Blank defaults to use ssh client's default
|
|
# TODO: Merge into a single "sshflags" option?
|
|
my %args = ('sshkey' => '', 'sshport' => '', 'sshcipher' => '', 'sshoption' => [], 'target-bwlimit' => '', 'source-bwlimit' => '');
|
|
GetOptions(\%args, "no-command-checks", "monitor-version", "compress=s", "dumpsnaps", "recursive|r",
|
|
"source-bwlimit=s", "target-bwlimit=s", "sshkey=s", "sshport=i", "sshcipher|c=s", "sshoption|o=s@",
|
|
"debug", "quiet", "no-stream", "no-sync-snap", "no-resume", "exclude=s@", "skip-parent", "identifier=s",
|
|
"no-clone-handling", "no-privilege-elevation", "force-delete", "no-clone-rollback", "no-rollback") or pod2usage(2);
|
|
|
|
my %compressargs = %{compressargset($args{'compress'} || 'default')}; # Can't be done with GetOptions arg, as default still needs to be set
|
|
|
|
# TODO Expand to accept multiple sources?
|
|
if (scalar(@ARGV) != 2) {
|
|
print("Source or target not found!\n");
|
|
pod2usage(2);
|
|
exit 127;
|
|
} else {
|
|
$args{'source'} = $ARGV[0];
|
|
$args{'target'} = $ARGV[1];
|
|
}
|
|
|
|
# Could possibly merge these into an options function
|
|
if (length $args{'source-bwlimit'}) {
|
|
$args{'source-bwlimit'} = "-R $args{'source-bwlimit'}";
|
|
}
|
|
if (length $args{'target-bwlimit'}) {
|
|
$args{'target-bwlimit'} = "-r $args{'target-bwlimit'}";
|
|
}
|
|
$args{'streamarg'} = (defined $args{'no-stream'} ? '-i' : '-I');
|
|
|
|
my $rawsourcefs = $args{'source'};
|
|
my $rawtargetfs = $args{'target'};
|
|
my $debug = $args{'debug'};
|
|
my $quiet = $args{'quiet'};
|
|
my $resume = !$args{'no-resume'};
|
|
|
|
my $zfscmd = '/sbin/zfs';
|
|
my $sshcmd = '/usr/bin/ssh';
|
|
my $pscmd = '/bin/ps';
|
|
|
|
my $pvcmd = '/usr/bin/pv';
|
|
my $mbuffercmd = '/usr/bin/mbuffer';
|
|
my $sudocmd = '/usr/bin/sudo';
|
|
my $mbufferoptions = '-q -s 128k -m 16M 2>/dev/null';
|
|
# currently using ls to check for file existence because we aren't depending on perl
|
|
# being present on remote machines.
|
|
my $lscmd = '/bin/ls';
|
|
|
|
if (length $args{'sshcipher'}) {
|
|
$args{'sshcipher'} = "-c $args{'sshcipher'}";
|
|
}
|
|
if (length $args{'sshport'}) {
|
|
$args{'sshport'} = "-p $args{'sshport'}";
|
|
}
|
|
if (length $args{'sshkey'}) {
|
|
$args{'sshkey'} = "-i $args{'sshkey'}";
|
|
}
|
|
my $sshoptions = join " ", map { "-o " . $_ } @{$args{'sshoption'}}; # deref required
|
|
|
|
my $identifier = "";
|
|
if (length $args{'identifier'}) {
|
|
if ($args{'identifier'} !~ /^[a-zA-Z0-9-_:.]+$/) {
|
|
# invalid extra identifier
|
|
print("CRITICAL: extra identifier contains invalid chars!\n");
|
|
pod2usage(2);
|
|
exit 127;
|
|
}
|
|
$identifier = "$args{'identifier'}_";
|
|
}
|
|
|
|
# figure out if source and/or target are remote.
|
|
$sshcmd = "$sshcmd $args{'sshcipher'} $sshoptions $args{'sshport'} $args{'sshkey'}";
|
|
if ($debug) { print "DEBUG: SSHCMD: $sshcmd\n"; }
|
|
my ($sourcehost,$sourcefs,$sourceisroot) = getssh($rawsourcefs);
|
|
my ($targethost,$targetfs,$targetisroot) = getssh($rawtargetfs);
|
|
|
|
my $sourcesudocmd = $sourceisroot ? '' : $sudocmd;
|
|
my $targetsudocmd = $targetisroot ? '' : $sudocmd;
|
|
|
|
# figure out whether compression, mbuffering, pv
|
|
# are available on source, target, local machines.
|
|
# warn user of anything missing, then continue with sync.
|
|
my %avail = checkcommands();
|
|
|
|
my %snaps;
|
|
my $exitcode = 0;
|
|
|
|
## break here to call replication individually so that we ##
|
|
## can loop across children separately, for recursive ##
|
|
## replication ##
|
|
|
|
if (!defined $args{'recursive'}) {
|
|
syncdataset($sourcehost, $sourcefs, $targethost, $targetfs, undef);
|
|
} else {
|
|
if ($debug) { print "DEBUG: recursive sync of $sourcefs.\n"; }
|
|
my @datasets = getchilddatasets($sourcehost, $sourcefs, $sourceisroot);
|
|
|
|
my @deferred;
|
|
|
|
foreach my $datasetProperties(@datasets) {
|
|
my $dataset = $datasetProperties->{'name'};
|
|
my $origin = $datasetProperties->{'origin'};
|
|
if ($origin eq "-" || defined $args{'no-clone-handling'}) {
|
|
$origin = undef;
|
|
} else {
|
|
# check if clone source is replicated too
|
|
my @values = split(/@/, $origin, 2);
|
|
my $srcdataset = $values[0];
|
|
|
|
my $found = 0;
|
|
foreach my $datasetProperties(@datasets) {
|
|
if ($datasetProperties->{'name'} eq $srcdataset) {
|
|
$found = 1;
|
|
last;
|
|
}
|
|
}
|
|
|
|
if ($found == 0) {
|
|
# clone source is not replicated, do a full replication
|
|
$origin = undef;
|
|
} else {
|
|
# clone source is replicated, defer until all non clones are replicated
|
|
push @deferred, $datasetProperties;
|
|
next;
|
|
}
|
|
}
|
|
|
|
$dataset =~ s/\Q$sourcefs\E//;
|
|
chomp $dataset;
|
|
my $childsourcefs = $sourcefs . $dataset;
|
|
my $childtargetfs = $targetfs . $dataset;
|
|
# print "syncdataset($sourcehost, $childsourcefs, $targethost, $childtargetfs); \n";
|
|
syncdataset($sourcehost, $childsourcefs, $targethost, $childtargetfs, $origin);
|
|
}
|
|
|
|
# replicate cloned datasets and if this is the initial run, recreate them on the target
|
|
foreach my $datasetProperties(@deferred) {
|
|
my $dataset = $datasetProperties->{'name'};
|
|
my $origin = $datasetProperties->{'origin'};
|
|
|
|
$dataset =~ s/\Q$sourcefs\E//;
|
|
chomp $dataset;
|
|
my $childsourcefs = $sourcefs . $dataset;
|
|
my $childtargetfs = $targetfs . $dataset;
|
|
syncdataset($sourcehost, $childsourcefs, $targethost, $childtargetfs, $origin);
|
|
}
|
|
}
|
|
|
|
# close SSH sockets for master connections as applicable
|
|
if ($sourcehost ne '') {
|
|
open FH, "$sshcmd $sourcehost -O exit 2>&1 |";
|
|
close FH;
|
|
}
|
|
if ($targethost ne '') {
|
|
open FH, "$sshcmd $targethost -O exit 2>&1 |";
|
|
close FH;
|
|
}
|
|
|
|
exit $exitcode;
|
|
|
|
##############################################################################
|
|
##############################################################################
|
|
##############################################################################
|
|
##############################################################################
|
|
|
|
sub getchilddatasets {
|
|
my ($rhost,$fs,$isroot,%snaps) = @_;
|
|
my $mysudocmd;
|
|
my $fsescaped = escapeshellparam($fs);
|
|
|
|
if ($isroot) { $mysudocmd = ''; } else { $mysudocmd = $sudocmd; }
|
|
if ($rhost ne '') {
|
|
$rhost = "$sshcmd $rhost";
|
|
# double escaping needed
|
|
$fsescaped = escapeshellparam($fsescaped);
|
|
}
|
|
|
|
my $getchildrencmd = "$rhost $mysudocmd $zfscmd list -o name,origin -t filesystem,volume -Hr $fsescaped |";
|
|
if ($debug) { print "DEBUG: getting list of child datasets on $fs using $getchildrencmd...\n"; }
|
|
if (! open FH, $getchildrencmd) {
|
|
die "ERROR: list command failed!\n";
|
|
}
|
|
|
|
my @children;
|
|
my $first = 1;
|
|
|
|
DATASETS: while(<FH>) {
|
|
chomp;
|
|
|
|
if (defined $args{'skip-parent'} && $first eq 1) {
|
|
# parent dataset is the first element
|
|
$first = 0;
|
|
next;
|
|
}
|
|
|
|
my ($dataset, $origin) = /^([^\t]+)\t([^\t]+)/;
|
|
|
|
if (defined $args{'exclude'}) {
|
|
my $excludes = $args{'exclude'};
|
|
foreach (@$excludes) {
|
|
print("$dataset\n");
|
|
if ($dataset =~ /$_/) {
|
|
if ($debug) { print "DEBUG: excluded $dataset because of $_\n"; }
|
|
next DATASETS;
|
|
}
|
|
}
|
|
}
|
|
|
|
my %properties;
|
|
$properties{'name'} = $dataset;
|
|
$properties{'origin'} = $origin;
|
|
|
|
push @children, \%properties;
|
|
}
|
|
close FH;
|
|
|
|
return @children;
|
|
}
|
|
|
|
sub syncdataset {
|
|
|
|
my ($sourcehost, $sourcefs, $targethost, $targetfs, $origin, $skipsnapshot) = @_;
|
|
|
|
my $sourcefsescaped = escapeshellparam($sourcefs);
|
|
my $targetfsescaped = escapeshellparam($targetfs);
|
|
|
|
# if no rollbacks are allowed, disable forced receive
|
|
my $forcedrecv = "-F";
|
|
if (defined $args{'no-rollback'}) {
|
|
$forcedrecv = "";
|
|
}
|
|
|
|
if ($debug) { print "DEBUG: syncing source $sourcefs to target $targetfs.\n"; }
|
|
|
|
my $sync = getzfsvalue($sourcehost,$sourcefs,$sourceisroot,'syncoid:sync');
|
|
|
|
if ($sync eq 'true' || $sync eq '-' || $sync eq '') {
|
|
# empty is handled the same as unset (aka: '-')
|
|
# definitely sync this dataset - if a host is called 'true' or '-', then you're special
|
|
} elsif ($sync eq 'false') {
|
|
if (!$quiet) { print "INFO: Skipping dataset (syncoid:sync=false): $sourcefs...\n"; }
|
|
return 0;
|
|
} else {
|
|
my $hostid = hostname();
|
|
my @hosts = split(/,/,$sync);
|
|
if (!(grep $hostid eq $_, @hosts)) {
|
|
if (!$quiet) { print "INFO: Skipping dataset (syncoid:sync doesn't include $hostid): $sourcefs...\n"; }
|
|
return 0;
|
|
}
|
|
}
|
|
|
|
# make sure target is not currently in receive.
|
|
if (iszfsbusy($targethost,$targetfs,$targetisroot)) {
|
|
warn "Cannot sync now: $targetfs is already target of a zfs receive process.\n";
|
|
if ($exitcode < 1) { $exitcode = 1; }
|
|
return 0;
|
|
}
|
|
|
|
# does the target filesystem exist yet?
|
|
my $targetexists = targetexists($targethost,$targetfs,$targetisroot);
|
|
|
|
my $receiveextraargs = "";
|
|
my $receivetoken;
|
|
if ($resume) {
|
|
# save state of interrupted receive stream
|
|
$receiveextraargs = "-s";
|
|
|
|
if ($targetexists) {
|
|
# check remote dataset for receive resume token (interrupted receive)
|
|
$receivetoken = getreceivetoken($targethost,$targetfs,$targetisroot);
|
|
|
|
if ($debug && defined($receivetoken)) {
|
|
print "DEBUG: got receive resume token: $receivetoken: \n";
|
|
}
|
|
}
|
|
}
|
|
|
|
my $newsyncsnap;
|
|
|
|
# skip snapshot checking/creation in case of resumed receive
|
|
if (!defined($receivetoken)) {
|
|
# build hashes of the snaps on the source and target filesystems.
|
|
|
|
%snaps = getsnaps('source',$sourcehost,$sourcefs,$sourceisroot);
|
|
|
|
if ($targetexists) {
|
|
my %targetsnaps = getsnaps('target',$targethost,$targetfs,$targetisroot);
|
|
my %sourcesnaps = %snaps;
|
|
%snaps = (%sourcesnaps, %targetsnaps);
|
|
}
|
|
|
|
if (defined $args{'dumpsnaps'}) {
|
|
print "merged snapshot list of $targetfs: \n";
|
|
dumphash(\%snaps);
|
|
print "\n\n\n";
|
|
}
|
|
|
|
if (!defined $args{'no-sync-snap'} && !defined $skipsnapshot) {
|
|
# create a new syncoid snapshot on the source filesystem.
|
|
$newsyncsnap = newsyncsnap($sourcehost,$sourcefs,$sourceisroot);
|
|
if (!$newsyncsnap) {
|
|
# we already whined about the error
|
|
return 0;
|
|
}
|
|
} else {
|
|
# we don't want sync snapshots created, so use the newest snapshot we can find.
|
|
$newsyncsnap = getnewestsnapshot($sourcehost,$sourcefs,$sourceisroot);
|
|
if ($newsyncsnap eq 0) {
|
|
warn "CRITICAL: no snapshots exist on source $sourcefs, and you asked for --no-sync-snap.\n";
|
|
if ($exitcode < 1) { $exitcode = 1; }
|
|
return 0;
|
|
}
|
|
}
|
|
}
|
|
my $newsyncsnapescaped = escapeshellparam($newsyncsnap);
|
|
|
|
# there is currently (2014-09-01) a bug in ZFS on Linux
|
|
# that causes readonly to always show on if it's EVER
|
|
# been turned on... even when it's off... unless and
|
|
# until the filesystem is zfs umounted and zfs remounted.
|
|
# we're going to do the right thing anyway.
|
|
# dyking this functionality out for the time being due to buggy mount/unmount behavior
|
|
# with ZFS on Linux (possibly OpenZFS in general) when setting/unsetting readonly.
|
|
#my $originaltargetreadonly;
|
|
|
|
# sync 'em up.
|
|
if (! $targetexists) {
|
|
# do an initial sync from the oldest source snapshot
|
|
# THEN do an -I to the newest
|
|
if ($debug) {
|
|
if (!defined ($args{'no-stream'}) ) {
|
|
print "DEBUG: target $targetfs does not exist. Finding oldest available snapshot on source $sourcefs ...\n";
|
|
} else {
|
|
print "DEBUG: target $targetfs does not exist, and --no-stream selected. Finding newest available snapshot on source $sourcefs ...\n";
|
|
}
|
|
}
|
|
my $oldestsnap = getoldestsnapshot(\%snaps);
|
|
if (! $oldestsnap) {
|
|
if (defined ($args{'no-sync-snap'}) ) {
|
|
# we already whined about the missing snapshots
|
|
return 0;
|
|
}
|
|
|
|
# getoldestsnapshot() returned false, so use new sync snapshot
|
|
if ($debug) { print "DEBUG: getoldestsnapshot() returned false, so using $newsyncsnap.\n"; }
|
|
$oldestsnap = $newsyncsnap;
|
|
}
|
|
|
|
# if --no-stream is specified, our full needs to be the newest snapshot, not the oldest.
|
|
if (defined $args{'no-stream'}) { $oldestsnap = getnewestsnapshot(\%snaps); }
|
|
my $oldestsnapescaped = escapeshellparam($oldestsnap);
|
|
|
|
my $sendcmd = "$sourcesudocmd $zfscmd send $sourcefsescaped\@$oldestsnapescaped";
|
|
my $recvcmd = "$targetsudocmd $zfscmd receive $receiveextraargs $forcedrecv $targetfsescaped";
|
|
|
|
my $pvsize;
|
|
if (defined $origin) {
|
|
my $originescaped = escapeshellparam($origin);
|
|
$sendcmd = "$sourcesudocmd $zfscmd send -i $originescaped $sourcefsescaped\@$oldestsnapescaped";
|
|
my $streamargBackup = $args{'streamarg'};
|
|
$args{'streamarg'} = "-i";
|
|
$pvsize = getsendsize($sourcehost,$origin,"$sourcefs\@$oldestsnap",$sourceisroot);
|
|
$args{'streamarg'} = $streamargBackup;
|
|
} else {
|
|
$pvsize = getsendsize($sourcehost,"$sourcefs\@$oldestsnap",0,$sourceisroot);
|
|
}
|
|
|
|
my $disp_pvsize = readablebytes($pvsize);
|
|
if ($pvsize == 0) { $disp_pvsize = 'UNKNOWN'; }
|
|
my $synccmd = buildsynccmd($sendcmd,$recvcmd,$pvsize,$sourceisroot,$targetisroot);
|
|
if (!$quiet) {
|
|
if (defined $origin) {
|
|
print "INFO: Clone is recreated on target $targetfs based on $origin\n";
|
|
}
|
|
if (!defined ($args{'no-stream'}) ) {
|
|
print "INFO: Sending oldest full snapshot $sourcefs\@$oldestsnap (~ $disp_pvsize) to new target filesystem:\n";
|
|
} else {
|
|
print "INFO: --no-stream selected; sending newest full snapshot $sourcefs\@$oldestsnap (~ $disp_pvsize) to new target filesystem:\n";
|
|
}
|
|
}
|
|
if ($debug) { print "DEBUG: $synccmd\n"; }
|
|
|
|
# make sure target is (still) not currently in receive.
|
|
if (iszfsbusy($targethost,$targetfs,$targetisroot)) {
|
|
warn "Cannot sync now: $targetfs is already target of a zfs receive process.\n";
|
|
if ($exitcode < 1) { $exitcode = 1; }
|
|
return 0;
|
|
}
|
|
system($synccmd) == 0 or do {
|
|
warn "CRITICAL ERROR: $synccmd failed: $?";
|
|
if ($exitcode < 2) { $exitcode = 2; }
|
|
return 0;
|
|
};
|
|
|
|
# now do an -I to the new sync snapshot, assuming there were any snapshots
|
|
# other than the new sync snapshot to begin with, of course - and that we
|
|
# aren't invoked with --no-stream, in which case a full of the newest snap
|
|
# available was all we needed to do
|
|
if (!defined ($args{'no-stream'}) && ($oldestsnap ne $newsyncsnap) ) {
|
|
|
|
# get current readonly status of target, then set it to on during sync
|
|
# dyking this functionality out for the time being due to buggy mount/unmount behavior
|
|
# with ZFS on Linux (possibly OpenZFS in general) when setting/unsetting readonly.
|
|
# $originaltargetreadonly = getzfsvalue($targethost,$targetfs,$targetisroot,'readonly');
|
|
# setzfsvalue($targethost,$targetfs,$targetisroot,'readonly','on');
|
|
|
|
$sendcmd = "$sourcesudocmd $zfscmd send $args{'streamarg'} $sourcefsescaped\@$oldestsnapescaped $sourcefsescaped\@$newsyncsnapescaped";
|
|
$pvsize = getsendsize($sourcehost,"$sourcefs\@$oldestsnap","$sourcefs\@$newsyncsnap",$sourceisroot);
|
|
$disp_pvsize = readablebytes($pvsize);
|
|
if ($pvsize == 0) { $disp_pvsize = "UNKNOWN"; }
|
|
$synccmd = buildsynccmd($sendcmd,$recvcmd,$pvsize,$sourceisroot,$targetisroot);
|
|
|
|
# make sure target is (still) not currently in receive.
|
|
if (iszfsbusy($targethost,$targetfs,$targetisroot)) {
|
|
warn "Cannot sync now: $targetfs is already target of a zfs receive process.\n";
|
|
if ($exitcode < 1) { $exitcode = 1; }
|
|
return 0;
|
|
}
|
|
|
|
if (!$quiet) { print "INFO: Updating new target filesystem with incremental $sourcefs\@$oldestsnap ... $newsyncsnap (~ $disp_pvsize):\n"; }
|
|
if ($debug) { print "DEBUG: $synccmd\n"; }
|
|
|
|
if ($oldestsnap ne $newsyncsnap) {
|
|
my $ret = system($synccmd);
|
|
if ($ret != 0) {
|
|
warn "CRITICAL ERROR: $synccmd failed: $?";
|
|
if ($exitcode < 1) { $exitcode = 1; }
|
|
return 0;
|
|
}
|
|
} else {
|
|
if (!$quiet) { print "INFO: no incremental sync needed; $oldestsnap is already the newest available snapshot.\n"; }
|
|
}
|
|
|
|
# restore original readonly value to target after sync complete
|
|
# dyking this functionality out for the time being due to buggy mount/unmount behavior
|
|
# with ZFS on Linux (possibly OpenZFS in general) when setting/unsetting readonly.
|
|
# setzfsvalue($targethost,$targetfs,$targetisroot,'readonly',$originaltargetreadonly);
|
|
}
|
|
} else {
|
|
# resume interrupted receive if there is a valid resume $token
|
|
# and because this will ony resume the receive to the next
|
|
# snapshot, do a normal sync after that
|
|
if (defined($receivetoken)) {
|
|
my $sendcmd = "$sourcesudocmd $zfscmd send -t $receivetoken";
|
|
my $recvcmd = "$targetsudocmd $zfscmd receive $receiveextraargs $forcedrecv $targetfsescaped";
|
|
my $pvsize = getsendsize($sourcehost,"","",$sourceisroot,$receivetoken);
|
|
my $disp_pvsize = readablebytes($pvsize);
|
|
if ($pvsize == 0) { $disp_pvsize = "UNKNOWN"; }
|
|
my $synccmd = buildsynccmd($sendcmd,$recvcmd,$pvsize,$sourceisroot,$targetisroot);
|
|
|
|
if (!$quiet) { print "Resuming interrupted zfs send/receive from $sourcefs to $targetfs (~ $disp_pvsize remaining):\n"; }
|
|
if ($debug) { print "DEBUG: $synccmd\n"; }
|
|
system("$synccmd") == 0 or do {
|
|
warn "CRITICAL ERROR: $synccmd failed: $?";
|
|
if ($exitcode < 2) { $exitcode = 2; }
|
|
return 0;
|
|
};
|
|
|
|
# a resumed transfer will only be done to the next snapshot,
|
|
# so do an normal sync cycle
|
|
return syncdataset($sourcehost, $sourcefs, $targethost, $targetfs, undef);
|
|
}
|
|
|
|
# find most recent matching snapshot and do an -I
|
|
# to the new snapshot
|
|
|
|
# get current readonly status of target, then set it to on during sync
|
|
# dyking this functionality out for the time being due to buggy mount/unmount behavior
|
|
# with ZFS on Linux (possibly OpenZFS in general) when setting/unsetting readonly.
|
|
# $originaltargetreadonly = getzfsvalue($targethost,$targetfs,$targetisroot,'readonly');
|
|
# setzfsvalue($targethost,$targetfs,$targetisroot,'readonly','on');
|
|
|
|
my $targetsize = getzfsvalue($targethost,$targetfs,$targetisroot,'-p used');
|
|
|
|
my $bookmark = 0;
|
|
my $bookmarkcreation = 0;
|
|
|
|
my $matchingsnap = getmatchingsnapshot($sourcefs, $targetfs, \%snaps);
|
|
if (! $matchingsnap) {
|
|
# no matching snapshots, check for bookmarks as fallback
|
|
my %bookmarks = getbookmarks($sourcehost,$sourcefs,$sourceisroot);
|
|
|
|
# check for matching guid of source bookmark and target snapshot (oldest first)
|
|
foreach my $snap ( sort { $snaps{'target'}{$b}{'creation'}<=>$snaps{'target'}{$a}{'creation'} } keys %{ $snaps{'target'} }) {
|
|
my $guid = $snaps{'target'}{$snap}{'guid'};
|
|
|
|
if (defined $bookmarks{$guid}) {
|
|
# found a match
|
|
$bookmark = $bookmarks{$guid}{'name'};
|
|
$bookmarkcreation = $bookmarks{$guid}{'creation'};
|
|
$matchingsnap = $snap;
|
|
last;
|
|
}
|
|
}
|
|
|
|
if (! $bookmark) {
|
|
if ($args{'force-delete'}) {
|
|
if (!$quiet) { print "Removing $targetfs because no matching snapshots were found\n"; }
|
|
|
|
my $rcommand = '';
|
|
my $mysudocmd = '';
|
|
my $targetfsescaped = escapeshellparam($targetfs);
|
|
|
|
if ($targethost ne '') { $rcommand = "$sshcmd $targethost"; }
|
|
if (!$targetisroot) { $mysudocmd = $sudocmd; }
|
|
|
|
my $prunecmd = "$mysudocmd $zfscmd destroy -r $targetfsescaped; ";
|
|
if ($targethost ne '') {
|
|
$prunecmd = escapeshellparam($prunecmd);
|
|
}
|
|
|
|
my $ret = system("$rcommand $prunecmd");
|
|
if ($ret != 0) {
|
|
warn "WARNING: $rcommand $prunecmd failed: $?";
|
|
} else {
|
|
# redo sync and skip snapshot creation (already taken)
|
|
return syncdataset($sourcehost, $sourcefs, $targethost, $targetfs, undef, 1);
|
|
}
|
|
}
|
|
|
|
# if we got this far, we failed to find a matching snapshot/bookmark.
|
|
if ($exitcode < 2) { $exitcode = 2; }
|
|
|
|
print "\n";
|
|
print "CRITICAL ERROR: Target $targetfs exists but has no snapshots matching with $sourcefs!\n";
|
|
print " Replication to target would require destroying existing\n";
|
|
print " target. Cowardly refusing to destroy your existing target.\n\n";
|
|
|
|
# experience tells me we need a mollyguard for people who try to
|
|
# zfs create targetpool/targetsnap ; syncoid sourcepool/sourcesnap targetpool/targetsnap ...
|
|
|
|
if ( $targetsize < (64*1024*1024) ) {
|
|
print " NOTE: Target $targetfs dataset is < 64MB used - did you mistakenly run\n";
|
|
print " \`zfs create $args{'target'}\` on the target? ZFS initial\n";
|
|
print " replication must be to a NON EXISTENT DATASET, which will\n";
|
|
print " then be CREATED BY the initial replication process.\n\n";
|
|
}
|
|
|
|
# return false now in case more child datasets need replication.
|
|
return 0;
|
|
}
|
|
}
|
|
|
|
# make sure target is (still) not currently in receive.
|
|
if (iszfsbusy($targethost,$targetfs,$targetisroot)) {
|
|
warn "Cannot sync now: $targetfs is already target of a zfs receive process.\n";
|
|
if ($exitcode < 1) { $exitcode = 1; }
|
|
return 0;
|
|
}
|
|
|
|
if ($matchingsnap eq $newsyncsnap) {
|
|
# barf some text but don't touch the filesystem
|
|
if (!$quiet) { print "INFO: no snapshots on source newer than $newsyncsnap on target. Nothing to do, not syncing.\n"; }
|
|
} else {
|
|
my $matchingsnapescaped = escapeshellparam($matchingsnap);
|
|
# rollback target to matchingsnap
|
|
if (!defined $args{'no-rollback'}) {
|
|
my $rollbacktype = "-R";
|
|
if (defined $args{'no-clone-rollback'}) {
|
|
$rollbacktype = "-r";
|
|
}
|
|
if ($debug) { print "DEBUG: rolling back target to $targetfs\@$matchingsnap...\n"; }
|
|
if ($targethost ne '') {
|
|
if ($debug) { print "$sshcmd $targethost $targetsudocmd $zfscmd rollback $rollbacktype $targetfsescaped\@$matchingsnapescaped\n"; }
|
|
system ("$sshcmd $targethost " . escapeshellparam("$targetsudocmd $zfscmd rollback $rollbacktype $targetfsescaped\@$matchingsnapescaped"));
|
|
} else {
|
|
if ($debug) { print "$targetsudocmd $zfscmd rollback $rollbacktype $targetfsescaped\@$matchingsnapescaped\n"; }
|
|
system ("$targetsudocmd $zfscmd rollback $rollbacktype $targetfsescaped\@$matchingsnapescaped");
|
|
}
|
|
}
|
|
|
|
my $nextsnapshot = 0;
|
|
|
|
if ($bookmark) {
|
|
my $bookmarkescaped = escapeshellparam($bookmark);
|
|
|
|
if (!defined $args{'no-stream'}) {
|
|
# if intermediate snapshots are needed we need to find the next oldest snapshot,
|
|
# do an replication to it and replicate as always from oldest to newest
|
|
# because bookmark sends doesn't support intermediates directly
|
|
foreach my $snap ( sort { $snaps{'source'}{$a}{'creation'}<=>$snaps{'source'}{$b}{'creation'} } keys %{ $snaps{'source'} }) {
|
|
if ($snaps{'source'}{$snap}{'creation'} >= $bookmarkcreation) {
|
|
$nextsnapshot = $snap;
|
|
last;
|
|
}
|
|
}
|
|
}
|
|
|
|
# bookmark stream size can't be determined
|
|
my $pvsize = 0;
|
|
my $disp_pvsize = "UNKNOWN";
|
|
|
|
if ($nextsnapshot) {
|
|
my $nextsnapshotescaped = escapeshellparam($nextsnapshot);
|
|
|
|
my $sendcmd = "$sourcesudocmd $zfscmd send -i $sourcefsescaped#$bookmarkescaped $sourcefsescaped\@$nextsnapshotescaped";
|
|
my $recvcmd = "$targetsudocmd $zfscmd receive $receiveextraargs $forcedrecv $targetfsescaped";
|
|
my $synccmd = buildsynccmd($sendcmd,$recvcmd,$pvsize,$sourceisroot,$targetisroot);
|
|
|
|
if (!$quiet) { print "Sending incremental $sourcefs#$bookmarkescaped ... $nextsnapshot (~ $disp_pvsize):\n"; }
|
|
if ($debug) { print "DEBUG: $synccmd\n"; }
|
|
system("$synccmd") == 0 or do {
|
|
warn "CRITICAL ERROR: $synccmd failed: $?";
|
|
if ($exitcode < 2) { $exitcode = 2; }
|
|
return 0;
|
|
};
|
|
|
|
$matchingsnap = $nextsnapshot;
|
|
$matchingsnapescaped = escapeshellparam($matchingsnap);
|
|
} else {
|
|
my $sendcmd = "$sourcesudocmd $zfscmd send -i $sourcefsescaped#$bookmarkescaped $sourcefsescaped\@$newsyncsnapescaped";
|
|
my $recvcmd = "$targetsudocmd $zfscmd receive $receiveextraargs $forcedrecv $targetfsescaped";
|
|
my $synccmd = buildsynccmd($sendcmd,$recvcmd,$pvsize,$sourceisroot,$targetisroot);
|
|
|
|
if (!$quiet) { print "Sending incremental $sourcefs#$bookmarkescaped ... $newsyncsnap (~ $disp_pvsize):\n"; }
|
|
if ($debug) { print "DEBUG: $synccmd\n"; }
|
|
system("$synccmd") == 0 or do {
|
|
warn "CRITICAL ERROR: $synccmd failed: $?";
|
|
if ($exitcode < 2) { $exitcode = 2; }
|
|
return 0;
|
|
};
|
|
}
|
|
}
|
|
|
|
# do a normal replication if bookmarks aren't used or if previous
|
|
# bookmark replication was only done to the next oldest snapshot
|
|
if (!$bookmark || $nextsnapshot) {
|
|
my $sendcmd = "$sourcesudocmd $zfscmd send $args{'streamarg'} $sourcefsescaped\@$matchingsnapescaped $sourcefsescaped\@$newsyncsnapescaped";
|
|
my $recvcmd = "$targetsudocmd $zfscmd receive $receiveextraargs $forcedrecv $targetfsescaped";
|
|
my $pvsize = getsendsize($sourcehost,"$sourcefs\@$matchingsnap","$sourcefs\@$newsyncsnap",$sourceisroot);
|
|
my $disp_pvsize = readablebytes($pvsize);
|
|
if ($pvsize == 0) { $disp_pvsize = "UNKNOWN"; }
|
|
my $synccmd = buildsynccmd($sendcmd,$recvcmd,$pvsize,$sourceisroot,$targetisroot);
|
|
|
|
if (!$quiet) { print "Sending incremental $sourcefs\@$matchingsnap ... $newsyncsnap (~ $disp_pvsize):\n"; }
|
|
if ($debug) { print "DEBUG: $synccmd\n"; }
|
|
system("$synccmd") == 0 or do {
|
|
warn "CRITICAL ERROR: $synccmd failed: $?";
|
|
if ($exitcode < 2) { $exitcode = 2; }
|
|
return 0;
|
|
};
|
|
}
|
|
|
|
# restore original readonly value to target after sync complete
|
|
# dyking this functionality out for the time being due to buggy mount/unmount behavior
|
|
# with ZFS on Linux (possibly OpenZFS in general) when setting/unsetting readonly.
|
|
#setzfsvalue($targethost,$targetfs,$targetisroot,'readonly',$originaltargetreadonly);
|
|
}
|
|
}
|
|
|
|
if (!defined $args{'no-sync-snap'}) {
|
|
# prune obsolete sync snaps on source and target (only if this run created ones).
|
|
pruneoldsyncsnaps($sourcehost,$sourcefs,$newsyncsnap,$sourceisroot,keys %{ $snaps{'source'}});
|
|
pruneoldsyncsnaps($targethost,$targetfs,$newsyncsnap,$targetisroot,keys %{ $snaps{'target'}});
|
|
}
|
|
|
|
} # end syncdataset()
|
|
|
|
sub compressargset {
|
|
my ($value) = @_;
|
|
my $DEFAULT_COMPRESSION = 'lzo';
|
|
my %COMPRESS_ARGS = (
|
|
'none' => {
|
|
rawcmd => '',
|
|
args => '',
|
|
decomrawcmd => '',
|
|
decomargs => '',
|
|
},
|
|
'gzip' => {
|
|
rawcmd => '/bin/gzip',
|
|
args => '-3',
|
|
decomrawcmd => '/bin/zcat',
|
|
decomargs => '',
|
|
},
|
|
'pigz-fast' => {
|
|
rawcmd => '/usr/bin/pigz',
|
|
args => '-3',
|
|
decomrawcmd => '/usr/bin/pigz',
|
|
decomargs => '-dc',
|
|
},
|
|
'pigz-slow' => {
|
|
rawcmd => '/usr/bin/pigz',
|
|
args => '-9',
|
|
decomrawcmd => '/usr/bin/pigz',
|
|
decomargs => '-dc',
|
|
},
|
|
'zstd-fast' => {
|
|
rawcmd => '/usr/bin/zstd',
|
|
args => '-3',
|
|
decomrawcmd => '/usr/bin/zstd',
|
|
decomargs => '-dc',
|
|
},
|
|
'zstd-slow' => {
|
|
rawcmd => '/usr/bin/zstd',
|
|
args => '-19',
|
|
decomrawcmd => '/usr/bin/zstd',
|
|
decomargs => '-dc',
|
|
},
|
|
'xz' => {
|
|
rawcmd => '/usr/bin/xz',
|
|
args => '',
|
|
decomrawcmd => '/usr/bin/xz',
|
|
decomargs => '-d',
|
|
},
|
|
'lzo' => {
|
|
rawcmd => '/usr/bin/lzop',
|
|
args => '',
|
|
decomrawcmd => '/usr/bin/lzop',
|
|
decomargs => '-dfc',
|
|
},
|
|
'lz4' => {
|
|
rawcmd => '/usr/bin/lz4',
|
|
args => '',
|
|
decomrawcmd => '/usr/bin/lz4',
|
|
decomargs => '-dc',
|
|
},
|
|
);
|
|
|
|
if ($value eq 'default') {
|
|
$value = $DEFAULT_COMPRESSION;
|
|
} elsif (!(grep $value eq $_, ('gzip', 'pigz-fast', 'pigz-slow', 'zstd-fast', 'zstd-slow', 'lz4', 'xz', 'lzo', 'default', 'none'))) {
|
|
warn "Unrecognised compression value $value, defaulting to $DEFAULT_COMPRESSION";
|
|
$value = $DEFAULT_COMPRESSION;
|
|
}
|
|
|
|
my %comargs = %{$COMPRESS_ARGS{$value}}; # copy
|
|
$comargs{'compress'} = $value;
|
|
$comargs{'cmd'} = "$comargs{'rawcmd'} $comargs{'args'}";
|
|
$comargs{'decomcmd'} = "$comargs{'decomrawcmd'} $comargs{'decomargs'}";
|
|
return \%comargs;
|
|
}
|
|
|
|
sub checkcommands {
|
|
# make sure compression, mbuffer, and pv are available on
|
|
# source, target, and local hosts as appropriate.
|
|
|
|
my %avail;
|
|
my $sourcessh;
|
|
my $targetssh;
|
|
|
|
# if --nocommandchecks then assume everything's available and return
|
|
if ($args{'nocommandchecks'}) {
|
|
if ($debug) { print "DEBUG: not checking for command availability due to --nocommandchecks switch.\n"; }
|
|
$avail{'compress'} = 1;
|
|
$avail{'localpv'} = 1;
|
|
$avail{'localmbuffer'} = 1;
|
|
$avail{'sourcembuffer'} = 1;
|
|
$avail{'targetmbuffer'} = 1;
|
|
$avail{'sourceresume'} = 1;
|
|
$avail{'targetresume'} = 1;
|
|
return %avail;
|
|
}
|
|
|
|
if (!defined $sourcehost) { $sourcehost = ''; }
|
|
if (!defined $targethost) { $targethost = ''; }
|
|
|
|
if ($sourcehost ne '') { $sourcessh = "$sshcmd $sourcehost"; } else { $sourcessh = ''; }
|
|
if ($targethost ne '') { $targetssh = "$sshcmd $targethost"; } else { $targetssh = ''; }
|
|
|
|
# if raw compress command is null, we must have specified no compression. otherwise,
|
|
# make sure that compression is available everywhere we need it
|
|
if ($compressargs{'compress'} eq 'none') {
|
|
if ($debug) { print "DEBUG: compression forced off from command line arguments.\n"; }
|
|
} else {
|
|
if ($debug) { print "DEBUG: checking availability of $compressargs{'rawcmd'} on source...\n"; }
|
|
$avail{'sourcecompress'} = `$sourcessh $lscmd $compressargs{'rawcmd'} 2>/dev/null`;
|
|
if ($debug) { print "DEBUG: checking availability of $compressargs{'rawcmd'} on target...\n"; }
|
|
$avail{'targetcompress'} = `$targetssh $lscmd $compressargs{'rawcmd'} 2>/dev/null`;
|
|
if ($debug) { print "DEBUG: checking availability of $compressargs{'rawcmd'} on local machine...\n"; }
|
|
$avail{'localcompress'} = `$lscmd $compressargs{'rawcmd'} 2>/dev/null`;
|
|
}
|
|
|
|
my ($s,$t);
|
|
if ($sourcehost eq '') {
|
|
$s = '[local machine]'
|
|
} else {
|
|
$s = $sourcehost;
|
|
$s =~ s/^\S*\@//;
|
|
$s = "ssh:$s";
|
|
}
|
|
if ($targethost eq '') {
|
|
$t = '[local machine]'
|
|
} else {
|
|
$t = $targethost;
|
|
$t =~ s/^\S*\@//;
|
|
$t = "ssh:$t";
|
|
}
|
|
|
|
if (!defined $avail{'sourcecompress'}) { $avail{'sourcecompress'} = ''; }
|
|
if (!defined $avail{'targetcompress'}) { $avail{'targetcompress'} = ''; }
|
|
if (!defined $avail{'sourcembuffer'}) { $avail{'sourcembuffer'} = ''; }
|
|
if (!defined $avail{'targetmbuffer'}) { $avail{'targetmbuffer'} = ''; }
|
|
|
|
|
|
if ($avail{'sourcecompress'} eq '') {
|
|
if ($compressargs{'rawcmd'} ne '') {
|
|
print "WARN: $compressargs{'rawcmd'} not available on source $s- sync will continue without compression.\n";
|
|
}
|
|
$avail{'compress'} = 0;
|
|
}
|
|
if ($avail{'targetcompress'} eq '') {
|
|
if ($compressargs{'rawcmd'} ne '') {
|
|
print "WARN: $compressargs{'rawcmd'} not available on target $t - sync will continue without compression.\n";
|
|
}
|
|
$avail{'compress'} = 0;
|
|
}
|
|
if ($avail{'targetcompress'} ne '' && $avail{'sourcecompress'} ne '') {
|
|
# compression available - unless source and target are both remote, which we'll check
|
|
# for in the next block and respond to accordingly.
|
|
$avail{'compress'} = 1;
|
|
}
|
|
|
|
# corner case - if source AND target are BOTH remote, we have to check for local compress too
|
|
if ($sourcehost ne '' && $targethost ne '' && $avail{'localcompress'} eq '') {
|
|
if ($compressargs{'rawcmd'} ne '') {
|
|
print "WARN: $compressargs{'rawcmd'} not available on local machine - sync will continue without compression.\n";
|
|
}
|
|
$avail{'compress'} = 0;
|
|
}
|
|
|
|
if ($debug) { print "DEBUG: checking availability of $mbuffercmd on source...\n"; }
|
|
$avail{'sourcembuffer'} = `$sourcessh $lscmd $mbuffercmd 2>/dev/null`;
|
|
if ($avail{'sourcembuffer'} eq '') {
|
|
if (!$quiet) { print "WARN: $mbuffercmd not available on source $s - sync will continue without source buffering.\n"; }
|
|
$avail{'sourcembuffer'} = 0;
|
|
} else {
|
|
$avail{'sourcembuffer'} = 1;
|
|
}
|
|
|
|
if ($debug) { print "DEBUG: checking availability of $mbuffercmd on target...\n"; }
|
|
$avail{'targetmbuffer'} = `$targetssh $lscmd $mbuffercmd 2>/dev/null`;
|
|
if ($avail{'targetmbuffer'} eq '') {
|
|
if (!$quiet) { print "WARN: $mbuffercmd not available on target $t - sync will continue without target buffering.\n"; }
|
|
$avail{'targetmbuffer'} = 0;
|
|
} else {
|
|
$avail{'targetmbuffer'} = 1;
|
|
}
|
|
|
|
# if we're doing remote source AND remote target, check for local mbuffer as well
|
|
if ($sourcehost ne '' && $targethost ne '') {
|
|
if ($debug) { print "DEBUG: checking availability of $mbuffercmd on local machine...\n"; }
|
|
$avail{'localmbuffer'} = `$lscmd $mbuffercmd 2>/dev/null`;
|
|
if ($avail{'localmbuffer'} eq '') {
|
|
$avail{'localmbuffer'} = 0;
|
|
if (!$quiet) { print "WARN: $mbuffercmd not available on local machine - sync will continue without local buffering.\n"; }
|
|
}
|
|
}
|
|
|
|
if ($debug) { print "DEBUG: checking availability of $pvcmd on local machine...\n"; }
|
|
$avail{'localpv'} = `$lscmd $pvcmd 2>/dev/null`;
|
|
if ($avail{'localpv'} eq '') {
|
|
if (!$quiet) { print "WARN: $pvcmd not available on local machine - sync will continue without progress bar.\n"; }
|
|
$avail{'localpv'} = 0;
|
|
} else {
|
|
$avail{'localpv'} = 1;
|
|
}
|
|
|
|
# check for ZFS resume feature support
|
|
if ($resume) {
|
|
my $resumechkcmd = "$zfscmd get -d 0 receive_resume_token";
|
|
|
|
if ($debug) { print "DEBUG: checking availability of zfs resume feature on source...\n"; }
|
|
$avail{'sourceresume'} = system("$sourcessh $resumechkcmd >/dev/null 2>&1");
|
|
$avail{'sourceresume'} = $avail{'sourceresume'} == 0 ? 1 : 0;
|
|
|
|
if ($debug) { print "DEBUG: checking availability of zfs resume feature on target...\n"; }
|
|
$avail{'targetresume'} = system("$targetssh $resumechkcmd >/dev/null 2>&1");
|
|
$avail{'targetresume'} = $avail{'targetresume'} == 0 ? 1 : 0;
|
|
|
|
if ($avail{'sourceresume'} == 0 || $avail{'targetresume'} == 0) {
|
|
# disable resume
|
|
$resume = '';
|
|
|
|
my @hosts = ();
|
|
if ($avail{'sourceresume'} == 0) {
|
|
push @hosts, 'source';
|
|
}
|
|
if ($avail{'targetresume'} == 0) {
|
|
push @hosts, 'target';
|
|
}
|
|
my $affected = join(" and ", @hosts);
|
|
print "WARN: ZFS resume feature not available on $affected machine - sync will continue without resume support.\n";
|
|
}
|
|
} else {
|
|
$avail{'sourceresume'} = 0;
|
|
$avail{'targetresume'} = 0;
|
|
}
|
|
|
|
return %avail;
|
|
}
|
|
|
|
sub iszfsbusy {
|
|
my ($rhost,$fs,$isroot) = @_;
|
|
if ($rhost ne '') { $rhost = "$sshcmd $rhost"; }
|
|
if ($debug) { print "DEBUG: checking to see if $fs on $rhost is already in zfs receive using $rhost $pscmd -Ao args= ...\n"; }
|
|
|
|
open PL, "$rhost $pscmd -Ao args= |";
|
|
my @processes = <PL>;
|
|
close PL;
|
|
|
|
foreach my $process (@processes) {
|
|
# if ($debug) { print "DEBUG: checking process $process...\n"; }
|
|
if ($process =~ /zfs *(receive|recv).*\Q$fs\E/) {
|
|
# there's already a zfs receive process for our target filesystem - return true
|
|
if ($debug) { print "DEBUG: process $process matches target $fs!\n"; }
|
|
return 1;
|
|
}
|
|
}
|
|
|
|
# no zfs receive processes for our target filesystem found - return false
|
|
return 0;
|
|
}
|
|
|
|
sub setzfsvalue {
|
|
my ($rhost,$fs,$isroot,$property,$value) = @_;
|
|
|
|
my $fsescaped = escapeshellparam($fs);
|
|
|
|
if ($rhost ne '') {
|
|
$rhost = "$sshcmd $rhost";
|
|
# double escaping needed
|
|
$fsescaped = escapeshellparam($fsescaped);
|
|
}
|
|
|
|
if ($debug) { print "DEBUG: setting $property to $value on $fs...\n"; }
|
|
my $mysudocmd;
|
|
if ($isroot) { $mysudocmd = ''; } else { $mysudocmd = $sudocmd; }
|
|
if ($debug) { print "$rhost $mysudocmd $zfscmd set $property=$value $fsescaped\n"; }
|
|
system("$rhost $mysudocmd $zfscmd set $property=$value $fsescaped") == 0
|
|
or warn "WARNING: $rhost $mysudocmd $zfscmd set $property=$value $fsescaped died: $?, proceeding anyway.\n";
|
|
return;
|
|
}
|
|
|
|
sub getzfsvalue {
|
|
my ($rhost,$fs,$isroot,$property) = @_;
|
|
|
|
my $fsescaped = escapeshellparam($fs);
|
|
|
|
if ($rhost ne '') {
|
|
$rhost = "$sshcmd $rhost";
|
|
# double escaping needed
|
|
$fsescaped = escapeshellparam($fsescaped);
|
|
}
|
|
|
|
if ($debug) { print "DEBUG: getting current value of $property on $fs...\n"; }
|
|
my $mysudocmd;
|
|
if ($isroot) { $mysudocmd = ''; } else { $mysudocmd = $sudocmd; }
|
|
if ($debug) { print "$rhost $mysudocmd $zfscmd get -H $property $fsescaped\n"; }
|
|
open FH, "$rhost $mysudocmd $zfscmd get -H $property $fsescaped |";
|
|
my $value = <FH>;
|
|
close FH;
|
|
my @values = split(/\t/,$value);
|
|
$value = $values[2];
|
|
return $value;
|
|
}
|
|
|
|
sub readablebytes {
|
|
my $bytes = shift;
|
|
my $disp;
|
|
|
|
if ($bytes > 1024*1024*1024) {
|
|
$disp = sprintf("%.1f",$bytes/1024/1024/1024) . ' GB';
|
|
} elsif ($bytes > 1024*1024) {
|
|
$disp = sprintf("%.1f",$bytes/1024/1024) . ' MB';
|
|
} else {
|
|
$disp = sprintf("%d",$bytes/1024) . ' KB';
|
|
}
|
|
return $disp;
|
|
}
|
|
|
|
sub getoldestsnapshot {
|
|
my $snaps = shift;
|
|
foreach my $snap ( sort { $snaps{'source'}{$a}{'creation'}<=>$snaps{'source'}{$b}{'creation'} } keys %{ $snaps{'source'} }) {
|
|
# return on first snap found - it's the oldest
|
|
return $snap;
|
|
}
|
|
# must not have had any snapshots on source - luckily, we already made one, amirite?
|
|
if (defined ($args{'no-sync-snap'}) ) {
|
|
# well, actually we set --no-sync-snap, so no we *didn't* already make one. Whoops.
|
|
warn "CRIT: --no-sync-snap is set, and getoldestsnapshot() could not find any snapshots on source!\n";
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
sub getnewestsnapshot {
|
|
my $snaps = shift;
|
|
foreach my $snap ( sort { $snaps{'source'}{$b}{'creation'}<=>$snaps{'source'}{$a}{'creation'} } keys %{ $snaps{'source'} }) {
|
|
# return on first snap found - it's the newest
|
|
if (!$quiet) { print "NEWEST SNAPSHOT: $snap\n"; }
|
|
return $snap;
|
|
}
|
|
# must not have had any snapshots on source - looks like we'd better create one!
|
|
if (defined ($args{'no-sync-snap'}) ) {
|
|
if (!defined ($args{'recursive'}) ) {
|
|
# well, actually we set --no-sync-snap and we're not recursive, so no we *can't* make one. Whoops.
|
|
die "CRIT: --no-sync-snap is set, and getnewestsnapshot() could not find any snapshots on source!\n";
|
|
}
|
|
# fixme: we need to output WHAT the current dataset IS if we encounter this WARN condition.
|
|
# we also probably need an argument to mute this WARN, for people who deliberately exclude
|
|
# datasets from recursive replication this way.
|
|
warn "WARN: --no-sync-snap is set, and getnewestsnapshot() could not find any snapshots on source for current dataset. Continuing.\n";
|
|
if ($exitcode < 2) { $exitcode = 2; }
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
sub buildsynccmd {
|
|
my ($sendcmd,$recvcmd,$pvsize,$sourceisroot,$targetisroot) = @_;
|
|
# here's where it gets fun: figuring out when to compress and decompress.
|
|
# to make this work for all possible combinations, you may have to decompress
|
|
# AND recompress across the pipe viewer. FUN.
|
|
my $synccmd;
|
|
|
|
if ($sourcehost eq '' && $targethost eq '') {
|
|
# both sides local. don't compress. do mbuffer, once, on the source side.
|
|
# $synccmd = "$sendcmd | $mbuffercmd | $pvcmd | $recvcmd";
|
|
$synccmd = "$sendcmd |";
|
|
# avoid confusion - accept either source-bwlimit or target-bwlimit as the bandwidth limiting option here
|
|
my $bwlimit = '';
|
|
if (length $args{'source-bwlimit'}) {
|
|
$bwlimit = $args{'source-bwlimit'};
|
|
} elsif (length $args{'target-bwlimit'}) {
|
|
$bwlimit = $args{'target-bwlimit'};
|
|
}
|
|
|
|
if ($avail{'sourcembuffer'}) { $synccmd .= " $mbuffercmd $bwlimit $mbufferoptions |"; }
|
|
if ($avail{'localpv'} && !$quiet) { $synccmd .= " $pvcmd -s $pvsize |"; }
|
|
$synccmd .= " $recvcmd";
|
|
} elsif ($sourcehost eq '') {
|
|
# local source, remote target.
|
|
#$synccmd = "$sendcmd | $pvcmd | $compressargs{'cmd'} | $mbuffercmd | $sshcmd $targethost '$compressargs{'decomcmd'} | $mbuffercmd | $recvcmd'";
|
|
$synccmd = "$sendcmd |";
|
|
if ($avail{'localpv'} && !$quiet) { $synccmd .= " $pvcmd -s $pvsize |"; }
|
|
if ($avail{'compress'}) { $synccmd .= " $compressargs{'cmd'} |"; }
|
|
if ($avail{'sourcembuffer'}) { $synccmd .= " $mbuffercmd $args{'source-bwlimit'} $mbufferoptions |"; }
|
|
$synccmd .= " $sshcmd $targethost ";
|
|
|
|
my $remotecmd = "";
|
|
if ($avail{'targetmbuffer'}) { $remotecmd .= " $mbuffercmd $args{'target-bwlimit'} $mbufferoptions |"; }
|
|
if ($avail{'compress'}) { $remotecmd .= " $compressargs{'decomcmd'} |"; }
|
|
$remotecmd .= " $recvcmd";
|
|
|
|
$synccmd .= escapeshellparam($remotecmd);
|
|
} elsif ($targethost eq '') {
|
|
# remote source, local target.
|
|
#$synccmd = "$sshcmd $sourcehost '$sendcmd | $compressargs{'cmd'} | $mbuffercmd' | $compressargs{'decomcmd'} | $mbuffercmd | $pvcmd | $recvcmd";
|
|
|
|
my $remotecmd = $sendcmd;
|
|
if ($avail{'compress'}) { $remotecmd .= " | $compressargs{'cmd'}"; }
|
|
if ($avail{'sourcembuffer'}) { $remotecmd .= " | $mbuffercmd $args{'source-bwlimit'} $mbufferoptions"; }
|
|
|
|
$synccmd = "$sshcmd $sourcehost " . escapeshellparam($remotecmd);
|
|
$synccmd .= " | ";
|
|
if ($avail{'targetmbuffer'}) { $synccmd .= "$mbuffercmd $args{'target-bwlimit'} $mbufferoptions | "; }
|
|
if ($avail{'compress'}) { $synccmd .= "$compressargs{'decomcmd'} | "; }
|
|
if ($avail{'localpv'} && !$quiet) { $synccmd .= "$pvcmd -s $pvsize | "; }
|
|
$synccmd .= "$recvcmd";
|
|
} else {
|
|
#remote source, remote target... weird, but whatever, I'm not here to judge you.
|
|
#$synccmd = "$sshcmd $sourcehost '$sendcmd | $compressargs{'cmd'} | $mbuffercmd' | $compressargs{'decomcmd'} | $pvcmd | $compressargs{'cmd'} | $mbuffercmd | $sshcmd $targethost '$compressargs{'decomcmd'} | $mbuffercmd | $recvcmd'";
|
|
|
|
my $remotecmd = $sendcmd;
|
|
if ($avail{'compress'}) { $remotecmd .= " | $compressargs{'cmd'}"; }
|
|
if ($avail{'sourcembuffer'}) { $remotecmd .= " | $mbuffercmd $args{'source-bwlimit'} $mbufferoptions"; }
|
|
|
|
$synccmd = "$sshcmd $sourcehost " . escapeshellparam($remotecmd);
|
|
$synccmd .= " | ";
|
|
|
|
if ($avail{'compress'}) { $synccmd .= "$compressargs{'decomcmd'} | "; }
|
|
if ($avail{'localpv'} && !$quiet) { $synccmd .= "$pvcmd -s $pvsize | "; }
|
|
if ($avail{'compress'}) { $synccmd .= "$compressargs{'cmd'} | "; }
|
|
if ($avail{'localmbuffer'}) { $synccmd .= "$mbuffercmd $mbufferoptions | "; }
|
|
$synccmd .= "$sshcmd $targethost ";
|
|
|
|
$remotecmd = "";
|
|
if ($avail{'targetmbuffer'}) { $remotecmd .= " $mbuffercmd $args{'target-bwlimit'} $mbufferoptions |"; }
|
|
if ($avail{'compress'}) { $remotecmd .= " $compressargs{'decomcmd'} |"; }
|
|
$remotecmd .= " $recvcmd";
|
|
|
|
$synccmd .= escapeshellparam($remotecmd);
|
|
}
|
|
return $synccmd;
|
|
}
|
|
|
|
sub pruneoldsyncsnaps {
|
|
my ($rhost,$fs,$newsyncsnap,$isroot,@snaps) = @_;
|
|
|
|
my $fsescaped = escapeshellparam($fs);
|
|
|
|
if ($rhost ne '') { $rhost = "$sshcmd $rhost"; }
|
|
|
|
my $hostid = hostname();
|
|
|
|
my $mysudocmd;
|
|
if ($isroot) { $mysudocmd=''; } else { $mysudocmd = $sudocmd; }
|
|
|
|
my @prunesnaps;
|
|
|
|
# only prune snaps beginning with syncoid and our own hostname
|
|
foreach my $snap(@snaps) {
|
|
if ($snap =~ /^syncoid_\Q$identifier$hostid\E/) {
|
|
# no matter what, we categorically refuse to
|
|
# prune the new sync snap we created for this run
|
|
if ($snap ne $newsyncsnap) {
|
|
push (@prunesnaps,$snap);
|
|
}
|
|
}
|
|
}
|
|
|
|
# concatenate pruning commands to ten per line, to cut down
|
|
# auth times for any remote hosts that must be operated via SSH
|
|
my $counter;
|
|
my $maxsnapspercmd = 10;
|
|
my $prunecmd;
|
|
foreach my $snap(@prunesnaps) {
|
|
$counter ++;
|
|
$prunecmd .= "$mysudocmd $zfscmd destroy $fsescaped\@$snap; ";
|
|
if ($counter > $maxsnapspercmd) {
|
|
$prunecmd =~ s/\; $//;
|
|
if ($debug) { print "DEBUG: pruning up to $maxsnapspercmd obsolete sync snapshots...\n"; }
|
|
if ($debug) { print "DEBUG: $rhost $prunecmd\n"; }
|
|
if ($rhost ne '') {
|
|
$prunecmd = escapeshellparam($prunecmd);
|
|
}
|
|
system("$rhost $prunecmd") == 0
|
|
or warn "WARNING: $rhost $prunecmd failed: $?";
|
|
$prunecmd = '';
|
|
$counter = 0;
|
|
}
|
|
}
|
|
# if we still have some prune commands stacked up after finishing
|
|
# the loop, commit 'em now
|
|
if ($counter) {
|
|
$prunecmd =~ s/\; $//;
|
|
if ($debug) { print "DEBUG: pruning up to $maxsnapspercmd obsolete sync snapshots...\n"; }
|
|
if ($debug) { print "DEBUG: $rhost $prunecmd\n"; }
|
|
if ($rhost ne '') {
|
|
$prunecmd = escapeshellparam($prunecmd);
|
|
}
|
|
system("$rhost $prunecmd") == 0
|
|
or warn "WARNING: $rhost $prunecmd failed: $?";
|
|
}
|
|
return;
|
|
}
|
|
|
|
sub getmatchingsnapshot {
|
|
my ($sourcefs, $targetfs, $snaps) = @_;
|
|
foreach my $snap ( sort { $snaps{'source'}{$b}{'creation'}<=>$snaps{'source'}{$a}{'creation'} } keys %{ $snaps{'source'} }) {
|
|
if (defined $snaps{'target'}{$snap}) {
|
|
if ($snaps{'source'}{$snap}{'guid'} == $snaps{'target'}{$snap}{'guid'}) {
|
|
return $snap;
|
|
}
|
|
}
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
sub newsyncsnap {
|
|
my ($rhost,$fs,$isroot) = @_;
|
|
my $fsescaped = escapeshellparam($fs);
|
|
if ($rhost ne '') {
|
|
$rhost = "$sshcmd $rhost";
|
|
# double escaping needed
|
|
$fsescaped = escapeshellparam($fsescaped);
|
|
}
|
|
my $mysudocmd;
|
|
if ($isroot) { $mysudocmd = ''; } else { $mysudocmd = $sudocmd; }
|
|
my $hostid = hostname();
|
|
my %date = getdate();
|
|
my $snapname = "syncoid\_$identifier$hostid\_$date{'stamp'}";
|
|
my $snapcmd = "$rhost $mysudocmd $zfscmd snapshot $fsescaped\@$snapname\n";
|
|
system($snapcmd) == 0 or do {
|
|
warn "CRITICAL ERROR: $snapcmd failed: $?";
|
|
if ($exitcode < 2) { $exitcode = 2; }
|
|
return 0;
|
|
};
|
|
|
|
return $snapname;
|
|
}
|
|
|
|
sub targetexists {
|
|
my ($rhost,$fs,$isroot) = @_;
|
|
my $fsescaped = escapeshellparam($fs);
|
|
if ($rhost ne '') {
|
|
$rhost = "$sshcmd $rhost";
|
|
# double escaping needed
|
|
$fsescaped = escapeshellparam($fsescaped);
|
|
}
|
|
my $mysudocmd;
|
|
if ($isroot) { $mysudocmd = ''; } else { $mysudocmd = $sudocmd; }
|
|
my $checktargetcmd = "$rhost $mysudocmd $zfscmd get -H name $fsescaped";
|
|
if ($debug) { print "DEBUG: checking to see if target filesystem exists using \"$checktargetcmd 2>&1 |\"...\n"; }
|
|
open FH, "$checktargetcmd 2>&1 |";
|
|
my $targetexists = <FH>;
|
|
close FH;
|
|
my $exit = $?;
|
|
$targetexists = ( $targetexists =~ /^\Q$fs\E/ && $exit == 0 );
|
|
return $targetexists;
|
|
}
|
|
|
|
sub getssh {
|
|
my $fs = shift;
|
|
|
|
my $rhost;
|
|
my $isroot;
|
|
my $socket;
|
|
|
|
# if we got passed something with an @ in it, we assume it's an ssh connection, eg root@myotherbox
|
|
if ($fs =~ /\@/) {
|
|
$rhost = $fs;
|
|
$fs =~ s/^\S*\@\S*://;
|
|
$rhost =~ s/:\Q$fs\E$//;
|
|
my $remoteuser = $rhost;
|
|
$remoteuser =~ s/\@.*$//;
|
|
if ($remoteuser eq 'root' || $args{'no-privilege-elevation'}) { $isroot = 1; } else { $isroot = 0; }
|
|
# now we need to establish a persistent master SSH connection
|
|
$socket = "/tmp/syncoid-$remoteuser-$rhost-" . time();
|
|
open FH, "$sshcmd -M -S $socket -o ControlPersist=1m $args{'sshport'} $rhost exit |";
|
|
close FH;
|
|
$rhost = "-S $socket $rhost";
|
|
} else {
|
|
my $localuid = $<;
|
|
if ($localuid == 0 || $args{'no-privilege-elevation'}) { $isroot = 1; } else { $isroot = 0; }
|
|
}
|
|
# if ($isroot) { print "this user is root.\n"; } else { print "this user is not root.\n"; }
|
|
return ($rhost,$fs,$isroot);
|
|
}
|
|
|
|
sub dumphash() {
|
|
my $hash = shift;
|
|
$Data::Dumper::Sortkeys = 1;
|
|
print Dumper($hash);
|
|
}
|
|
|
|
sub getsnaps() {
|
|
my ($type,$rhost,$fs,$isroot,%snaps) = @_;
|
|
my $mysudocmd;
|
|
my $fsescaped = escapeshellparam($fs);
|
|
if ($isroot) { $mysudocmd = ''; } else { $mysudocmd = $sudocmd; }
|
|
|
|
if ($rhost ne '') {
|
|
$rhost = "$sshcmd $rhost";
|
|
# double escaping needed
|
|
$fsescaped = escapeshellparam($fsescaped);
|
|
}
|
|
|
|
my $getsnapcmd = "$rhost $mysudocmd $zfscmd get -Hpd 1 -t snapshot guid,creation $fsescaped |";
|
|
if ($debug) { print "DEBUG: getting list of snapshots on $fs using $getsnapcmd...\n"; }
|
|
open FH, $getsnapcmd;
|
|
my @rawsnaps = <FH>;
|
|
close FH or die "CRITICAL ERROR: snapshots couldn't be listed for $fs (exit code $?)";
|
|
|
|
# this is a little obnoxious. get guid,creation returns guid,creation on two separate lines
|
|
# as though each were an entirely separate get command.
|
|
|
|
foreach my $line (@rawsnaps) {
|
|
# only import snap guids from the specified filesystem
|
|
if ($line =~ /\Q$fs\E\@.*guid/) {
|
|
chomp $line;
|
|
my $guid = $line;
|
|
$guid =~ s/^.*\tguid\t*(\d*).*/$1/;
|
|
my $snap = $line;
|
|
$snap =~ s/^.*\@(.*)\tguid.*$/$1/;
|
|
$snaps{$type}{$snap}{'guid'}=$guid;
|
|
}
|
|
}
|
|
|
|
foreach my $line (@rawsnaps) {
|
|
# only import snap creations from the specified filesystem
|
|
if ($line =~ /\Q$fs\E\@.*creation/) {
|
|
chomp $line;
|
|
my $creation = $line;
|
|
$creation =~ s/^.*\tcreation\t*(\d*).*/$1/;
|
|
my $snap = $line;
|
|
$snap =~ s/^.*\@(.*)\tcreation.*$/$1/;
|
|
$snaps{$type}{$snap}{'creation'}=$creation;
|
|
}
|
|
}
|
|
|
|
return %snaps;
|
|
}
|
|
|
|
sub getbookmarks() {
|
|
my ($rhost,$fs,$isroot,%bookmarks) = @_;
|
|
my $mysudocmd;
|
|
my $fsescaped = escapeshellparam($fs);
|
|
if ($isroot) { $mysudocmd = ''; } else { $mysudocmd = $sudocmd; }
|
|
|
|
if ($rhost ne '') {
|
|
$rhost = "$sshcmd $rhost";
|
|
# double escaping needed
|
|
$fsescaped = escapeshellparam($fsescaped);
|
|
}
|
|
|
|
my $error = 0;
|
|
my $getbookmarkcmd = "$rhost $mysudocmd $zfscmd get -Hpd 1 -t bookmark guid,creation $fsescaped 2>&1 |";
|
|
if ($debug) { print "DEBUG: getting list of bookmarks on $fs using $getbookmarkcmd...\n"; }
|
|
open FH, $getbookmarkcmd;
|
|
my @rawbookmarks = <FH>;
|
|
close FH or $error = 1;
|
|
|
|
if ($error == 1) {
|
|
if ($rawbookmarks[0] =~ /invalid type/) {
|
|
# no support for zfs bookmarks, return empty hash
|
|
return %bookmarks;
|
|
}
|
|
|
|
die "CRITICAL ERROR: bookmarks couldn't be listed for $fs (exit code $?)";
|
|
}
|
|
|
|
# this is a little obnoxious. get guid,creation returns guid,creation on two separate lines
|
|
# as though each were an entirely separate get command.
|
|
|
|
my $lastguid;
|
|
|
|
foreach my $line (@rawbookmarks) {
|
|
# only import bookmark guids, creation from the specified filesystem
|
|
if ($line =~ /\Q$fs\E\#.*guid/) {
|
|
chomp $line;
|
|
$lastguid = $line;
|
|
$lastguid =~ s/^.*\tguid\t*(\d*).*/$1/;
|
|
my $bookmark = $line;
|
|
$bookmark =~ s/^.*\#(.*)\tguid.*$/$1/;
|
|
$bookmarks{$lastguid}{'name'}=$bookmark;
|
|
} elsif ($line =~ /\Q$fs\E\#.*creation/) {
|
|
chomp $line;
|
|
my $creation = $line;
|
|
$creation =~ s/^.*\tcreation\t*(\d*).*/$1/;
|
|
my $bookmark = $line;
|
|
$bookmark =~ s/^.*\#(.*)\tcreation.*$/$1/;
|
|
$bookmarks{$lastguid}{'creation'}=$creation;
|
|
}
|
|
}
|
|
|
|
return %bookmarks;
|
|
}
|
|
|
|
sub getsendsize {
|
|
my ($sourcehost,$snap1,$snap2,$isroot,$receivetoken) = @_;
|
|
|
|
my $snap1escaped = escapeshellparam($snap1);
|
|
my $snap2escaped = escapeshellparam($snap2);
|
|
|
|
my $mysudocmd;
|
|
if ($isroot) { $mysudocmd = ''; } else { $mysudocmd = $sudocmd; }
|
|
|
|
my $sourcessh;
|
|
if ($sourcehost ne '') {
|
|
$sourcessh = "$sshcmd $sourcehost";
|
|
$snap1escaped = escapeshellparam($snap1escaped);
|
|
$snap2escaped = escapeshellparam($snap2escaped);
|
|
} else {
|
|
$sourcessh = '';
|
|
}
|
|
|
|
my $snaps;
|
|
if ($snap2) {
|
|
# if we got a $snap2 argument, we want an incremental send estimate from $snap1 to $snap2.
|
|
$snaps = "$args{'streamarg'} $snap1escaped $snap2escaped";
|
|
} else {
|
|
# if we didn't get a $snap2 arg, we want a full send estimate for $snap1.
|
|
$snaps = "$snap1escaped";
|
|
}
|
|
|
|
# in case of a resumed receive, get the remaining
|
|
# size based on the resume token
|
|
if (defined($receivetoken)) {
|
|
$snaps = "-t $receivetoken";
|
|
}
|
|
|
|
my $getsendsizecmd = "$sourcessh $mysudocmd $zfscmd send -nP $snaps";
|
|
if ($debug) { print "DEBUG: getting estimated transfer size from source $sourcehost using \"$getsendsizecmd 2>&1 |\"...\n"; }
|
|
|
|
open FH, "$getsendsizecmd 2>&1 |";
|
|
my @rawsize = <FH>;
|
|
close FH;
|
|
my $exit = $?;
|
|
|
|
# process sendsize: last line of multi-line output is
|
|
# size of proposed xfer in bytes, but we need to remove
|
|
# human-readable crap from it
|
|
my $sendsize = pop(@rawsize);
|
|
# the output format is different in case of
|
|
# a resumed receive
|
|
if (defined($receivetoken)) {
|
|
$sendsize =~ s/.*\t([0-9]+)$/$1/;
|
|
} else {
|
|
$sendsize =~ s/^size\t*//;
|
|
}
|
|
chomp $sendsize;
|
|
|
|
# check for valid value
|
|
if ($sendsize !~ /^\d+$/) {
|
|
$sendsize = '';
|
|
}
|
|
|
|
# to avoid confusion with a zero size pv, give sendsize
|
|
# a minimum 4K value - or if empty, make sure it reads UNKNOWN
|
|
if ($debug) { print "DEBUG: sendsize = $sendsize\n"; }
|
|
if ($sendsize eq '' || $exit != 0) {
|
|
$sendsize = '0';
|
|
} elsif ($sendsize < 4096) {
|
|
$sendsize = 4096;
|
|
}
|
|
return $sendsize;
|
|
}
|
|
|
|
sub getdate {
|
|
my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);
|
|
$year += 1900;
|
|
my %date;
|
|
$date{'unix'} = (((((((($year - 1971) * 365) + $yday) * 24) + $hour) * 60) + $min) * 60) + $sec;
|
|
$date{'year'} = $year;
|
|
$date{'sec'} = sprintf ("%02u", $sec);
|
|
$date{'min'} = sprintf ("%02u", $min);
|
|
$date{'hour'} = sprintf ("%02u", $hour);
|
|
$date{'mday'} = sprintf ("%02u", $mday);
|
|
$date{'mon'} = sprintf ("%02u", ($mon + 1));
|
|
$date{'stamp'} = "$date{'year'}-$date{'mon'}-$date{'mday'}:$date{'hour'}:$date{'min'}:$date{'sec'}";
|
|
return %date;
|
|
}
|
|
|
|
sub escapeshellparam {
|
|
my ($par) = @_;
|
|
# avoid use of uninitialized string in regex
|
|
if (length($par)) {
|
|
# "escape" all single quotes
|
|
$par =~ s/'/'"'"'/g;
|
|
} else {
|
|
# avoid use of uninitialized string in concatenation below
|
|
$par = '';
|
|
}
|
|
# single-quote entire string
|
|
return "'$par'";
|
|
}
|
|
|
|
sub getreceivetoken() {
|
|
my ($rhost,$fs,$isroot) = @_;
|
|
my $token = getzfsvalue($rhost,$fs,$isroot,"receive_resume_token");
|
|
|
|
if ($token ne '-' && $token ne '') {
|
|
return $token;
|
|
}
|
|
|
|
if ($debug) {
|
|
print "DEBUG: no receive token found \n";
|
|
}
|
|
|
|
return
|
|
}
|
|
|
|
__END__
|
|
|
|
=head1 NAME
|
|
|
|
syncoid - ZFS snapshot replication tool
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
syncoid [options]... SOURCE TARGET
|
|
or syncoid [options]... SOURCE USER@HOST:TARGET
|
|
or syncoid [options]... USER@HOST:SOURCE TARGET
|
|
or syncoid [options]... USER@HOST:SOURCE USER@HOST:TARGET
|
|
|
|
SOURCE Source ZFS dataset. Can be either local or remote
|
|
TARGET Target ZFS dataset. Can be either local or remote
|
|
|
|
Options:
|
|
|
|
--compress=FORMAT Compresses data during transfer. Currently accepted options are gzip, pigz-fast, pigz-slow, zstd-fast, zstd-slow, lz4, xz, lzo (default) & none
|
|
--identifier=EXTRA Extra identifier which is included in the snapshot name. Can be used for replicating to multiple targets.
|
|
--recursive|r Also transfers child datasets
|
|
--skip-parent Skips syncing of the parent dataset. Does nothing without '--recursive' option.
|
|
--source-bwlimit=<limit k|m|g|t> Bandwidth limit on the source transfer
|
|
--target-bwlimit=<limit k|m|g|t> Bandwidth limit on the target transfer
|
|
--no-stream Replicates using newest snapshot instead of intermediates
|
|
--no-sync-snap Does not create new snapshot, only transfers existing
|
|
--no-clone-rollback Does not rollback clones on target
|
|
--no-rollback Does not rollback clones or snapshots on target (it probably requires a readonly target)
|
|
--exclude=REGEX Exclude specific datasets which match the given regular expression. Can be specified multiple times
|
|
--sshkey=FILE Specifies a ssh public key to use to connect
|
|
--sshport=PORT Connects to remote on a particular port
|
|
--sshcipher|c=CIPHER Passes CIPHER to ssh to use a particular cipher set
|
|
--sshoption|o=OPTION Passes OPTION to ssh for remote usage. Can be specified multiple times
|
|
|
|
--help Prints this helptext
|
|
--version Prints the version number
|
|
--debug Prints out a lot of additional information during a syncoid run
|
|
--monitor-version Currently does nothing
|
|
--quiet Suppresses non-error output
|
|
--dumpsnaps Dumps a list of snapshots during the run
|
|
--no-command-checks Do not check command existence before attempting transfer. Not recommended
|
|
--no-resume Don't use the ZFS resume feature if available
|
|
--no-clone-handling Don't try to recreate clones on target
|
|
--no-privilege-elevation Bypass the root check, for use with ZFS permission delegation
|
|
|
|
--force-delete Remove target datasets recursively, if there are no matching snapshots/bookmarks
|