]> git.proxmox.com Git - pve-zsync.git/blame_incremental - pve-zsync
bump version to 2.3.1
[pve-zsync.git] / pve-zsync
... / ...
CommitLineData
1#!/usr/bin/perl
2
3use strict;
4use warnings;
5
6use Fcntl qw(:flock SEEK_END);
7use Getopt::Long qw(GetOptionsFromArray);
8use File::Path qw(make_path);
9use JSON;
10use IO::File;
11use String::ShellQuote 'shell_quote';
12use Text::ParseWords;
13
14my $PROGNAME = "pve-zsync";
15my $CONFIG_PATH = "/var/lib/${PROGNAME}";
16my $STATE = "${CONFIG_PATH}/sync_state";
17my $CRONJOBS = "/etc/cron.d/$PROGNAME";
18my $PATH = "/usr/sbin";
19my $PVE_DIR = "/etc/pve/local";
20my $QEMU_CONF = "${PVE_DIR}/qemu-server";
21my $LXC_CONF = "${PVE_DIR}/lxc";
22my $PROG_PATH = "$PATH/${PROGNAME}";
23my $INTERVAL = 15;
24my $DEBUG;
25
26BEGIN {
27 $DEBUG = 0; # change default here. not above on declaration!
28 $DEBUG ||= $ENV{ZSYNC_DEBUG};
29 if ($DEBUG) {
30 require Data::Dumper;
31 Data::Dumper->import();
32 }
33}
34
35my $IPV4OCTET = "(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9])";
36my $IPV4RE = "(?:(?:$IPV4OCTET\\.){3}$IPV4OCTET)";
37my $IPV6H16 = "(?:[0-9a-fA-F]{1,4})";
38my $IPV6LS32 = "(?:(?:$IPV4RE|$IPV6H16:$IPV6H16))";
39
40my $IPV6RE = "(?:" .
41 "(?:(?:" . "(?:$IPV6H16:){6})$IPV6LS32)|" .
42 "(?:(?:" . "::(?:$IPV6H16:){5})$IPV6LS32)|" .
43 "(?:(?:(?:" . "$IPV6H16)?::(?:$IPV6H16:){4})$IPV6LS32)|" .
44 "(?:(?:(?:(?:$IPV6H16:){0,1}$IPV6H16)?::(?:$IPV6H16:){3})$IPV6LS32)|" .
45 "(?:(?:(?:(?:$IPV6H16:){0,2}$IPV6H16)?::(?:$IPV6H16:){2})$IPV6LS32)|" .
46 "(?:(?:(?:(?:$IPV6H16:){0,3}$IPV6H16)?::(?:$IPV6H16:){1})$IPV6LS32)|" .
47 "(?:(?:(?:(?:$IPV6H16:){0,4}$IPV6H16)?::" . ")$IPV6LS32)|" .
48 "(?:(?:(?:(?:$IPV6H16:){0,5}$IPV6H16)?::" . ")$IPV6H16)|" .
49 "(?:(?:(?:(?:$IPV6H16:){0,6}$IPV6H16)?::" . ")))";
50
51my $HOSTv4RE0 = "(?:[\\w\\.\\-_]+|$IPV4RE)"; # hostname or ipv4 address
52my $HOSTv4RE1 = "(?:$HOSTv4RE0|\\[$HOSTv4RE0\\])"; # these may be in brackets, too
53my $HOSTRE = "(?:$HOSTv4RE1|\\[$IPV6RE\\])"; # ipv6 must always be in brackets
54# targets are either a VMID, or a 'host:zpool/path' with 'host:' being optional
55my $TARGETRE = qr!^(?:($HOSTRE):)?(\d+|(?:[\w\-_]+)(/.+)?)$!;
56
57my $DISK_KEY_RE = qr/^(?:(?:(?:virtio|ide|scsi|sata|efidisk|tpmstate|mp)\d+)|rootfs): /;
58
59my $INSTANCE_ID = get_instance_id($$);
60
61my $command = $ARGV[0];
62
63if (defined($command) && $command ne 'help' && $command ne 'printpod') {
64 check_bin ('cstream');
65 check_bin ('zfs');
66 check_bin ('ssh');
67 check_bin ('scp');
68}
69
70$SIG{TERM} = $SIG{QUIT} = $SIG{PIPE} = $SIG{HUP} = $SIG{KILL} = $SIG{INT} = sub {
71 die "Signaled, aborting sync: $!\n";
72};
73
74sub check_bin {
75 my ($bin) = @_;
76
77 foreach my $p (split (/:/, $ENV{PATH})) {
78 my $fn = "$p/$bin";
79 if (-x $fn) {
80 return $fn;
81 }
82 }
83
84 die "unable to find command '$bin'\n";
85}
86
87sub read_file {
88 my ($filename, $one_line_only) = @_;
89
90 my $fh = IO::File->new($filename, "r")
91 or die "Could not open file ${filename}: $!\n";
92
93 my $text = $one_line_only ? <$fh> : [ <$fh> ];
94
95 close($fh);
96
97 return $text;
98}
99
100sub cut_target_width {
101 my ($path, $maxlen) = @_;
102 $path =~ s@/+@/@g;
103
104 return $path if length($path) <= $maxlen;
105
106 return '..'.substr($path, -$maxlen+2) if $path !~ m@/@;
107
108 $path =~ s@/([^/]+/?)$@@;
109 my $tail = $1;
110
111 if (length($tail)+3 == $maxlen) {
112 return "../$tail";
113 } elsif (length($tail)+2 >= $maxlen) {
114 return '..'.substr($tail, -$maxlen+2)
115 }
116
117 $path =~ s@(/[^/]+)(?:/|$)@@;
118 my $head = $1;
119 my $both = length($head) + length($tail);
120 my $remaining = $maxlen-$both-4; # -4 for "/../"
121
122 if ($remaining < 0) {
123 return substr($head, 0, $maxlen - length($tail) - 3) . "../$tail"; # -3 for "../"
124 }
125
126 substr($path, ($remaining/2), (length($path)-$remaining), '..');
127 return "$head/" . $path . "/$tail";
128}
129
130sub locked {
131 my ($lock_fn, $code) = @_;
132
133 my $lock_fh = IO::File->new("> $lock_fn");
134
135 flock($lock_fh, LOCK_EX) || die "Couldn't acquire lock - $!\n";
136 my $res = eval { $code->() };
137 my $err = $@;
138
139 flock($lock_fh, LOCK_UN) || warn "Error unlocking - $!\n";
140 die "$err" if $err;
141
142 close($lock_fh);
143 return $res;
144}
145
146sub get_status {
147 my ($source, $name, $status) = @_;
148
149 if ($status->{$source->{all}}->{$name}->{status}) {
150 return $status;
151 }
152
153 return undef;
154}
155
156sub check_dataset_exists {
157 my ($dataset, $ip, $user) = @_;
158
159 my $cmd = [];
160
161 if ($ip) {
162 push @$cmd, 'ssh', "$user\@$ip", '--';
163 }
164 push @$cmd, 'zfs', 'list', '-H', '--', $dataset;
165 eval {
166 run_cmd($cmd);
167 };
168
169 if ($@) {
170 return 0;
171 }
172 return 1;
173}
174
175sub create_file_system {
176 my ($file_system, $ip, $user) = @_;
177
178 my $cmd = [];
179
180 if ($ip) {
181 push @$cmd, 'ssh', "$user\@$ip", '--';
182 }
183 push @$cmd, 'zfs', 'create', $file_system;
184
185 run_cmd($cmd);
186}
187
188sub parse_target {
189 my ($text) = @_;
190
191 my $errstr = "$text : is not a valid input! Use [IP:]<VMID> or [IP:]<ZFSPool>[/Path]";
192 my $target = {};
193
194 if ($text !~ $TARGETRE) {
195 die "$errstr\n";
196 }
197 $target->{all} = $2;
198 $target->{ip} = $1 if $1;
199 my @parts = split('/', $2);
200
201 $target->{ip} =~ s/^\[(.*)\]$/$1/ if $target->{ip};
202
203 my $pool = $target->{pool} = shift(@parts);
204 die "$errstr\n" if !$pool;
205
206 if ($pool =~ m/^\d+$/) {
207 $target->{vmid} = $pool;
208 delete $target->{pool};
209 }
210
211 return $target if (@parts == 0);
212 $target->{last_part} = pop(@parts);
213
214 if ($target->{ip}) {
215 pop(@parts);
216 }
217 if (@parts > 0) {
218 $target->{path} = join('/', @parts);
219 }
220
221 return $target;
222}
223
224sub read_cron {
225
226 #This is for the first use to init file;
227 if (!-e $CRONJOBS) {
228 my $new_fh = IO::File->new("> $CRONJOBS");
229 die "Could not create $CRONJOBS: $!\n" if !$new_fh;
230 close($new_fh);
231 return undef;
232 }
233
234 my $text = read_file($CRONJOBS, 0);
235
236 return parse_cron(@{$text});
237}
238
239sub parse_argv {
240 my (@arg) = @_;
241
242 my $param = {
243 dest => undef,
244 source => undef,
245 verbose => undef,
246 limit => undef,
247 maxsnap => undef,
248 dest_maxsnap => undef,
249 name => undef,
250 skip => undef,
251 method => undef,
252 source_user => undef,
253 dest_user => undef,
254 prepend_storage_id => undef,
255 compressed => undef,
256 properties => undef,
257 dest_config_path => undef,
258 };
259
260 my ($ret) = GetOptionsFromArray(
261 \@arg,
262 'dest=s' => \$param->{dest},
263 'source=s' => \$param->{source},
264 'verbose' => \$param->{verbose},
265 'limit=i' => \$param->{limit},
266 'maxsnap=i' => \$param->{maxsnap},
267 'dest-maxsnap=i' => \$param->{dest_maxsnap},
268 'name=s' => \$param->{name},
269 'skip' => \$param->{skip},
270 'method=s' => \$param->{method},
271 'source-user=s' => \$param->{source_user},
272 'dest-user=s' => \$param->{dest_user},
273 'prepend-storage-id' => \$param->{prepend_storage_id},
274 'compressed' => \$param->{compressed},
275 'properties' => \$param->{properties},
276 'dest-config-path=s' => \$param->{dest_config_path},
277 );
278
279 die "can't parse options\n" if $ret == 0;
280
281 $param->{name} //= "default";
282 $param->{maxsnap} //= 1;
283 $param->{method} //= "ssh";
284 $param->{source_user} //= "root";
285 $param->{dest_user} //= "root";
286
287 return $param;
288}
289
290sub add_state_to_job {
291 my ($job) = @_;
292
293 my $states = read_state();
294 my $state = $states->{$job->{source}}->{$job->{name}};
295
296 $job->{state} = $state->{state};
297 $job->{lsync} = $state->{lsync};
298 $job->{vm_type} = $state->{vm_type};
299 $job->{instance_id} = $state->{instance_id};
300
301 for (my $i = 0; $state->{"snap$i"}; $i++) {
302 $job->{"snap$i"} = $state->{"snap$i"};
303 }
304
305 return $job;
306}
307
308sub parse_cron {
309 my (@text) = @_;
310
311 my $cfg = {};
312
313 while (my $line = shift(@text)) {
314 my @arg = Text::ParseWords::shellwords($line);
315 my $param = parse_argv(@arg);
316
317 if ($param->{source} && $param->{dest}) {
318 my $source = delete $param->{source};
319 my $name = delete $param->{name};
320
321 $cfg->{$source}->{$name} = $param;
322 }
323 }
324
325 return $cfg;
326}
327
328sub param_to_job {
329 my ($param) = @_;
330
331 my $job = {};
332
333 my $source = parse_target($param->{source});
334 my $dest;
335 $dest = parse_target($param->{dest}) if $param->{dest};
336
337 $job->{name} = !$param->{name} ? "default" : $param->{name};
338 $job->{dest} = $param->{dest} if $param->{dest};
339 $job->{method} = "local" if !$dest->{ip} && !$source->{ip};
340 $job->{method} = "ssh" if !$job->{method};
341 $job->{limit} = $param->{limit};
342 $job->{maxsnap} = $param->{maxsnap};
343 $job->{dest_maxsnap} = $param->{dest_maxsnap};
344 $job->{source} = $param->{source};
345 $job->{source_user} = $param->{source_user};
346 $job->{dest_user} = $param->{dest_user};
347 $job->{prepend_storage_id} = !!$param->{prepend_storage_id};
348 $job->{compressed} = !!$param->{compressed};
349 $job->{properties} = !!$param->{properties};
350 $job->{dest_config_path} = $param->{dest_config_path} if $param->{dest_config_path};
351
352 return $job;
353}
354
355sub read_state {
356
357 if (!-e $STATE) {
358 make_path $CONFIG_PATH;
359 my $new_fh = IO::File->new("> $STATE");
360 die "Could not create $STATE: $!\n" if !$new_fh;
361 print $new_fh "{}";
362 close($new_fh);
363 return undef;
364 }
365
366 my $text = read_file($STATE, 1);
367 return decode_json($text);
368}
369
370sub update_state {
371 my ($job) = @_;
372
373 my $text = eval { read_file($STATE, 1); };
374
375 my $out_fh = IO::File->new("> $STATE.new");
376 die "Could not open file ${STATE}.new: $!\n" if !$out_fh;
377
378 my $states = {};
379 my $state = {};
380 if ($text){
381 $states = decode_json($text);
382 $state = $states->{$job->{source}}->{$job->{name}};
383 }
384
385 if ($job->{state} ne "del") {
386 $state->{state} = $job->{state};
387 $state->{lsync} = $job->{lsync};
388 $state->{instance_id} = $job->{instance_id};
389 $state->{vm_type} = $job->{vm_type};
390
391 for (my $i = 0; $job->{"snap$i"} ; $i++) {
392 $state->{"snap$i"} = $job->{"snap$i"};
393 }
394 $states->{$job->{source}}->{$job->{name}} = $state;
395 } else {
396
397 delete $states->{$job->{source}}->{$job->{name}};
398 delete $states->{$job->{source}} if !keys %{$states->{$job->{source}}};
399 }
400
401 $text = encode_json($states);
402 print $out_fh $text;
403
404 close($out_fh);
405 rename "$STATE.new", $STATE;
406
407 return $states;
408}
409
410sub update_cron {
411 my ($job) = @_;
412
413 my $updated;
414 my $has_header;
415 my $line_no = 0;
416 my $text = "";
417 my $header = "SHELL=/bin/sh\n";
418 $header .= "PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin\n\n";
419
420 my $current = read_file($CRONJOBS, 0);
421
422 foreach my $line (@{$current}) {
423 chomp($line);
424 if ($line =~ m/source $job->{source} .*name $job->{name} /) {
425 $updated = 1;
426 next if $job->{state} eq "del";
427 $text .= format_job($job, $line);
428 } else {
429 if (($line_no < 3) && ($line =~ /^(PATH|SHELL)/ )) {
430 $has_header = 1;
431 }
432 $text .= "$line\n";
433 }
434 $line_no++;
435 }
436
437 if (!$has_header) {
438 $text = "$header$text";
439 }
440
441 if (!$updated) {
442 $text .= format_job($job);
443 }
444 my $new_fh = IO::File->new("> ${CRONJOBS}.new");
445 die "Could not open file ${CRONJOBS}.new: $!\n" if !$new_fh;
446
447 print $new_fh $text or die "can't write to $CRONJOBS.new: $!\n";
448 close ($new_fh);
449
450 rename "${CRONJOBS}.new", $CRONJOBS or die "can't move $CRONJOBS.new: $!\n";
451}
452
453sub format_job {
454 my ($job, $line) = @_;
455 my $text = "";
456
457 if ($job->{state} eq "stopped") {
458 $text = "#";
459 }
460 if ($line) {
461 $line =~ /^#*\s*((?:\S+\s+){4}\S+)\s+root/;
462 $text .= $1;
463 } else {
464 $text .= "*/$INTERVAL * * * *";
465 }
466 $text .= " root";
467 $text .= " $PROGNAME sync --source $job->{source} --dest $job->{dest}";
468 $text .= " --name $job->{name} --maxsnap $job->{maxsnap}";
469 $text .= " --dest-maxsnap $job->{dest_maxsnap}" if defined($job->{dest_maxsnap});
470 $text .= " --limit $job->{limit}" if $job->{limit};
471 $text .= " --method $job->{method}";
472 $text .= " --verbose" if $job->{verbose};
473 $text .= " --source-user $job->{source_user}";
474 $text .= " --dest-user $job->{dest_user}";
475 $text .= " --prepend-storage-id" if $job->{prepend_storage_id};
476 $text .= " --compressed" if $job->{compressed};
477 $text .= " --properties" if $job->{properties};
478 $text .= " --dest-config-path $job->{dest_config_path}" if $job->{dest_config_path};
479 $text .= "\n";
480
481 return $text;
482}
483
484sub list {
485
486 my $cfg = read_cron();
487
488 my $list = sprintf("%-25s%-25s%-10s%-20s%-6s%-5s\n" , "SOURCE", "NAME", "STATE", "LAST SYNC", "TYPE", "CON");
489
490 my $states = read_state();
491 foreach my $source (sort keys%{$cfg}) {
492 foreach my $name (sort keys%{$cfg->{$source}}) {
493 $list .= sprintf("%-25s", cut_target_width($source, 25));
494 $list .= sprintf("%-25s", cut_target_width($name, 25));
495 $list .= sprintf("%-10s", $states->{$source}->{$name}->{state});
496 $list .= sprintf("%-20s", $states->{$source}->{$name}->{lsync});
497 $list .= sprintf("%-6s", defined($states->{$source}->{$name}->{vm_type}) ? $states->{$source}->{$name}->{vm_type} : "undef");
498 $list .= sprintf("%-5s\n", $cfg->{$source}->{$name}->{method});
499 }
500 }
501
502 return $list;
503}
504
505sub vm_exists {
506 my ($target, $user) = @_;
507
508 return undef if !defined($target->{vmid});
509
510 my $conf_fn = "$target->{vmid}.conf";
511
512 if ($target->{ip}) {
513 my @cmd = ('ssh', "$user\@$target->{ip}", '--', '/bin/ls');
514 return "qemu" if eval { run_cmd([@cmd, "$QEMU_CONF/$conf_fn"]) };
515 return "lxc" if eval { run_cmd([@cmd, "$LXC_CONF/$conf_fn"]) };
516 } else {
517 return "qemu" if -f "$QEMU_CONF/$conf_fn";
518 return "lxc" if -f "$LXC_CONF/$conf_fn";
519 }
520
521 return undef;
522}
523
524sub init {
525 my ($param) = @_;
526
527 locked("$CONFIG_PATH/cron_and_state.lock", sub {
528 my $cfg = read_cron();
529
530 my $job = param_to_job($param);
531
532 $job->{state} = "ok";
533 $job->{lsync} = 0;
534
535 my $source = parse_target($param->{source});
536 my $dest = parse_target($param->{dest});
537
538 if (my $ip = $dest->{ip}) {
539 run_cmd(['ssh-copy-id', '-i', '/root/.ssh/id_rsa.pub', "$param->{dest_user}\@$ip"]);
540 }
541
542 if (my $ip = $source->{ip}) {
543 run_cmd(['ssh-copy-id', '-i', '/root/.ssh/id_rsa.pub', "$param->{source_user}\@$ip"]);
544 }
545
546 die "Pool $dest->{all} does not exist\n"
547 if !check_dataset_exists($dest->{all}, $dest->{ip}, $param->{dest_user});
548
549 if (!defined($source->{vmid})) {
550 die "Pool $source->{all} does not exist\n"
551 if !check_dataset_exists($source->{all}, $source->{ip}, $param->{source_user});
552 }
553
554 my $vm_type = vm_exists($source, $param->{source_user});
555 $job->{vm_type} = $vm_type;
556 $source->{vm_type} = $vm_type;
557
558 die "VM $source->{vmid} doesn't exist\n" if $source->{vmid} && !$vm_type;
559
560 die "Config already exists\n" if $cfg->{$job->{source}}->{$job->{name}};
561
562 #check if vm has zfs disks if not die;
563 get_disks($source, $param->{source_user}) if $source->{vmid};
564
565 update_cron($job);
566 update_state($job);
567 }); #cron and state lock
568
569 return if $param->{skip};
570
571 eval { sync($param) };
572 if (my $err = $@) {
573 destroy_job($param);
574 print $err;
575 }
576}
577
578sub get_job {
579 my ($param) = @_;
580
581 my $cfg = read_cron();
582
583 if (!$cfg->{$param->{source}}->{$param->{name}}) {
584 die "Job with source $param->{source} and name $param->{name} does not exist\n" ;
585 }
586 my $job = $cfg->{$param->{source}}->{$param->{name}};
587 $job->{name} = $param->{name};
588 $job->{source} = $param->{source};
589 $job = add_state_to_job($job);
590
591 return $job;
592}
593
594sub destroy_job {
595 my ($param) = @_;
596
597 locked("$CONFIG_PATH/cron_and_state.lock", sub {
598 my $job = get_job($param);
599 $job->{state} = "del";
600
601 update_cron($job);
602 update_state($job);
603 });
604}
605
606sub get_instance_id {
607 my ($pid) = @_;
608
609 my $stat = read_file("/proc/$pid/stat", 1)
610 or die "unable to read process stats\n";
611 my $boot_id = read_file("/proc/sys/kernel/random/boot_id", 1)
612 or die "unable to read boot ID\n";
613
614 my $stats = [ split(/\s+/, $stat) ];
615 my $starttime = $stats->[21];
616 chomp($boot_id);
617
618 return "${pid}:${starttime}:${boot_id}";
619}
620
621sub instance_exists {
622 my ($instance_id) = @_;
623
624 if (defined($instance_id) && $instance_id =~ m/^([1-9][0-9]*):/) {
625 my $pid = $1;
626 my $actual_id = eval { get_instance_id($pid); };
627 return defined($actual_id) && $actual_id eq $instance_id;
628 }
629
630 return 0;
631}
632
633sub sync {
634 my ($param) = @_;
635
636 my $job;
637
638 locked("$CONFIG_PATH/cron_and_state.lock", sub {
639 eval { $job = get_job($param) };
640
641 if ($job) {
642 my $state = $job->{state} // 'ok';
643 $state = 'ok' if !instance_exists($job->{instance_id});
644
645 if ($state eq "syncing" || $state eq "waiting") {
646 die "Job --source $param->{source} --name $param->{name} is already scheduled to sync\n";
647 }
648
649 $job->{state} = "waiting";
650 $job->{instance_id} = $INSTANCE_ID;
651
652 update_state($job);
653 }
654 });
655
656 locked("$CONFIG_PATH/sync.lock", sub {
657
658 my $date = get_date();
659
660 my $dest;
661 my $source;
662 my $vm_type;
663
664 locked("$CONFIG_PATH/cron_and_state.lock", sub {
665 #job might've changed while we waited for the sync lock, but we can be sure it's not syncing
666 eval { $job = get_job($param); };
667
668 if ($job && defined($job->{state}) && $job->{state} eq "stopped") {
669 die "Job --source $param->{source} --name $param->{name} has been disabled\n";
670 }
671
672 $dest = parse_target($param->{dest});
673 $source = parse_target($param->{source});
674
675 $vm_type = vm_exists($source, $param->{source_user});
676 $source->{vm_type} = $vm_type;
677
678 if ($job) {
679 $job->{state} = "syncing";
680 $job->{vm_type} = $vm_type if !$job->{vm_type};
681 update_state($job);
682 }
683 }); #cron and state lock
684
685 my $sync_path = sub {
686 my ($source, $dest, $job, $param, $date) = @_;
687
688 my $dest_dataset = target_dataset($source, $dest);
689
690 ($dest->{old_snap}, $dest->{last_snap}) = snapshot_get(
691 $dest_dataset,
692 $param->{dest_maxsnap} // $param->{maxsnap},
693 $param->{name},
694 $dest->{ip},
695 $param->{dest_user},
696 );
697
698 ($source->{old_snap}) = snapshot_get(
699 $source->{all},
700 $param->{maxsnap},
701 $param->{name},
702 $source->{ip},
703 $param->{source_user},
704 );
705
706 prepare_prepended_target($source, $dest, $param->{dest_user}) if defined($dest->{prepend});
707
708 snapshot_add($source, $dest, $param->{name}, $date, $param->{source_user}, $param->{dest_user});
709
710 send_image($source, $dest, $param);
711
712 for my $old_snap (@{$source->{old_snap}}) {
713 snapshot_destroy($source->{all}, $old_snap, $source->{ip}, $param->{source_user});
714 }
715
716 for my $old_snap (@{$dest->{old_snap}}) {
717 snapshot_destroy($dest_dataset, $old_snap, $dest->{ip}, $param->{dest_user});
718 }
719 };
720
721 eval{
722 if ($source->{vmid}) {
723 die "VM $source->{vmid} doesn't exist\n" if !$vm_type;
724 die "source-user has to be root for syncing VMs\n" if ($param->{source_user} ne "root");
725 my $disks = get_disks($source, $param->{source_user});
726
727 foreach my $disk (sort keys %{$disks}) {
728 $source->{all} = $disks->{$disk}->{all};
729 $source->{pool} = $disks->{$disk}->{pool};
730 $source->{path} = $disks->{$disk}->{path} if $disks->{$disk}->{path};
731 $source->{last_part} = $disks->{$disk}->{last_part};
732
733 $dest->{prepend} = $disks->{$disk}->{storage_id}
734 if $param->{prepend_storage_id};
735
736 &$sync_path($source, $dest, $job, $param, $date);
737 }
738 if ($param->{method} eq "ssh" && ($source->{ip} || $dest->{ip})) {
739 send_config($source, $dest,'ssh', $param->{source_user}, $param->{dest_user}, $param->{dest_config_path});
740 } else {
741 send_config($source, $dest,'local', $param->{source_user}, $param->{dest_user}, $param->{dest_config_path});
742 }
743 } else {
744 &$sync_path($source, $dest, $job, $param, $date);
745 }
746 };
747 if (my $err = $@) {
748 locked("$CONFIG_PATH/cron_and_state.lock", sub {
749 eval { $job = get_job($param); };
750 if ($job) {
751 $job->{state} = "error";
752 delete $job->{instance_id};
753 update_state($job);
754 }
755 });
756 print "Job --source $param->{source} --name $param->{name} got an ERROR!!!\nERROR Message:\n";
757 die "$err\n";
758 }
759
760 locked("$CONFIG_PATH/cron_and_state.lock", sub {
761 eval { $job = get_job($param); };
762 if ($job) {
763 if (defined($job->{state}) && $job->{state} eq "stopped") {
764 $job->{state} = "stopped";
765 } else {
766 $job->{state} = "ok";
767 }
768 $job->{lsync} = $date;
769 delete $job->{instance_id};
770 update_state($job);
771 }
772 });
773 }); #sync lock
774}
775
776sub snapshot_get{
777 my ($dataset, $max_snap, $name, $ip, $user) = @_;
778
779 my $cmd = [];
780 push @$cmd, 'ssh', "$user\@$ip", '--', if $ip;
781 push @$cmd, 'zfs', 'list', '-r', '-t', 'snapshot', '-Ho', 'name', '-S', 'creation';
782 push @$cmd, $dataset;
783
784 my $raw;
785 eval {$raw = run_cmd($cmd)};
786 if (my $erro =$@) { #this means the volume doesn't exist on dest yet
787 return undef;
788 }
789
790 my $index = 0;
791 my $line = "";
792 my $last_snap = undef;
793 my $old_snap = [];
794
795 while ($raw && $raw =~ s/^(.*?)(\n|$)//) {
796 $line = $1;
797 if ($line =~ m/@(.*)$/) {
798 $last_snap = $1 if (!$last_snap);
799 }
800 if ($line =~ m/(rep_\Q${name}\E_\d{4}-\d{2}-\d{2}_\d{2}:\d{2}:\d{2})$/) {
801 # interpreted as infinity
802 last if $max_snap <= 0;
803
804 my $snap = $1;
805 $index++;
806
807 if ($index >= $max_snap) {
808 push @{$old_snap}, $snap;
809 }
810 }
811 }
812
813 return ($old_snap, $last_snap) if $last_snap;
814
815 return undef;
816}
817
818sub snapshot_add {
819 my ($source, $dest, $name, $date, $source_user, $dest_user) = @_;
820
821 my $snap_name = "rep_$name\_".$date;
822
823 $source->{new_snap} = $snap_name;
824
825 my $path = "$source->{all}\@$snap_name";
826
827 my $cmd = [];
828 push @$cmd, 'ssh', "$source_user\@$source->{ip}", '--', if $source->{ip};
829 push @$cmd, 'zfs', 'snapshot', $path;
830 eval{
831 run_cmd($cmd);
832 };
833
834 if (my $err = $@) {
835 snapshot_destroy($source->{all}, $snap_name, $source->{ip}, $source_user);
836 die "$err\n";
837 }
838}
839
840sub get_disks {
841 my ($target, $user) = @_;
842
843 my $cmd = [];
844 push @$cmd, 'ssh', "$user\@$target->{ip}", '--', if $target->{ip};
845
846 if ($target->{vm_type} eq 'qemu') {
847 push @$cmd, 'qm', 'config', $target->{vmid};
848 } elsif ($target->{vm_type} eq 'lxc') {
849 push @$cmd, 'pct', 'config', $target->{vmid};
850 } else {
851 die "VM Type unknown\n";
852 }
853
854 my $res = run_cmd($cmd);
855
856 my $disks = parse_disks($res, $target->{ip}, $target->{vm_type}, $user);
857
858 return $disks;
859}
860
861sub run_cmd {
862 my ($cmd) = @_;
863 print "Start CMD\n" if $DEBUG;
864 print Dumper $cmd if $DEBUG;
865 if (ref($cmd) eq 'ARRAY') {
866 $cmd = join(' ', map { ref($_) ? $$_ : shell_quote($_) } @$cmd);
867 }
868 my $output = `$cmd 2>&1`;
869
870 die "COMMAND:\n\t$cmd\nGET ERROR:\n\t$output" if 0 != $?;
871
872 chomp($output);
873 print Dumper $output if $DEBUG;
874 print "END CMD\n" if $DEBUG;
875 return $output;
876}
877
878sub parse_disks {
879 my ($text, $ip, $vm_type, $user) = @_;
880
881 my $disks;
882
883 my $num = 0;
884 while ($text && $text =~ s/^(.*?)(\n|$)//) {
885 my $line = $1;
886
887 next if $line =~ /media=cdrom/;
888 next if $line !~ m/$DISK_KEY_RE/;
889
890 #QEMU if backup is not set include in sync
891 next if $vm_type eq 'qemu' && ($line =~ m/backup=(?i:0|no|off|false)/);
892
893 #LXC if backup is not set do no in sync
894 next if $vm_type eq 'lxc' && ($line =~ m/^mp\d:/) && ($line !~ m/backup=(?i:1|yes|on|true)/);
895
896 my $disk = undef;
897 my $stor = undef;
898 if($line =~ m/$DISK_KEY_RE(.*)$/) {
899 my @parameter = split(/,/,$1);
900
901 foreach my $opt (@parameter) {
902 if ($opt =~ m/^(?:file=|volume=)?([^:]+):([A-Za-z0-9\-]+)$/){
903 $disk = $2;
904 $stor = $1;
905 last;
906 }
907 }
908 }
909 if (!defined($disk) || !defined($stor)) {
910 print "Disk: \"$line\" has no valid zfs dataset format and will be skipped\n";
911 next;
912 }
913
914 my $cmd = [];
915 push @$cmd, 'ssh', "$user\@$ip", '--' if $ip;
916 push @$cmd, 'pvesm', 'path', "$stor:$disk";
917 my $path = run_cmd($cmd);
918
919 die "Get no path from pvesm path $stor:$disk\n" if !$path;
920
921 $disks->{$num}->{storage_id} = $stor;
922
923 if ($vm_type eq 'qemu' && $path =~ m/^\/dev\/zvol\/(\w+.*)(\/$disk)$/) {
924
925 my @array = split('/', $1);
926 $disks->{$num}->{pool} = shift(@array);
927 $disks->{$num}->{all} = $disks->{$num}->{pool};
928 if (0 < @array) {
929 $disks->{$num}->{path} = join('/', @array);
930 $disks->{$num}->{all} .= "\/$disks->{$num}->{path}";
931 }
932 $disks->{$num}->{last_part} = $disk;
933 $disks->{$num}->{all} .= "\/$disk";
934
935 $num++;
936 } elsif ($vm_type eq 'lxc' && $path =~ m/^\/(\w+.+)(\/(\w+.*))*(\/$disk)$/) {
937
938 $disks->{$num}->{pool} = $1;
939 $disks->{$num}->{all} = $disks->{$num}->{pool};
940
941 if ($2) {
942 $disks->{$num}->{path} = $3;
943 $disks->{$num}->{all} .= "\/$disks->{$num}->{path}";
944 }
945
946 $disks->{$num}->{last_part} = $disk;
947 $disks->{$num}->{all} .= "\/$disk";
948
949 $num++;
950
951 } else {
952 die "unexpected path '$path'\n";
953 }
954 }
955
956 die "Guest does not include any ZFS volumes (or all are excluded by the backup flag).\n"
957 if !$disks->{0};
958 return $disks;
959}
960
961# how the corresponding dataset is named on the target
962sub target_dataset {
963 my ($source, $dest) = @_;
964
965 my $target = "$dest->{all}";
966 $target .= "/$dest->{prepend}" if defined($dest->{prepend});
967 $target .= "/$source->{last_part}" if $source->{last_part};
968 $target =~ s!/+!/!g;
969
970 return $target;
971}
972
973# create the parent dataset for the actual target
974sub prepare_prepended_target {
975 my ($source, $dest, $dest_user) = @_;
976
977 die "internal error - not a prepended target\n" if !defined($dest->{prepend});
978
979 # The parent dataset shouldn't be the actual target.
980 die "internal error - no last_part for source\n" if !$source->{last_part};
981
982 my $target = "$dest->{all}/$dest->{prepend}";
983 $target =~ s!/+!/!g;
984
985 return if check_dataset_exists($target, $dest->{ip}, $dest_user);
986
987 create_file_system($target, $dest->{ip}, $dest_user);
988}
989
990sub snapshot_destroy {
991 my ($dataset, $snap, $ip, $user) = @_;
992
993 my @zfscmd = ('zfs', 'destroy');
994 my $snapshot = "$dataset\@$snap";
995
996 eval {
997 if ($ip) {
998 run_cmd(['ssh', "$user\@$ip", '--', @zfscmd, $snapshot]);
999 } else {
1000 run_cmd([@zfscmd, $snapshot]);
1001 }
1002 };
1003 if (my $erro = $@) {
1004 warn "WARN: $erro";
1005 }
1006}
1007
1008# check if snapshot for incremental sync exist on source side
1009sub snapshot_exist {
1010 my ($source , $dest, $method, $source_user) = @_;
1011
1012 my $cmd = [];
1013 push @$cmd, 'ssh', "$source_user\@$source->{ip}", '--' if $source->{ip};
1014 push @$cmd, 'zfs', 'list', '-rt', 'snapshot', '-Ho', 'name';
1015
1016 my $path = $source->{all};
1017 $path .= "\@$dest->{last_snap}";
1018
1019 push @$cmd, $path;
1020
1021 eval {run_cmd($cmd)};
1022 if (my $erro =$@) {
1023 warn "WARN: $erro";
1024 return undef;
1025 }
1026 return 1;
1027}
1028
1029sub send_image {
1030 my ($source, $dest, $param) = @_;
1031
1032 my $cmd = [];
1033
1034 push @$cmd, 'ssh', '-o', 'BatchMode=yes', "$param->{source_user}\@$source->{ip}", '--' if $source->{ip};
1035 push @$cmd, 'zfs', 'send';
1036 push @$cmd, '-L', if $param->{compressed}; # no effect if dataset never had large recordsize
1037 push @$cmd, '-c', if $param->{compressed};
1038 push @$cmd, '-p', if $param->{properties};
1039 push @$cmd, '-v' if $param->{verbose};
1040
1041 if($dest->{last_snap} && snapshot_exist($source , $dest, $param->{method}, $param->{source_user})) {
1042 push @$cmd, '-i', "$source->{all}\@$dest->{last_snap}";
1043 }
1044 push @$cmd, '--', "$source->{all}\@$source->{new_snap}";
1045
1046 if ($param->{limit}){
1047 my $bwl = $param->{limit}*1024;
1048 push @$cmd, \'|', 'cstream', '-t', $bwl;
1049 }
1050 my $target = target_dataset($source, $dest);
1051
1052 push @$cmd, \'|';
1053 push @$cmd, 'ssh', '-o', 'BatchMode=yes', "$param->{dest_user}\@$dest->{ip}", '--' if $dest->{ip};
1054 push @$cmd, 'zfs', 'recv', '-F', '--';
1055 push @$cmd, "$target";
1056
1057 eval {
1058 run_cmd($cmd)
1059 };
1060
1061 if (my $erro = $@) {
1062 snapshot_destroy($source->{all}, $source->{new_snap}, $source->{ip}, $param->{source_user});
1063 die $erro;
1064 };
1065}
1066
1067
1068sub send_config{
1069 my ($source, $dest, $method, $source_user, $dest_user, $dest_config_path) = @_;
1070
1071 my $source_target = $source->{vm_type} eq 'qemu' ? "$QEMU_CONF/$source->{vmid}.conf": "$LXC_CONF/$source->{vmid}.conf";
1072 my $dest_target_new ="$source->{vmid}.conf.$source->{vm_type}.$source->{new_snap}";
1073
1074 my $config_dir = $dest_config_path // $CONFIG_PATH;
1075 $config_dir .= "/$dest->{last_part}" if $dest->{last_part};
1076
1077 $dest_target_new = $config_dir.'/'.$dest_target_new;
1078
1079 if ($method eq 'ssh'){
1080 if ($dest->{ip} && $source->{ip}) {
1081 run_cmd(['ssh', "$dest_user\@$dest->{ip}", '--', 'mkdir', '-p', '--', $config_dir]);
1082 run_cmd(['scp', '--', "$source_user\@[$source->{ip}]:$source_target", "$dest_user\@[$dest->{ip}]:$dest_target_new"]);
1083 } elsif ($dest->{ip}) {
1084 run_cmd(['ssh', "$dest_user\@$dest->{ip}", '--', 'mkdir', '-p', '--', $config_dir]);
1085 run_cmd(['scp', '--', $source_target, "$dest_user\@[$dest->{ip}]:$dest_target_new"]);
1086 } elsif ($source->{ip}) {
1087 run_cmd(['mkdir', '-p', '--', $config_dir]);
1088 run_cmd(['scp', '--', "$source_user\@[$source->{ip}]:$source_target", $dest_target_new]);
1089 }
1090
1091 for my $old_snap (@{$dest->{old_snap}}) {
1092 my $dest_target_old ="${config_dir}/$source->{vmid}.conf.$source->{vm_type}.${old_snap}";
1093 if($dest->{ip}){
1094 run_cmd(['ssh', "$dest_user\@$dest->{ip}", '--', 'rm', '-f', '--', $dest_target_old]);
1095 } else {
1096 run_cmd(['rm', '-f', '--', $dest_target_old]);
1097 }
1098 }
1099 } elsif ($method eq 'local') {
1100 run_cmd(['mkdir', '-p', '--', $config_dir]);
1101 run_cmd(['cp', $source_target, $dest_target_new]);
1102 }
1103}
1104
1105sub get_date {
1106 my ($sec, $min, $hour, $mday, $mon, $year, $wday, $yday, $isdst) = localtime(time);
1107 my $datestamp = sprintf ("%04d-%02d-%02d_%02d:%02d:%02d", $year+1900, $mon+1, $mday, $hour, $min, $sec);
1108
1109 return $datestamp;
1110}
1111
1112sub status {
1113 my $cfg = read_cron();
1114
1115 my $status_list = sprintf("%-25s%-25s%-10s\n", "SOURCE", "NAME", "STATUS");
1116
1117 my $states = read_state();
1118
1119 foreach my $source (sort keys%{$cfg}) {
1120 foreach my $sync_name (sort keys%{$cfg->{$source}}) {
1121 $status_list .= sprintf("%-25s", cut_target_width($source, 25));
1122 $status_list .= sprintf("%-25s", cut_target_width($sync_name, 25));
1123 $status_list .= "$states->{$source}->{$sync_name}->{state}\n";
1124 }
1125 }
1126
1127 return $status_list;
1128}
1129
1130sub enable_job {
1131 my ($param) = @_;
1132
1133 locked("$CONFIG_PATH/cron_and_state.lock", sub {
1134 my $job = get_job($param);
1135 $job->{state} = "ok";
1136 update_state($job);
1137 update_cron($job);
1138 });
1139}
1140
1141sub disable_job {
1142 my ($param) = @_;
1143
1144 locked("$CONFIG_PATH/cron_and_state.lock", sub {
1145 my $job = get_job($param);
1146 $job->{state} = "stopped";
1147 update_state($job);
1148 update_cron($job);
1149 });
1150}
1151
1152my $cmd_help = {
1153 destroy => qq{
1154$PROGNAME destroy --source <string> [OPTIONS]
1155
1156 Remove a sync Job from the scheduler
1157
1158 --name string
1159 The name of the sync job, if not set 'default' is used.
1160
1161 --source string
1162 The source can be an <VMID> or [IP:]<ZFSPool>[/Path]
1163 },
1164 create => qq{
1165$PROGNAME create --dest <string> --source <string> [OPTIONS]
1166
1167 Create a new sync-job
1168
1169 --dest string
1170 The destination target is like [IP]:<Pool>[/Path]
1171
1172 --dest-user string
1173 The name of the user on the destination target, root by default
1174
1175 --limit integer
1176 Maximal sync speed in kBytes/s, default is unlimited
1177
1178 --maxsnap integer
1179 The number of snapshots to keep until older ones are erased.
1180 The default is 1, use 0 for unlimited.
1181
1182 --dest-maxsnap integer
1183 Override maxsnap for the destination dataset.
1184
1185 --name string
1186 The name of the sync job, if not set it is default
1187
1188 --prepend-storage-id
1189 If specified, prepend the storage ID to the destination's path(s).
1190
1191 --skip
1192 If specified, skip the first sync.
1193
1194 --source string
1195 The source can be an <VMID> or [IP:]<ZFSPool>[/Path]
1196
1197 --source-user string
1198 The (ssh) user-name on the source target, root by default
1199
1200 --compressed
1201 If specified, send data without decompressing first. If features lz4_compress,
1202 zstd_compress or large_blocks are in use by the source, they need to be enabled on
1203 the target as well.
1204
1205 --properties
1206 If specified, include the dataset's properties in the stream.
1207
1208 --dest-config-path string
1209 Specifies a custom config path on the destination target.
1210 The default is /var/lib/pve-zsync
1211 },
1212 sync => qq{
1213$PROGNAME sync --dest <string> --source <string> [OPTIONS]\n
1214
1215 Trigger one sync.
1216
1217 --dest string
1218 The destination target is like [IP:]<Pool>[/Path]
1219
1220 --dest-user string
1221 The (ssh) user-name on the destination target, root by default
1222
1223 --limit integer
1224 The maximal sync speed in kBytes/s, default is unlimited
1225
1226 --maxsnap integer
1227 The number of snapshots to keep until older ones are erased.
1228 The default is 1, use 0 for unlimited.
1229
1230 --dest-maxsnap integer
1231 Override maxsnap for the destination dataset.
1232
1233 --name string
1234 The name of the sync job, if not set it is 'default'.
1235 It is only necessary if scheduler allready contains this source.
1236
1237 --prepend-storage-id
1238 If specified, prepend the storage ID to the destination's path(s).
1239
1240 --source string
1241 The source can either be an <VMID> or [IP:]<ZFSPool>[/Path]
1242
1243 --source-user string
1244 The name of the user on the source target, root by default
1245
1246 --verbose
1247 If specified, print out the sync progress.
1248
1249 --compressed
1250 If specified, send data without decompressing first. If features lz4_compress,
1251 zstd_compress or large_blocks are in use by the source, they need to be enabled on
1252 the target as well.
1253
1254 --properties
1255 If specified, include the dataset's properties in the stream.
1256
1257 --dest-config-path string
1258 Specifies a custom config path on the destination target.
1259 The default is /var/lib/pve-zsync
1260 },
1261 list => qq{
1262$PROGNAME list
1263
1264 Get a List of all scheduled Sync Jobs
1265 },
1266 status => qq{
1267$PROGNAME status
1268
1269 Get the status of all scheduled Sync Jobs
1270 },
1271 help => qq{
1272$PROGNAME help <cmd> [OPTIONS]
1273
1274 Get help about specified command.
1275
1276 <cmd> string
1277 Command name to get help about.
1278
1279 --verbose
1280 Verbose output format.
1281 },
1282 enable => qq{
1283$PROGNAME enable --source <string> [OPTIONS]
1284
1285 Enable a sync-job and reset all job-errors, if any.
1286
1287 --name string
1288 name of the sync job, if not set it is default
1289
1290 --source string
1291 the source can be an <VMID> or [IP:]<ZFSPool>[/Path]
1292 },
1293 disable => qq{
1294$PROGNAME disable --source <string> [OPTIONS]
1295
1296 Disables (pauses) a sync-job
1297
1298 --name string
1299 name of the sync-job, if not set it is default
1300
1301 --source string
1302 the source can be an <VMID> or [IP:]<ZFSPool>[/Path]
1303 },
1304 printpod => "$PROGNAME printpod\n\n\tinternal command",
1305
1306};
1307
1308if (!$command) {
1309 usage(); die "\n";
1310} elsif (!$cmd_help->{$command}) {
1311 print "ERROR: unknown command '$command'";
1312 usage(1); die "\n";
1313}
1314
1315my @arg = @ARGV;
1316my $param = parse_argv(@arg);
1317
1318sub check_params {
1319 for (@_) {
1320 die "$cmd_help->{$command}\n" if !$param->{$_};
1321 }
1322}
1323
1324if ($command eq 'destroy') {
1325 check_params(qw(source));
1326
1327 check_target($param->{source});
1328 destroy_job($param);
1329
1330} elsif ($command eq 'sync') {
1331 check_params(qw(source dest));
1332
1333 check_target($param->{source});
1334 check_target($param->{dest});
1335 sync($param);
1336
1337} elsif ($command eq 'create') {
1338 check_params(qw(source dest));
1339
1340 check_target($param->{source});
1341 check_target($param->{dest});
1342 init($param);
1343
1344} elsif ($command eq 'status') {
1345 print status();
1346
1347} elsif ($command eq 'list') {
1348 print list();
1349
1350} elsif ($command eq 'help') {
1351 my $help_command = $ARGV[1];
1352
1353 if ($help_command && $cmd_help->{$help_command}) {
1354 die "$cmd_help->{$help_command}\n";
1355
1356 }
1357 if ($param->{verbose}) {
1358 exec("man $PROGNAME");
1359
1360 } else {
1361 usage(1);
1362
1363 }
1364
1365} elsif ($command eq 'enable') {
1366 check_params(qw(source));
1367
1368 check_target($param->{source});
1369 enable_job($param);
1370
1371} elsif ($command eq 'disable') {
1372 check_params(qw(source));
1373
1374 check_target($param->{source});
1375 disable_job($param);
1376
1377} elsif ($command eq 'printpod') {
1378 print_pod();
1379}
1380
1381sub usage {
1382 my ($help) = @_;
1383
1384 print("ERROR:\tno command specified\n") if !$help;
1385 print("USAGE:\t$PROGNAME <COMMAND> [ARGS] [OPTIONS]\n");
1386 print("\t$PROGNAME help [<cmd>] [OPTIONS]\n\n");
1387 print("\t$PROGNAME create --dest <string> --source <string> [OPTIONS]\n");
1388 print("\t$PROGNAME destroy --source <string> [OPTIONS]\n");
1389 print("\t$PROGNAME disable --source <string> [OPTIONS]\n");
1390 print("\t$PROGNAME enable --source <string> [OPTIONS]\n");
1391 print("\t$PROGNAME list\n");
1392 print("\t$PROGNAME status\n");
1393 print("\t$PROGNAME sync --dest <string> --source <string> [OPTIONS]\n");
1394}
1395
1396sub check_target {
1397 my ($target) = @_;
1398 parse_target($target);
1399}
1400
1401sub print_pod {
1402
1403 my $synopsis = join("\n", sort values %$cmd_help);
1404 my $commands = join(", ", sort keys %$cmd_help);
1405
1406 print <<EOF;
1407=head1 NAME
1408
1409pve-zsync - PVE ZFS Storage Sync Tool
1410
1411=head1 SYNOPSIS
1412
1413pve-zsync <COMMAND> [ARGS] [OPTIONS]
1414
1415Where <COMMAND> can be one of: $commands
1416
1417=head1 DESCRIPTION
1418
1419The pve-zsync tool can help you to sync your VMs or directories stored on ZFS
1420between multiple servers.
1421
1422pve-zsync is able to automatically configure CRON jobs, so that a periodic sync
1423will be automatically triggered.
1424The default sync interval is 15 min, if you want to change this value you can
1425do this in F</etc/cron.d/pve-zsync>. If you need help to configure CRON tabs, see
1426man crontab.
1427
1428=head1 COMMANDS AND OPTIONS
1429
1430$synopsis
1431
1432=head1 EXAMPLES
1433
1434Adds a job for syncing the local VM 100 to a remote server's ZFS pool named "tank":
1435 pve-zsync create --source=100 -dest=192.168.1.2:tank
1436
1437=head1 IMPORTANT FILES
1438
1439Cron jobs and config are stored in F</etc/cron.d/pve-zsync>
1440
1441The VM configuration itself gets copied to the destination machines
1442F</var/lib/pve-zsync/> path.
1443
1444=head1 COPYRIGHT AND DISCLAIMER
1445
1446Copyright (C) 2007-2021 Proxmox Server Solutions GmbH
1447
1448This program is free software: you can redistribute it and/or modify it under
1449the terms of the GNU Affero General Public License as published by the Free
1450Software Foundation, either version 3 of the License, or (at your option) any
1451later version.
1452
1453This program is distributed in the hope that it will be useful, but WITHOUT ANY
1454WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
1455PARTICULAR PURPOSE. See the GNU Affero General Public License for more
1456details.
1457
1458You should have received a copy of the GNU Affero General Public License along
1459with this program. If not, see <http://www.gnu.org/licenses/>.
1460
1461EOF
1462}