mirror/restic
1
0
Fork 0
mirror of https://github.com/restic/restic.git synced 2024-12-22 15:57:07 +00:00
Code Issues Releases Wiki Activity

vss: Update docs and changelog

Browse source
This commit is contained in:
DRON-666 2021-03-23 07:41:45 +03:00
parent bb0f93ef3d
commit 739d3243d9
2 changed files with 20 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
changelog/unreleased/pull-3067
View file

@ -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. 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 https://github.com/restic/restic/pull/3067

17
doc/040_backup.rst
View file

@ -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 VSS snapshot instead of the regular filesystem. This allows to backup files that are
exclusively locked by another process during the backup. 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.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.excludeallmountpoints`` disable auto snapshotting of all volume mount points
* ``-o vss.excludevolumes`` allows excluding specific volumes or volume mount points from snapshotting * ``-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 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}" -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 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 but the default Windows VSS configuration. The files not to snapshot are
configured in the Windows registry under the following key: configured in the Windows registry under the following key: