BTRFS Snapshots / Windows Previous Versions

Spy Alelo · Feb 8th 2025

So I got an interesting issue, and I couldn't find anyone else with the same problem after some searching.

Long story short, I am trying to recover from a previous snapshot on a share. The volume is using btrfs, and the snapshot date is there. But when I try to recover it using Windows Previous Versions, I get "Item Not Found". It seems like is trying to recover from the original path, well since it was deleted of course it can't find it. It doesn't seem to be using the snapshots path to recover from, even though I can browse the data. See below:

Eventually, I just used WinSCP to grab what I needed from the .snapshots folder. I replicated this issue on an external USB HDD that also has a backup of the same data with snapshots as well, and a 2nd OMV 7.6.0-1 server also with a btrfs volume and snapshots.

As of note, if the data is actually not deleted from the share and you try to "recover" or open a file from within Previous Versions, it works but is not actually grabbing the data off the snapshots path but rather the actual live share.

To replicate:

1. Create a snapshot of the share

2. Delete the original data

3. Use Previous Versions on Explorer to recover

4. Profit?

I am not sure if this is a Samba Shadow Copy path issue or a misconfiguration on my end, but this is pretty bog standard stuff.

Any input helps!

Code

# This file is auto-generated by openmediavault (https://www.openmediavault.org)
# WARNING: Do not edit this file, your changes will get lost.
#======================= Global Settings =======================
[global]
workgroup = WORKGROUP
server string = %h server
dns proxy = no
log level = 0
log file = /var/log/samba/log.%m
max log size = 1000
logging = syslog
panic action = /usr/share/samba/panic-action %d
passdb backend = tdbsam
obey pam restrictions = no
unix password sync = no
passwd program = /usr/bin/passwd %u
passwd chat = *Enter\snew\s*\spassword:* %n\n *Retype\snew\s*\spassword:* %n\n *password\supdated\ssuccessfully* .
pam password change = yes
socket options = TCP_NODELAY IPTOS_LOWDELAY
guest account = nobody
load printers = no
disable spoolss = yes
printing = bsd
printcap name = /dev/null
unix extensions = yes
create mask = 0777
directory mask = 0777
map to guest = Bad User
use sendfile = yes
aio read size = 1
aio write size = 1
time server = no
wins support = no
disable netbios = yes
multicast dns register = no
server min protocol = SMB3_00
# Special configuration for Apple's Time Machine
fruit:aapl = yes
fruit:copyfile = yes
fruit:nfs_aces = no
# Extra options
fruit:model = MacRack
access based share enum = yes

veto files = /.DS_Store/.AppleDouble/.AppleDesktop/Network Trash Folder/.AppleDB/.TemporaryItems/Temporary Items/.snapshots
delete veto files = yes

[nobody]
browseable = no

#======================= Share Definitions =======================
[Backups]
comment = External HDD
path = /srv/dev-disk-by-uuid-051c2056-fd32-434f-b257-df5695e4620f/Backups/
guest ok = no
guest only = no
read only = yes
browseable = no
inherit acls = no
inherit permissions = no
ea support = yes
store dos attributes = no
smb encrypt = required
shadow:mountpoint = /srv/dev-disk-by-uuid-051c2056-fd32-434f-b257-df5695e4620f/
shadow:snapdir = /srv/dev-disk-by-uuid-051c2056-fd32-434f-b257-df5695e4620f/.snapshots/
shadow:basedir = /srv/dev-disk-by-uuid-051c2056-fd32-434f-b257-df5695e4620f/Backups/
shadow:sort = desc
shadow:format = _%Y%m%dT%H%M%S
shadow:delimiter = _
shadow:snapprefix = ^Backups\(@hourly\)\{0,1\}\(@daily\)\{0,1\}\(@weekly\)\{0,1\}\(@monthly\)\{0,1\}\(@yearly\)\{0,1\}$
shadow:localtime = no
dfree command = /usr/sbin/omv-btrfs-dfree
dfree cache time = 30
vfs objects = catia fruit streams_xattr btrfs shadow_copy2
printable = no
create mask = 0664
force create mode = 0664
directory mask = 0775
force directory mode = 0775
hide special files = yes
follow symlinks = yes
wide links = no
hide dot files = yes
valid users = @"admins"
invalid users = 
read list = 

