Linux Clients Show "Stale File Handle" in df or mount for Deleted NetApp Snapshots (.snapshot) – NFS Auto-Mount Behavior
Applies to
- ONTAP 9
- NFS
- Linux kernel 2.6.18 and later versions
Issue
- Modern Linux clients identifies the
.snapshotdirectory as a different filesystem, and thus as a different mount point. - When the snapshot is deleted, clients report
stale file handlefor.snapshotbased sub-mounts. - Observing stale file handle error on the daily snapshot volume.
df -h
df: ‘/home/oracle/.snapshot/daily.2025-09-22_0010’: Stale file handle
df: ‘/home/oracle/.snapshot/daily.2025-09-17_0010’: Stale file handle
df: ‘/home/oracle/.snapshot/daily.2025-09-28_0010’: Stale file handle
df: ‘/home/oracle/.snapshot/monthly.2025-08-25_0000’: Stale file handle
- Restart of the linux nfs client resolve's the previous day's snapshot which have already been deleted.
mountcommand on the Linux host displays a large number of snapshots mounted and is not able to unmount.
1.1.1.1:/some_export/cluster/.snapshot/hourly.2015-08-03_0705 on /some-mount/.snapshot/hourly.2015-08-03_0705 type nfs (rw,relatime,vers=3,rsize=32768,wsize=32768,namlen=255,soft,proto=tcp,timeo=600,retrans=2,sec=sys,mountproto=,local_lock=none,addr=10.1.100.101)
