From 739d3243d9f8e17b0f80440aaec9bacdcb046745 Mon Sep 17 00:00:00 2001 From: DRON-666 <64691982+DRON-666@users.noreply.github.com> Date: Tue, 23 Mar 2021 07:41:45 +0300 Subject: [PATCH] vss: Update docs and changelog --- changelog/unreleased/pull-3067 | 4 ++++ doc/040_backup.rst | 17 ++++++++++++++++- 2 files changed, 20 insertions(+), 1 deletion(-) diff --git a/changelog/unreleased/pull-3067 b/changelog/unreleased/pull-3067 index a56c045fa..52f04c5e0 100644 --- a/changelog/unreleased/pull-3067 +++ b/changelog/unreleased/pull-3067 @@ -15,4 +15,8 @@ changes timeout to five minutes and disable snapshotting of mount points on all excludes drive `D:`, mount point `C:\MNT` and specific volume from VSS snapshotting. + restic backup --use-fs-snapshot -o vss.provider={b5946137-7b9f-4925-af80-51abd60b20d5} + +uses 'Microsoft Software Shadow Copy provider 1.0' instead of the default provider. + https://github.com/restic/restic/pull/3067 diff --git a/doc/040_backup.rst b/doc/040_backup.rst index d1bb39f96..7360bb0e0 100644 --- a/doc/040_backup.rst +++ b/doc/040_backup.rst @@ -56,11 +56,12 @@ snapshot for each volume that contains files to backup. Files are read from the VSS snapshot instead of the regular filesystem. This allows to backup files that are exclusively locked by another process during the backup. -You can use three additional options to change VSS behaviour: +You can use additional options to change VSS behaviour: * ``-o vss.timeout`` specifies timeout for VSS snapshot creation, the default value is 120 seconds * ``-o vss.excludeallmountpoints`` disable auto snapshotting of all volume mount points * ``-o vss.excludevolumes`` allows excluding specific volumes or volume mount points from snapshotting + * ``-o vss.provider`` specifies VSS provider used for snapshotting E.g., 2.5 minutes timeout with mount points snapshotting disabled can be specified as @@ -74,6 +75,20 @@ and excluding drive ``D:\``, mount point ``C:\mnt`` and volume ``\\?\Volume{04ce -o vss.excludevolumes="d:;c:\MNT\;\\?\volume{04ce0545-3391-11e0-ba2f-806e6f6e6963}" +VSS provider can be specified by GUID + +.. code-block:: console + + -o vss.provider={3f900f90-00e9-440e-873a-96ca5eb079e5} + +or by name + +.. code-block:: console + + -o vss.provider="Hyper-V IC Software Shadow Copy Provider" + +Also ``MS`` can be used as alias for ``Microsoft Software Shadow Copy provider 1.0``. + By default VSS ignores Outlook OST files. This is not a restriction of restic but the default Windows VSS configuration. The files not to snapshot are configured in the Windows registry under the following key: