Home / Troubleshooting
Troubleshooting Guides
The problems that actually show up in the field, with the diagnosis path and the commands that resolve them. Each guide: symptoms → checks → fix → prevention.
Volume space exhaustion
"Volume is full": snapshots holding deleted data, overcommitment, inode pressure, and how to reclaim space safely.
Performance analysis
Latency is up. Find the bottleneck: node CPU, disk utilization, protocol ops, and per-volume latency via sysstat and QoS statistics.
SnapMirror problems
Growing lag, failed transfers, stuck relationships — and how to break, resync, and restore without losing data.
NFS mount failures
Permission denied, RPC errors, and hangs: export policies, LIFs, routing, sec flavors, and the NFSv4 domain.
SMB/CIFS deep-dive
Shares, share ACLs vs NTFS ACLs, AD/Kerberos integration, SMB 3.x features (multichannel, encryption, CA), and the access-denied / auth-failure paths — with real commands.
MetroCluster DR failover
When a site dies: switchover and switchback workflows, mediator status checks, and what to verify after the dust settles.
set -privilege advanced where noted. Run man <command> on the system for flag details — commands below target ONTAP 9.x.