all lists on lists.proxmox.com
 help / color / mirror / Atom feed
* [pve-devel] [PATCH pve-docs] vzdump: add section describing PBS change detection mode
@ 2024-06-26  8:13 Christian Ebner
  2024-07-10 14:14 ` Fabian Grünbichler
  2024-07-10 14:45 ` Christian Ebner
  0 siblings, 2 replies; 3+ messages in thread
From: Christian Ebner @ 2024-06-26  8:13 UTC (permalink / raw)
  To: pve-devel

Add a concise section about what PBS change detection mode is and
what it affects, including a table with a description of the modes.

Signed-off-by: Christian Ebner <c.ebner@proxmox.com>
---
 vzdump.adoc | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/vzdump.adoc b/vzdump.adoc
index 79d4bbc..958ee12 100644
--- a/vzdump.adoc
+++ b/vzdump.adoc
@@ -171,6 +171,30 @@ 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 target.
+
+Backups of VMs or to other storage backends are not affected by this setting.
+
+There are 3 change detection modes available:
+
+[width="100%",cols="<m,4d",options="header"]
+|===============================================================================
+| Mode     | Description
+| Default  | The legacy mode, read and encode all files in a self contained
+pxar archive with format version 1 being uploaded to the Proxmox Backup Server.
+| Data     | (EXPERIMENTAL): Read and encode all files, but split data and
+metadata into separate streams, using the pxar format version 2.
+| Metadata | (EXPERIMENTAL): Use the metadata archive of the previous backup
+run to detect unchanged files and reuse the files data already backed up in the
+previous backup for the current backup run when possible. Data and metadata are
+encoded into separate streams, using the pxar format version 2.
+|===============================================================================
+
 Backup File Names
 -----------------
 
-- 
2.39.2



_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel


^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2024-07-10 14:45 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2024-06-26  8:13 [pve-devel] [PATCH pve-docs] vzdump: add section describing PBS change detection mode Christian Ebner
2024-07-10 14:14 ` Fabian Grünbichler
2024-07-10 14:45 ` Christian Ebner

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.
Service provided by Proxmox Server Solutions GmbH | Privacy | Legal