Date: Sun, 29 Apr 2018 11:46:21 +0000 (UTC) From: Rick Macklem <rmacklem@FreeBSD.org> To: src-committers@freebsd.org, svn-src-projects@freebsd.org Subject: svn commit: r333090 - projects/pnfs-planb-server/usr.sbin/nfsd Message-ID: <201804291146.w3TBkL4b020559@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
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 ,
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201804291146.w3TBkL4b020559>