IN THIS ARTICLE
This article explains the recommended NFS mount options for macOS and Linux. For more information, see Enabling and Using NFSv4.1 on a Qumulo Cluster and Managing File Access Permissions Using NFSv4.1 Access Control Lists (ACLs).
DETAILS
Verify Current NFS Mount Options
To list the NFS mount options currently used for all NFS mounts, use the following command.
nfsstat -m
Recommended Mount Options for macOS 11 (and Higher)
macOS 11 (and higher) supports 1 MB read and write blocks. This can help improve NFS client performance.
Client with Server-Side Network Lock Manager (NLM) Enabled
mount -t nfs \
-o vers=3,intr,hard,tcp,rdirplus,readahead=128,rsize=1048576,wsize=1048576 \
qumulo.hostname:/share /path/to/mountpoint
Client with Local Locking Enforced
mount -t nfs \
-o rsize=65536,wsize=65536,intr,hard,tcp,locallocks,rdirplus,readahead=128 \
qumulo.hostname:/share /path/to/mountpoint
Note: Mac clients don't support NFSv4.1.
Recommended Mount Options for macOS 10.15 (and Lower)
Client with Server-Side Network Lock Manager (NLM) Enabled
mount -t nfs \
-o rsize=65536,wsize=65536,intr,hard,tcp,rdirplus,readahead=128 \
qumulo.hostname:/share /path/to/mountpoint
Client with Local Locking Enforced
mount -t nfs \
-o rsize=65536,wsize=65536,intr,hard,tcp,locallocks,rdirplus,readahead=128 \
qumulo.hostname:/share /path/to/mountpoint
Note: Mac clients don't support NFSv4.1.
Recommended Mount Options for Linux
Notes
- In Linux kernel 5.3 (and higher), the
nconnect
option allows multiple TCP connections for a single NFS mount.
Note: Currently, the maximum number of concurrent TCP connections is 16. - In Linux kernel 2.6.25 (and higher), the
intr
andnointr
mount options are deprecated. If you use thehard
option on modern Linux kernels, you must use thekill -9
(SIGKILL)
command to interrupt a stuck NFS mount.
Client with NFSv3 and NLM Locking Enabled
mount -t nfs \
-o vers=3,tcp,nconnect=16 \
qumulo.hostname:/share /path/to/mountpoint
Client with NFSv3 and NLM Locking Disabled and Local Locking Enforced
mount -t nfs \
-o vers=3,tcp,local_lock=all,nconnect=16 \
qumulo.hostname:/share /path/to/mountpoint
Client with NFSv4.1 and AUTH_SYS Authentication.
Note: AUTH_SYS
authentication uses UIDs and GIDs.
mount -t nfs \
-o vers=4.1,tcp,sec=sys,nconnect=16 \
qumulo.hostname:/share /path/to/mountpoint
Comments
2 comments