svn commit: r333090 - projects/pnfs-planb-server/usr.sbin/nfsd

[Rick Macklem]

Author: rmacklem
Date: Sun Apr 29 11:46:20 2018
New Revision: 333090
URL: https://svnweb.freebsd.org/changeset/base/333090

Log:
  Update the nfsd.8 man page for mirrored DSs.

Modified:
  projects/pnfs-planb-server/usr.sbin/nfsd/nfsd.8

Modified: projects/pnfs-planb-server/usr.sbin/nfsd/nfsd.8
==============================================================================
--- projects/pnfs-planb-server/usr.sbin/nfsd/nfsd.8	Sun Apr 29 10:45:09 2018	(r333089)
+++ projects/pnfs-planb-server/usr.sbin/nfsd/nfsd.8	Sun Apr 29 11:46:20 2018	(r333090)
@@ -114,9 +114,8 @@ as a Data Server (DS) for it to use.
 .Pp
 The
 .Ar pnfs_setup
-string is a set of ',' separated fields:
+string is a set of fields separated by ',' and '#' characters:
 .Bl -tag -width Ds
-.It
 Each of these fields specifies one Data Server.
 It consists of a server hostname, followed by a ':'
 and the directory path where the DS's data storage file system is mounted on
@@ -126,12 +125,30 @@ The DS storage file systems must be mounted on this sy
 is started with this option specified.
 For example:
 .sp
-nfsv4-ds0:/DS0,nfsv4-ds1:/DS1
+nfsv4-data0:/data0,nfsv4-data1:/data1
 .sp
-Would specify two DS servers called nfsv4-ds0 and nfsv4-ds1 that comprise the
-data storage component of the pNFS service.
-The directories "/DS0" and "/DS1" are where the DS storage servers exported
+Would specify two DS servers called nfsv4-data0 and nfsv4-data1 that comprise
+the data storage component of the pNFS service.
+The directories "/data0" and "/data1" are where the data storage servers exported
 storage directories are mounted on this system (which will act as the MDS).
+.Pp
+If the fields are separated by the '#' character, it indicates that these
+DSs are to be configured as a mirrored set.
+For example:
+.sp
+nfsv4-data0:/data0#nfsv4-data1:/data1,nfsv4-data2:/data2#nfsv4-data3:/data3
+.sp
+Would specify two mirrored pairs of DSs, with nfsv4-data0 plus nfsv4-data1
+comprising one mirrored pair and nfsv4-data2 plus nfsv4-data3 comprising
+the other mirrored pair.
+.Pp
+If there are mirrored sets of DSs, the server must use the Flexible File
+layout.
+If there are no mirrored sets of DSs, the server will use the File layout
+by default, but this default can be changed to the Flexible File layout if the
+.Xr sysctl 1
+vfs.nfsd.default_flexfile
+is set non-zero.
 .El
 .It Fl t
 Serve
@@ -155,7 +172,7 @@ transports using six daemons.
 .Pp
 A server should run enough daemons to handle
 the maximum level of concurrency from its clients,
-typically four to six.
+typically four or more per CPU core.
 .Pp
 The
 .Nm
@@ -165,9 +182,11 @@ server specification; see
 .%T "Network File System Protocol Specification" ,
 RFC1094,
 .%T "NFS: Network File System Version 3 Protocol Specification" ,
-RFC1813 and
+RFC1813,
 .%T "Network File System (NFS) Version 4 Protocol" ,
-RFC3530.
+RFC3530 and
+.%T "Network File System (NFS) Version 4 Minor Version 1 Protocol" ,
+RFC5661.
 .Pp
 If
 .Nm
@@ -243,6 +262,7 @@ just do a
 .Xr kldload 2 ,
 .Xr nfssvc 2 ,
 .Xr nfsv4 4 ,
+.Xr pnfs 4 ,
 .Xr exports 5 ,
 .Xr stablerestart 5 ,
 .Xr gssd 8 ,