mirror
/
restic
mirror of https://github.com/restic/restic.git
1
0
Fork 0
Code Issues Releases Wiki Activity

vss: Update docs and changelog

This commit is contained in:
DRON-666 2020-11-06 06:18:30 +03:00
parent c4f67c0064
commit 9182e6bab5
2 changed files with 36 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
changelog/unreleased/pull-3067 Normal file
View File

@ -0,0 +1,18 @@
Enhancement: Add options to configure Windows Shadow Copy Service
Restic always used 120 sec. timeout and unconditionally created VSS snapshots
for all volume mount points on disk. Now this behavior can be fine-tuned by
new options, like exclude user specific volumes and mount points or completely
disable auto snapshotting of volume mount points.
For example:
restic backup --use-fs-snapshot -o vss.timeout=5m -o vss.excludeallmountpoints=true
changes timeout to five minutes and disable snapshotting of mount points on all volumes, and
restic backup --use-fs-snapshot -o vss.excludevolumes="d:\;c:\mnt\;\\?\Volume{e2e0315d-9066-4f97-8343-eb5659b35762}"
excludes drive `D:`, mount point `C:\MNT` and specific volume from VSS snapshotting.
https://github.com/restic/restic/pull/3067

18
doc/040_backup.rst
View File

@ -56,6 +56,24 @@ 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:
* ``-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
E.g., 2.5 minutes timeout with mount points snapshotting disabled can be specified as
.. code-block:: console
-o vss.timeout=2m30s -o vss.excludeallmountpoints=true
and excluding drive ``D:\``, mount point ``C:\mnt`` and volume ``\\?\Volume{04ce0545-3391-11e0-ba2f-806e6f6e6963}\`` as
.. code-block:: console
-o vss.excludevolumes="d:;c:\MNT\;\\?\volume{04ce0545-3391-11e0-ba2f-806e6f6e6963}"
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: