Evidence-led NFS/SMB access triage · compare exact operation and identity
Example: a Linux host can ping the data LIF but gets NFS access denied. This is an authorization or path problem until evidence shows otherwise.
About the command and output examples
Names, addresses and results are illustrative. Commands have not been executed against a live storage system or SAN switch for this publication. Confirm syntax and compatibility for your release, then rehearse in an approved lab. Existing-data recovery and destructive changes need an environment-specific plan. Read the editorial standards.
01Scope the symptom
- Record client address, user identity, SVM/data LIF, exact path/share, protocol version, error text, first failure time, and whether other clients work.
- Resolve the name from the client and connect to the data LIF. If connection times out, inspect VLAN, route, firewall, port and LIF. If connection succeeds but access is denied, inspect policy and identity.
network interface show
network route show
event log show -severity ERROR02NFS branch
- Confirm the junction path is mounted and each parent path can be traversed. Inspect export policy on the volume and rule order, client match, protocol, read/write security, superuser treatment, and UNIX ownership.
- Test a single authorized client using the exact LIF and path. Do not broaden the rule to all clients merely as a diagnostic.
vserver nfs show
volume show -fields junction-path,policy
vserver export-policy rule show03SMB branch
- Confirm the SMB server is joined to AD, DNS and time are healthy, and the share points to the expected volume path.
- Inspect share permissions and file-system ACLs with the user token and group memberships. Test another known-good user to isolate identity versus share-wide failure.
vserver cifs show
vserver cifs share showThe root cause is tied to one layer and access is retested with the original user.
04Worked comparison: one client fails while a peer works
Example NFS case: two clients use the same export, but the failing client is behind a new routed/NAT path. Its address as seen by ONTAP no longer matches the narrow export rule. Once that address is established, the owner can approve a targeted network or export change. Copying a wide subnet rule from a working application would hide the address issue and change authorization scope.
| Question | Failing client | Working comparison |
|---|---|---|
| Name resolution | Record returned address | Same intended endpoint? |
| Route and transport | Timeout or connection succeeds? | Same network/VLAN/firewall policy? |
| Protocol operation | Mount, browse, open, create or rename? | Same operation and version? |
| Identity | UID/GID or authenticated Windows token | Same relevant groups and mappings? |
| Path | Exact junction/share/folder | Same filesystem object and effective ACL? |
- Collect the exact error and time from the client, then establish whether transport succeeded.
- For NFS, use the expanded NFS guide’s check-access command and compare numeric file ownership. For SMB, compare the authenticated session identity, share boundary and filesystem ACL.
- Apply one approved correction and re-run the original operation. Keep a known-denied client/user test to detect accidental access expansion.
05When the scope points to a shared dependency
When all clients fail at once, compare the outage time with LIF/port events, volume state, protocol service changes and DNS/directory availability. When only one folder fails, prioritize its namespace junction and effective security. When file opens slow after antivirus integration but existing transfers are normal, include Vscan/FPolicy service availability in the comparison. These scopes guide the next test; none prove a cause without evidence.
The closure identifies the first failing layer, the exact configuration correction and a successful original-user retest.
Use the section links to revisit a step, or follow a related guide below.
Official references and further reading
Choose the matching release in the vendor documentation before using a command or design. References open on the publisher’s website; linked material remains with its publisher.