[TimeMachine]
comment = macOS Backups
path = /srv/dev-disk-by-uuid-b547fd47-3448-4781-8eec-f53c6284b6d1/Shares/TimeMachine/
guest ok = no
guest only = no
read only = no
browseable = no
inherit acls = yes
inherit permissions = yes
ea support = yes
store dos attributes = no
smb encrypt = required
fruit:encoding = private
fruit:locking = none
fruit:metadata = stream
fruit:resource = file
fruit:veto_appledouble = no
fruit:wipe_intentionally_left_blank_rfork = yes
fruit:delete_empty_adfiles = yes
fruit:time machine = yes
shadow:mountpoint = /srv/dev-disk-by-uuid-b547fd47-3448-4781-8eec-f53c6284b6d1/
shadow:snapdir = /srv/dev-disk-by-uuid-b547fd47-3448-4781-8eec-f53c6284b6d1/.snapshots/
shadow:basedir = /srv/dev-disk-by-uuid-b547fd47-3448-4781-8eec-f53c6284b6d1/Shares/TimeMachine/
shadow:sort = desc
shadow:format = _%Y%m%dT%H%M%S
shadow:delimiter = _
shadow:snapprefix = ^TimeMachine\(@hourly\)\{0,1\}\(@daily\)\{0,1\}\(@weekly\)\{0,1\}\(@monthly\)\{0,1\}\(@yearly\)\{0,1\}$
shadow:localtime = no
dfree command = /usr/sbin/omv-btrfs-dfree
dfree cache time = 30
vfs objects = catia fruit streams_xattr btrfs shadow_copy2
printable = no
create mask = 0664
force create mode = 0664
directory mask = 0775
force directory mode = 0775
hide special files = yes
follow symlinks = yes
wide links = no
hide dot files = yes
valid users = 
invalid users = 
read list = 
write list = 
fruit:time machine max size=500G

[Public]
comment = Drop-Box
path = /srv/dev-disk-by-uuid-b547fd47-3448-4781-8eec-f53c6284b6d1/Shares/Public/
guest ok = yes
guest only = no
read only = no
browseable = yes
inherit acls = yes
inherit permissions = yes
ea support = yes
store dos attributes = no
shadow:mountpoint = /srv/dev-disk-by-uuid-b547fd47-3448-4781-8eec-f53c6284b6d1/
shadow:snapdir = /srv/dev-disk-by-uuid-b547fd47-3448-4781-8eec-f53c6284b6d1/.snapshots/
shadow:basedir = /srv/dev-disk-by-uuid-b547fd47-3448-4781-8eec-f53c6284b6d1/Shares/Public/
shadow:sort = desc
shadow:format = _%Y%m%dT%H%M%S
shadow:delimiter = _
shadow:snapprefix = ^Public\(@hourly\)\{0,1\}\(@daily\)\{0,1\}\(@weekly\)\{0,1\}\(@monthly\)\{0,1\}\(@yearly\)\{0,1\}$
shadow:localtime = no
dfree command = /usr/sbin/omv-btrfs-dfree
dfree cache time = 30
vfs objects = catia fruit streams_xattr btrfs shadow_copy2
printable = no
create mask = 0664
force create mode = 0664
directory mask = 0775
force directory mode = 0775
hide special files = yes
follow symlinks = yes
wide links = no
hide dot files = yes
read list = 
write list = 

