IBM AIX 7.3 – Common Problem 134 – Diagnosis and Fix

📖 ~1 min read

Table of contents

1. Symptom & Impact
2. Environment & Reproduction
3. Root Cause Analysis
4. Quick Triage
5. Step-by-Step Diagnosis
6. Solution – Primary Fix
7. Solution – Alternative Approaches
8. Verification & Acceptance Criteria
9. Rollback Plan
10. Prevention & Hardening
11. Related Errors & Cross-Refs
12. References & Further Reading

Symptom & Impact

Clients log `Stale file handle` when reading from an AIX 7.3 NFS v3/v4 export.

Environment & Reproduction

AIX NFS server where an exported filesystem was unmounted/remounted or fsid changed.

Root Cause Analysis

Exported fsid changed after `chfs` resize or `varyoffvg`/`varyonvg`, invalidating client handles.

Quick Triage

Run `exportfs -v`, `showmount -e`, and `nfsstat -s` on the server.

Step-by-Step Diagnosis

Capture `lsfs -q /export/share`, `lsof /export/share`, and `errpt | grep NFS`.

Solution – Primary Fix

Re-export with a stable fsid: `exportfs -i -o vers=4,fsid=42 /export/share`.

Solution – Alternative Approaches

Unmount on clients and remount with `mount -o vers=4 server:/export /mnt` to refresh handles.

Verification & Acceptance Criteria

`nfsstat -c` on clients shows no `badcalls` increment and reads succeed cleanly.

Rollback Plan

`exportfs -u /export/share` and revert to the previous `/etc/exports` stanza.

Prevention & Hardening

Pin `fsid` per export and avoid `chfs -a size=` operations during business hours.

Related Errors & Cross-Refs

Pairs with `nfs4_acl` warnings and Kerberos rpc.gssd errors on mixed clients.

Related tutorial: View the step-by-step tutorial for aix-7.3.

View all aix-7.3 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

IBM Docs: `exportfs`, AIX NFS v4 admin guide, `nfsstat`.