system/freebsd-src
system/freebsd-src
1
0
Fork 0
mirror of https://github.com/freebsd/freebsd-src synced 2024-10-07 09:00:28 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update the man page to reflect the addition of NFSv4.2 (r355677).

Browse source 
Update all the references to NFSv4.1, so that they apply to NFSv4.1 and
NFSv4.2. Also, change the MDS->DS mounts to use NFSv4.2, so that both
versions of the protocol can be used against the server with pNFS enabled.

This is a content change.
This commit is contained in:
Rick Macklem 2019-12-20 21:45:20 +00:00
parent 2ec2bb18aa
commit 9449898858
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=355960
1 changed files with 26 additions and 15 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

41
usr.sbin/nfsd/pnfsserver.4
View file

@ -23,12 +23,12 @@
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd August 8, 2018 .Dd December 20, 2019
.Dt PNFSSERVER 4 .Dt PNFSSERVER 4
.Os .Os
.Sh NAME .Sh NAME
.Nm pNFSserver .Nm pNFSserver
.Nd NFS Version 4.1 Parallel NFS Protocol Server .Nd NFS Version 4.1 and 4.2 Parallel NFS Protocol Server
.Sh DESCRIPTION .Sh DESCRIPTION
A set of FreeBSD servers may be configured to provide a A set of FreeBSD servers may be configured to provide a
.Xr pnfs 4 .Xr pnfs 4
@ -37,13 +37,23 @@ One FreeBSD system needs to be configured as a MetaData Server (MDS) and
at least one additional FreeBSD system needs to be configured as one or at least one additional FreeBSD system needs to be configured as one or
more Data Servers (DS)s. more Data Servers (DS)s.
.Pp .Pp
These FreeBSD systems are configured to be NFSv4.1 servers, see These FreeBSD systems are configured to be NFSv4.1 and NFSv4.2
servers, see
.Xr nfsd 8 .Xr nfsd 8
and and
.Xr exports 5 .Xr exports 5
if you are not familiar with configuring a NFSv4.1 server. if you are not familiar with configuring a NFSv4.n server.
All DS(s) and the MDS should support NFSv4.2 as well as NFSv4.1.
Mixing an MDS that supports NFSv4.2 with any DS(s) that do not support
NFSv4.2 will not work correctly.
As such, all DS(s) must be upgraded from
.Fx 12
to
.Fx 13
before upgrading the MDS.
.Sh DS server configuration .Sh DS server configuration
The DS(s) need to be configured as NFSv4.1 server(s), with a top level exported The DS(s) need to be configured as NFSv4.1 and NFSv4.2 server(s),
with a top level exported
directory used for storage of data files. directory used for storage of data files.
This directory must be owned by This directory must be owned by
.Dq root .Dq root
@ -89,8 +99,8 @@ DS system.
.Sh MDS server configuration .Sh MDS server configuration
The MDS must be a separate FreeBSD system from the FreeBSD DS system(s) and The MDS must be a separate FreeBSD system from the FreeBSD DS system(s) and
NFS clients. NFS clients.
It is configured as a NFSv4.1 server with file system(s) exported to It is configured as a NFSv4.1 and NFSv4.2 server with
clients. file system(s) exported to clients.
However, the However, the
.Dq -p .Dq -p
command line argument for command line argument for
@ -99,7 +109,7 @@ is used to indicate that it is running as the MDS for a pNFS server.
.Pp .Pp
The DS(s) must all be mounted on the MDS using the following mount options: The DS(s) must all be mounted on the MDS using the following mount options:
.Bd -literal -offset indent .Bd -literal -offset indent
nfsv4,minorversion=1,soft,retrans=2 nfsv4,minorversion=2,soft,retrans=2
.Ed .Ed
.sp .sp
so that they can be defined as DSs in the so that they can be defined as DSs in the
@ -112,10 +122,10 @@ For example, if there are four DSs named nfsv4-data[0-3], the
.Xr fstab 5 .Xr fstab 5
lines might look like: lines might look like:
.Bd -literal -offset .Bd -literal -offset
nfsv4-data0:/ /data0 nfs rw,nfsv4,minorversion=1,soft,retrans=2 0 0 nfsv4-data0:/ /data0 nfs rw,nfsv4,minorversion=2,soft,retrans=2 0 0
nfsv4-data1:/ /data1 nfs rw,nfsv4,minorversion=1,soft,retrans=2 0 0 nfsv4-data1:/ /data1 nfs rw,nfsv4,minorversion=2,soft,retrans=2 0 0
nfsv4-data2:/ /data2 nfs rw,nfsv4,minorversion=1,soft,retrans=2 0 0 nfsv4-data2:/ /data2 nfs rw,nfsv4,minorversion=2,soft,retrans=2 0 0
nfsv4-data3:/ /data3 nfs rw,nfsv4,minorversion=1,soft,retrans=2 0 0 nfsv4-data3:/ /data3 nfs rw,nfsv4,minorversion=2,soft,retrans=2 0 0
.Ed .Ed
.sp .sp
The The
@ -201,7 +211,8 @@ For a service that will store a large number of files this sysctl should be
set much larger, to avoid the number of entries in a subdirectory from set much larger, to avoid the number of entries in a subdirectory from
getting too large. getting too large.
.Sh Client mounts .Sh Client mounts
Once operational, NFSv4.1 FreeBSD client mounts done with the Once operational, NFSv4.1 or NFSv4.2 FreeBSD client mounts
done with the
.Dq pnfs .Dq pnfs
option should do I/O directly on the DSs. option should do I/O directly on the DSs.
The clients mounting the MDS must be running the The clients mounting the MDS must be running the
@ -325,7 +336,7 @@ directory for storage of data files just like it did when first set up.
Mount it on the MDS exactly as you did before disabling it. Mount it on the MDS exactly as you did before disabling it.
For the nfsv4-data3 example, the command would be: For the nfsv4-data3 example, the command would be:
.Bd -literal -offset .Bd -literal -offset
# mount -t nfs -o nfsv4,minorversion=1,soft,retrans=2 nfsv4-data3:/ /data3 # mount -t nfs -o nfsv4,minorversion=2,soft,retrans=2 nfsv4-data3:/ /data3
.Ed .Ed
.sp .sp
Then restart the nfsd to re-enable the DS. Then restart the nfsd to re-enable the DS.
@ -403,7 +414,7 @@ http://people.freebsd.org/~rmacklem/pnfs-planb-setup.txt
.Sh HISTORY .Sh HISTORY
The The
.Nm .Nm
command first appeared in service first appeared in
.Fx 12.0 . .Fx 12.0 .
.Sh BUGS .Sh BUGS
Since the MDS cannot be mirrored, it is a single point of failure just Since the MDS cannot be mirrored, it is a single point of failure just