[Media]
comment = Guests are read-only
path = /srv/dev-disk-by-uuid-b547fd47-3448-4781-8eec-f53c6284b6d1/Shares/Media/
guest ok = yes
guest only = no
read only = no
browseable = yes
inherit acls = yes
inherit permissions = yes
ea support = yes
store dos attributes = no
shadow:mountpoint = /srv/dev-disk-by-uuid-b547fd47-3448-4781-8eec-f53c6284b6d1/
shadow:snapdir = /srv/dev-disk-by-uuid-b547fd47-3448-4781-8eec-f53c6284b6d1/.snapshots/
shadow:basedir = /srv/dev-disk-by-uuid-b547fd47-3448-4781-8eec-f53c6284b6d1/Shares/Media/
shadow:sort = desc
shadow:format = _%Y%m%dT%H%M%S
shadow:delimiter = _
shadow:snapprefix = ^Media\(@hourly\)\{0,1\}\(@daily\)\{0,1\}\(@weekly\)\{0,1\}\(@monthly\)\{0,1\}\(@yearly\)\{0,1\}$
shadow:localtime = no
dfree command = /usr/sbin/omv-btrfs-dfree
dfree cache time = 30
vfs objects = catia fruit streams_xattr btrfs shadow_copy2
printable = no
create mask = 0664
force create mode = 0664
directory mask = 0775
force directory mode = 0775
hide special files = yes
follow symlinks = yes
wide links = no
hide dot files = yes
read list = 
write list = 
hide unreadable = yes

[Private]
comment = Private Share
path = /srv/dev-disk-by-uuid-b547fd47-3448-4781-8eec-f53c6284b6d1/Shares/Private/
guest ok = no
guest only = no
read only = no
browseable = yes
inherit acls = yes
inherit permissions = yes
ea support = yes
store dos attributes = no
smb encrypt = required
shadow:mountpoint = /srv/dev-disk-by-uuid-b547fd47-3448-4781-8eec-f53c6284b6d1/
shadow:snapdir = /srv/dev-disk-by-uuid-b547fd47-3448-4781-8eec-f53c6284b6d1/.snapshots/
shadow:basedir = /srv/dev-disk-by-uuid-b547fd47-3448-4781-8eec-f53c6284b6d1/Shares/Private/
shadow:sort = desc
shadow:format = _%Y%m%dT%H%M%S
shadow:delimiter = _
shadow:snapprefix = ^Private\(@hourly\)\{0,1\}\(@daily\)\{0,1\}\(@weekly\)\{0,1\}\(@monthly\)\{0,1\}\(@yearly\)\{0,1\}$
shadow:localtime = no
dfree command = /usr/sbin/omv-btrfs-dfree
dfree cache time = 30
vfs objects = catia fruit streams_xattr btrfs shadow_copy2
printable = no
create mask = 0664
force create mode = 0664
directory mask = 0775
force directory mode = 0775
hide special files = yes
follow symlinks = yes
wide links = no
hide dot files = yes
valid users = @"admins"
invalid users = 
read list = 
write list = @"admins"

[FileHistory]
comment = Veeam Backups
path = /srv/dev-disk-by-uuid-b547fd47-3448-4781-8eec-f53c6284b6d1/Shares/FileHistory/
guest ok = no
guest only = no
read only = no
browseable = no
inherit acls = yes
inherit permissions = yes
ea support = yes
store dos attributes = no
smb encrypt = required
shadow:mountpoint = /srv/dev-disk-by-uuid-b547fd47-3448-4781-8eec-f53c6284b6d1/
shadow:snapdir = /srv/dev-disk-by-uuid-b547fd47-3448-4781-8eec-f53c6284b6d1/.snapshots/
shadow:basedir = /srv/dev-disk-by-uuid-b547fd47-3448-4781-8eec-f53c6284b6d1/Shares/FileHistory/
shadow:sort = desc
shadow:format = _%Y%m%dT%H%M%S
shadow:delimiter = _
shadow:snapprefix = ^FileHistory\(@hourly\)\{0,1\}\(@daily\)\{0,1\}\(@weekly\)\{0,1\}\(@monthly\)\{0,1\}\(@yearly\)\{0,1\}$
shadow:localtime = no
dfree command = /usr/sbin/omv-btrfs-dfree
dfree cache time = 30
vfs objects = catia fruit streams_xattr btrfs shadow_copy2
printable = no
create mask = 0664
force create mode = 0664
directory mask = 0775
force directory mode = 0775
hide special files = yes
follow symlinks = yes
wide links = no
hide dot files = yes
valid users = 
invalid users = 
read list = 
write list = 

