mirror of
https://github.com/freebsd/freebsd-src
synced 2024-10-07 09:00:28 +00:00
Update the man page to reflect the addition of NFSv4.2 (r355677).
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:
parent
2ec2bb18aa
commit
9449898858
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=355960
|
@ -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
|
||||||
|
|
Loading…
Reference in a new issue