ONTAP Troubleshooting — Every Runbook in One Place

When something breaks, the first ten minutes decide the outcome: capture evidence, rank the likely causes, and test the cheapest fix first. These runbooks follow exactly that pattern — symptom to command to resolution — across networking, protocols, replication, upgrades, and space management.

Network & connectivity troubleshooting

LIFs, routes, ports, MTU, cluster interconnect: ping to packet level.

NFS troubleshooting

Mount failures, performance, permissions, and protocol-level debugging.

NFSv4 ACL troubleshooting

ACL inheritance, ID mapping, and permission denial debugging.

SMB/CIFS troubleshooting

Auth failures, share permissions, slow transfers, browsing issues.

S3 object storage troubleshooting

SigV4 403s, time skew, bucket policies, ghost multipart usage.

SnapMirror troubleshooting

Lag, broken relationships, seeding failures, resync issues.

ONTAP upgrade troubleshooting

ANDU vetoes, paused updates, rollback, mixed-version operation.

MetroCluster troubleshooting

Switchover failures, mediator quorum, forced quorum risk.

Aggregate offline recovery

Bringing aggregates back, degraded vs offlined, reconstruction.

Volume space troubleshooting

Full volumes, snapshot reserves, autodelete, ghost usage.

Performance troubleshooting

Latency hot spots, queue depth, slow clients, saturation.

Backup & restore troubleshooting

SnapVault/NDMP/SnapCenter job failures and restore problems.

Common problems

The frequent-failure quick reference.

Decommission troubleshooting

Safe hardware removal, data migration, cleanup.

Proxmox on ONTAP

NFS/iSCSI with Proxmox VE: setup and troubleshooting.

ONTAP error codes

What ONTAP error codes mean and how to fix them.

Top 20 ONTAP mistakes

The mistakes that cause most outages, and how to avoid them.