#======================= Home Directories =======================
[homes]
comment = Home directories
browseable = no
inherit acls = yes
inherit permissions = yes
writable = yes
create mask = 0600
force create mode = 0600
directory mask = 0700
force directory mode = 0700
valid users = %S
hide special files = yes
follow symlinks = yes
wide links = no
shadow:mountpoint = /srv/dev-disk-by-uuid-b547fd47-3448-4781-8eec-f53c6284b6d1/
shadow:snapdir = /srv/dev-disk-by-uuid-b547fd47-3448-4781-8eec-f53c6284b6d1/.snapshots/
shadow:basedir = /srv/dev-disk-by-uuid-b547fd47-3448-4781-8eec-f53c6284b6d1/Shares/Users/
shadow:sort = desc
shadow:format = _%Y%m%dT%H%M%S
shadow:delimiter = _
shadow:snapprefix = ^homes\(@hourly\)\{0,1\}\(@daily\)\{0,1\}\(@weekly\)\{0,1\}\(@monthly\)\{0,1\}\(@yearly\)\{0,1\}$
shadow:localtime = no
dfree command = /usr/sbin/omv-btrfs-dfree
dfree cache time = 30
vfs objects = catia fruit streams_xattr btrfs shadow_copy2

Display More

Spy Alelo · Feb 8th 2025

And before anyone asks, browsing this data from a mapped share or URI yields the same result. Here it is doing it from the URI itself, same issue:

I also thought this was a permission issue, but that's not the case. Whenever the snapshots are created, something's wrong with how the path is presented when trying to copy from them. I'm pulling my hair out trying to figure this out.

Spy Alelo · Feb 8th 2025

Confirmed, the Previous Versions prompt is definitely serving the files off the SMB share when going through sub-directories, not the .snapshots directory:

Files at the top level can be recovered. I can't figure out the why, the parameters seem correct for smb.conf and I've tried all types of combinations here. I can't really tell if this is a bug or a misconfiguration.

Krisbee · Feb 8th 2025

All I can say is things work as you might expect in his example:

On OMV:

Code

root@omvt:~# smbstatus

Samba version 4.17.12-Debian
PID     Username     Group        Machine                                   Protocol Version  Encryption           Signing              
----------------------------------------------------------------------------------------------------------------------------------------
5579    chris        users        192.168.0.202 (ipv4:192.168.0.202:55510)  SMB3_11           -                    partial(AES-128-GMAC)
5724    chris        users        192.168.0.200 (ipv4:192.168.0.200:49845)  SMB3_11           -                    partial(AES-128-CMAC)

Service      pid     Machine       Connected at                     Encryption   Signing     
---------------------------------------------------------------------------------------------
bfolder      5579    192.168.0.202 Sat Feb  8 22:09:05 2025 GMT     -            -           
IPC$         5724    192.168.0.200 Sat Feb  8 22:09:33 2025 GMT     -            -           
bfolder      5724    192.168.0.200 Sat Feb  8 22:12:32 2025 GMT     -            -           


Locked files:
Pid          User(ID)   DenyMode   Access      R/W        Oplock           SharePath   Name   Time
--------------------------------------------------------------------------------------------------
5724         1000       DENY_NONE  0x100081    RDONLY     NONE             /srv/dev-disk-by-uuid-8bce20a9-0f96-4bac-a19c-2ebd95e356da/bfolder   .   Sat Feb  8 22:12:32 2025
5724         1000       DENY_NONE  0x100081    RDONLY     NONE             /srv/dev-disk-by-uuid-8bce20a9-0f96-4bac-a19c-2ebd95e356da/bfolder   .   Sat Feb  8 22:12:32 2025
5724         1000       DENY_NONE  0x100081    RDONLY     NONE             /srv/dev-disk-by-uuid-8bce20a9-0f96-4bac-a19c-2ebd95e356da/bfolder   .   Sat Feb  8 22:12:32 2025
5724         1000       DENY_NONE  0x100081    RDONLY     NONE             /srv/dev-disk-by-uuid-8bce20a9-0f96-4bac-a19c-2ebd95e356da/bfolder   .   Sat Feb  8 22:12:32 2025
5579         1000       DENY_NONE  0x81        RDONLY     NONE             /srv/dev-disk-by-uuid-8bce20a9-0f96-4bac-a19c-2ebd95e356da/bfolder   .   Sat Feb  8 22:09:05 2025

