[PATCH guest-common 1/5] vzdump: add option to stop starting guest backups after a time window

[Thomas Lamprecht <t.lamprecht@proxmox.com>]

A backup job can easily run into business hours, when the node has to
wait for other jobs first, or when backing up the guests takes longer
than planned. Nothing prevents starting further guests at that point.

The new 'start-window' option defines how many minutes after the
scheduled start of a job, or the start of a manual backup, guest
backups may still begin. Guest backups already running finish
normally, and guests not started in time are reported as skipped, so
a shortened run stays visible.

The job runner passes the scheduled start as 'job-scheduled-time'.
Like the job ID, it is left out of the command line shown in the task
log.

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
---
 src/PVE/VZDump/Common.pm | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/src/PVE/VZDump/Common.pm b/src/PVE/VZDump/Common.pm
index f98c9ae..538405b 100644
--- a/src/PVE/VZDump/Common.pm
+++ b/src/PVE/VZDump/Common.pm
@@ -348,6 +348,15 @@ my $confdesc = {
         optional => 1,
         default => 0,
     },
+    'start-window' => {
+        type => 'integer',
+        description => "Do not start backing up further guests once this many minutes have"
+            . " passed since the scheduled start of a backup job, or since the start of a manual"
+            . " backup. Running guest backups finish, and the remaining guests are reported as"
+            . " skipped.",
+        optional => 1,
+        minimum => 1,
+    },
     stopwait => {
         type => 'integer',
         description => "Maximal time to wait until a guest system is stopped (minutes).",
@@ -554,7 +563,8 @@ sub command_line {
             || $p eq 'dow'
             || $p eq 'stdout'
             || $p eq 'enabled'
-            || $p eq 'job-id';
+            || $p eq 'job-id'
+            || $p eq 'job-scheduled-time';
         my $v = $param->{$p};
         my $pd = $confdesc->{$p} || die "no such vzdump option '$p'\n";
         if ($p eq 'exclude-path') {
-- 
2.47.3