From owner-svn-src-projects@freebsd.org Sun Apr 29 11:46:21 2018 Return-Path: Delivered-To: svn-src-projects@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id BD09EFAA55D for ; Sun, 29 Apr 2018 11:46:21 +0000 (UTC) (envelope-from rmacklem@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 6B9EB7B265; Sun, 29 Apr 2018 11:46:21 +0000 (UTC) (envelope-from rmacklem@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 5743C23E51; Sun, 29 Apr 2018 11:46:21 +0000 (UTC) (envelope-from rmacklem@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id w3TBkLhl020560; Sun, 29 Apr 2018 11:46:21 GMT (envelope-from rmacklem@FreeBSD.org) Received: (from rmacklem@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id w3TBkL4b020559; Sun, 29 Apr 2018 11:46:21 GMT (envelope-from rmacklem@FreeBSD.org) Message-Id: <201804291146.w3TBkL4b020559@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: rmacklem set sender to rmacklem@FreeBSD.org using -f From: Rick Macklem Date: Sun, 29 Apr 2018 11:46:21 +0000 (UTC) To: src-committers@freebsd.org, svn-src-projects@freebsd.org Subject: svn commit: r333090 - projects/pnfs-planb-server/usr.sbin/nfsd X-SVN-Group: projects X-SVN-Commit-Author: rmacklem X-SVN-Commit-Paths: projects/pnfs-planb-server/usr.sbin/nfsd X-SVN-Commit-Revision: 333090 X-SVN-Commit-Repository: base MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-projects@freebsd.org X-Mailman-Version: 2.1.25 Precedence: list List-Id: "SVN commit messages for the src " projects" tree" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 29 Apr 2018 11:46:22 -0000 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 ,