root@omvt:~#

Display More

Extract from smb.conf:

Code

[bfolder]
        create mask = 0664
        dfree cache time = 30
        dfree command = /usr/sbin/omv-btrfs-dfree
        directory mask = 0775
        force create mode = 0664
        force directory mode = 0775
        hide special files = Yes
        path = /srv/dev-disk-by-uuid-8bce20a9-0f96-4bac-a19c-2ebd95e356da/bfolder/
        read only = No
        store dos attributes = No
        valid users = chris
        vfs objects = btrfs shadow_copy2
        write list = chris
        shadow:localtime = no
        shadow:snapprefix = ^bfolder\(@hourly\)\{0,1\}\(@daily\)\{0,1\}\(@weekly\)\{0,1\}\(@monthly\)\{0,1\}\(@yearly\)\{0,1\}$
        shadow:delimiter = _
        shadow:format = _%Y%m%dT%H%M%S
        shadow:sort = desc
        shadow:basedir = /srv/dev-disk-by-uuid-8bce20a9-0f96-4bac-a19c-2ebd95e356da/bfolder/
        shadow:snapdir = /srv/dev-disk-by-uuid-8bce20a9-0f96-4bac-a19c-2ebd95e356da/.snapshots/
        shadow:mountpoint = /srv/dev-disk-by-uuid-8bce20a9-0f96-4bac-a19c-2ebd95e356da/
root@omvt:~# 

root@omvt:~# btrfs sub li /srv/dev-disk-by-uuid-8bce20a9-0f96-4bac-a19c-2ebd95e356da/
ID 256 gen 15 top level 5 path bfolder
ID 257 gen 13 top level 5 path .snapshots
ID 258 gen 15 top level 257 path .snapshots/bfolder_20250208T180956
root@omvt:~#

Display More

I've not created a separate share of the snapshot itself. My smb conf does not contain all the additional MACOS params you have.

Spy Alelo · Feb 8th 2025

Can you try moving a sub-directory and recover from the snapshots?

As long as my original data is intact, I can browse/read every sub-directory. The issue is when the sub-directory is missing from the original path.

Krisbee · Feb 9th 2025

A new day and a chance for further tests. But I've not been able to replicate your problem.

My actions since yesterday:

1. Modified my share config to include additional params and vfs objects to more closely match those of your "media" share.

2. Explicitly "shared" one my "bfolder" snapshots.

3. Used file explorer in Windows 10 and Windows 11 .

The result is recovery from "previous versions" via Windows file explorer works as expected when deleting and moving data around from the orig folder. At no time does a snapshot path appear in the out put of "smbstatus" in OMV. Please note none of the data I shared used ACLs.

Outputs:

Code

