From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [IPv6:2a01:7e0:0:424::9]) by lore.proxmox.com (Postfix) with ESMTPS id 302E61FF2CF for ; Thu, 11 Jul 2024 11:37:59 +0200 (CEST) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id C46503074A; Thu, 11 Jul 2024 11:38:20 +0200 (CEST) From: Christian Ebner To: pve-devel@lists.proxmox.com Date: Thu, 11 Jul 2024 11:37:26 +0200 Message-Id: <20240711093726.107533-1-c.ebner@proxmox.com> X-Mailer: git-send-email 2.39.2 MIME-Version: 1.0 X-SPAM-LEVEL: Spam detection results: 0 AWL -0.379 Adjusted score from AWL reputation of From: address BAYES_00 -1.9 Bayes spam probability is 0 to 1% DMARC_MISSING 0.1 Missing DMARC policy KAM_ASCII_DIVIDERS 0.8 Email that uses ascii formatting dividers and possible spam tricks KAM_DMARC_STATUS 0.01 Test Rule for DKIM or SPF Failure with Strict Alignment SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record SPF_PASS -0.001 SPF: sender matches SPF record Subject: [pve-devel] [PATCH v3 pve-docs] vzdump: add section describing PBS change detection mode X-BeenThere: pve-devel@lists.proxmox.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Proxmox VE development discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Proxmox VE development discussion Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: pve-devel-bounces@lists.proxmox.com Sender: "pve-devel" Add a concise section about what PBS change detection mode is, where to configure the option and what it affects, including a table with a description of the modes. Signed-off-by: Christian Ebner --- changes since version 2 (thanks @Aaron for the suggestions!): - Incorporated suggested paragraph describing how to set the options - Added missing `the` and comma - Moved sentence of VMs and unaffected storage target to the end and show it as note vzdump.adoc | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/vzdump.adoc b/vzdump.adoc index 9b1cb61..508ff5d 100644 --- a/vzdump.adoc +++ b/vzdump.adoc @@ -175,6 +175,38 @@ fleecing image up-front. On a thinly provisioned storage, the fleecing image can grow to the same size as the original image only if the guest re-writes a whole disk while the backup is busy with another disk. +CT Change Detection Mode +~~~~~~~~~~~~~~~~~~~~~~~~ + +Setting the change detection mode defines the encoding format for the pxar +archives and how changed, and unchanged files are handled for container backups +with Proxmox Backup Server as the target. + +The change detection mode option can be configured for individual backup jobs in +the 'Advanced' tab while editing a job. Further, this option can be set as +node-wide fallback via the xref:vzdump_configuration[configuration options]. + +There are 3 change detection modes available: + +[width="100%",cols="