[bfolder]
        create mask = 0664
        dfree cache time = 30
        dfree command = /usr/sbin/omv-btrfs-dfree
        directory mask = 0775
        force create mode = 0664
        force directory mode = 0775
        hide special files = Yes
        inherit acls = Yes
        inherit permissions = Yes
        path = /srv/dev-disk-by-uuid-8bce20a9-0f96-4bac-a19c-2ebd95e356da/bfolder/
        read only = No
        server smb encrypt = required
        store dos attributes = No
        valid users = @admins
        vfs objects = catia fruit streams_xattr btrfs shadow_copy2
        write list = @admins
        shadow:localtime = no
        shadow:snapprefix = ^bfolder\(@hourly\)\{0,1\}\(@daily\)\{0,1\}\(@weekly\)\{0,1\}\(@monthly\)\{0,1\}\(@yearly\)\{0,1\}$
        shadow:delimiter = _
        shadow:format = _%Y%m%dT%H%M%S
        shadow:sort = desc
        shadow:basedir = /srv/dev-disk-by-uuid-8bce20a9-0f96-4bac-a19c-2ebd95e356da/bfolder/
        shadow:snapdir = /srv/dev-disk-by-uuid-8bce20a9-0f96-4bac-a19c-2ebd95e356da/.snapshots/
        shadow:mountpoint = /srv/dev-disk-by-uuid-8bce20a9-0f96-4bac-a19c-2ebd95e356da/

Display More

Code

root@omvt:~# ls -l /srv/dev-disk-by-uuid-8bce20a9-0f96-4bac-a19c-2ebd95e356da/bfolder/
total 0
drwxrwsr-x 1 chris users 11046 Feb  9 09:40 "D'Anglebert_Celine_Fisch"
drwxrwsr-x 1 chris users 14322 Feb  9 07:49  Dunedin_Samson
drwxrwsr-x 1 chris users  9576 Feb  9 07:49  Marais_Alcione
drwxrwsr-x 1 chris users  4364 Feb  9 07:49  Marias_La_Reveuse
drwxrwsr-x 1 chris users  5890 Feb  9 07:49  Telemann_Chameleon
drwxrwsr-x 1 chris users 13164 Feb  9 07:49 'Víkingur Ólafsson – Bach'
drwxrwsr-x 1 chris users  5048 Feb  9 07:49 'Vikingur Olafsson - Debussy Rameau'
root@omvt:~# btrfs sub li -t /srv/dev-disk-by-uuid-8bce20a9-0f96-4bac-a19c-2ebd95e356da/
ID      gen     top level       path
--      ---     ---------       ----
256     41      5               bfolder
257     40      5               .snapshots
260     35      257             .snapshots/bfolder_20250209T072335
261     23      257             .snapshots/bfolder_20250209T072400
262     30      257             .snapshots/bfolder_20250209T072445
263     39      257             .snapshots/bfolder_20250209T100509
root@omvt:~# tree -L 2 -ld /srv/dev-disk-by-uuid-8bce20a9-0f96-4bac-a19c-2ebd95e356da/.snapshots/
/srv/dev-disk-by-uuid-8bce20a9-0f96-4bac-a19c-2ebd95e356da/.snapshots/
├── bfolder_20250209T072335
│   ├── D'Anglebert_Celine_Fisch
│   ├── Marias_La_Reveuse
│   └── Telemann_Chameleon
├── bfolder_20250209T072400
│   ├── D'Anglebert_Celine_Fisch
│   ├── Marais_Alcione
│   ├── Marias_La_Reveuse
│   └── Telemann_Chameleon
├── bfolder_20250209T072445
│   ├── D'Anglebert_Celine_Fisch
│   ├── Dunedin_Samson
│   ├── Marais_Alcione
│   ├── Marias_La_Reveuse
│   ├── Telemann_Chameleon
│   ├── Víkingur Ólafsson – Bach
│   └── Vikingur Olafsson - Debussy Rameau
└── bfolder_20250209T100509
    ├── D'Anglebert_Celine_Fisch
    ├── Dunedin_Samson
    ├── Marais_Alcione
    ├── Marias_La_Reveuse
    ├── Telemann_Chameleon
    ├── Víkingur Ólafsson – Bach
    └── Vikingur Olafsson - Debussy Rameau

26 directories
root@omvt:

Display More

BTRFS Snapshots / Windows Previous Versions

ryecoaaron Feb 8th 2025

Spy Alelo Feb 8th 2025

Participate now!

Similar Threads

Fresh install, Shared Folders + ZFS - Error 500.

btrfs weirdness - disk space running out

Pool configuration and format type suggestion

Tags