Page MenuHomeFreeBSD
Files F102194903

D31145.diff
No OneTemporary
Actions

D31145.diff
View Options

diff --git a/usr.sbin/nfsd/nfsv4.4 b/usr.sbin/nfsd/nfsv4.4
--- a/usr.sbin/nfsd/nfsv4.4
+++ b/usr.sbin/nfsd/nfsv4.4
@@ -143,7 +143,9 @@
However, this can normally be overridden by a command line
option or configuration file for the daemon used to do the name<->number
mapping.
-Under FreeBSD, the mapping daemon is called
+Under
+.Fx ,
+the mapping daemon is called
.Xr nfsuserd 8
and has a command line option that overrides the domain component of the
machine's hostname.
diff --git a/usr.sbin/nfsd/pnfs.4 b/usr.sbin/nfsd/pnfs.4
--- a/usr.sbin/nfsd/pnfs.4
+++ b/usr.sbin/nfsd/pnfs.4
@@ -54,10 +54,14 @@
The first is DeviceInfo, which is static information defining the DS
server.
The critical piece of information in DeviceInfo for the layout types
-supported by FreeBSD is the IP address that is used to perform RPCs on the DS.
+supported by
+.Fx
+is the IP address that is used to perform RPCs on the DS.
It also indicates which version of NFS the DS supports, I/O size and other
layout specific information.
-In the DeviceInfo, there is a DeviceID which, for the FreeBSD server
+In the DeviceInfo, there is a DeviceID which, for the
+.Fx
+server
is unique to the DS configuration
and changes whenever the
.Xr nfsd
@@ -66,35 +70,51 @@
The second is the layout, which is per file and references the DeviceInfo
to use via the DeviceID.
It is for a byte range of a file and is either Read or Read/Write.
-For the FreeBSD server, a layout covers all bytes of a file.
+For the
+.Fx
+server, a layout covers all bytes of a file.
A layout may be recalled by the MDS using a LayoutRecall callback.
When a client returns a layout via the LayoutReturn operation it can
indicate that error(s) were encountered while doing I/O on the DS,
at least for certain layout types such as the Flexible File Layout.
.Pp
-The FreeBSD client and server supports two layout types.
+The
+.Fx
+client and server supports two layout types.
.Pp
The File Layout is described in RFC5661 and uses the NFSv4.1 or NFSv4.2 protocol
to perform I/O on the DS.
It does not support client aware DS mirroring and, as such,
-the FreeBSD server only provides File Layout support for non-mirrored
+the
+.Fx
+server only provides File Layout support for non-mirrored
configurations.
.Pp
The Flexible File Layout allows the use of the NFSv3, NFSv4.0, NFSv4.1 or
NFSv4.2 protocol to perform I/O on the DS and does support client aware
mirroring.
-As such, the FreeBSD server uses Flexible File Layout layouts for the
+As such, the
+.Fx
+server uses Flexible File Layout layouts for the
mirrored DS configurations.
-The FreeBSD server supports the
+The
+.Fx
+server supports the
.Dq tightly coupled
variant and all DSs allow use of the
NFSv4.2 or NFSv4.1 protocol for I/O operations.
Clients that support the Flexible File Layout will do writes and commits
to all DS mirrors in the mirror set.
.Pp
-A FreeBSD pNFS service consists of a single MDS server plus one or more
-DS servers, all of which are FreeBSD systems.
-For a non-mirrored configuration, the FreeBSD server will issue File Layout
+A
+.Fx
+pNFS service consists of a single MDS server plus one or more
+DS servers, all of which are
+.Fx
+systems.
+For a non-mirrored configuration, the
+.Fx
+server will issue File Layout
layouts by default.
However that default can be set to the Flexible File Layout by setting the
.Xr sysctl 1
@@ -105,7 +125,8 @@
.Tn pNFS
clients mount the MDS as they would a single NFS server.
.Pp
-A FreeBSD
+A
+.Fx
.Tn pNFS
client must be running the
.Xr nfscbd 8
@@ -165,7 +186,9 @@
.Pp
See
.Xr pnfsserver 4
-for information on how to set up a FreeBSD pNFS service.
+for information on how to set up a
+.Fx
+pNFS service.
.Sh SEE ALSO
.Xr nfsv4 4 ,
.Xr pnfsserver 4 ,
@@ -187,7 +210,9 @@
but it only supports the
.Dq loosely coupled
variant.
-To make it work correctly when mounting the FreeBSD server, you must
+To make it work correctly when mounting the
+.Fx
+server, you must
set the sysctl
.Dq vfs.nfsd.flexlinuxhack
to one so that it works around
diff --git a/usr.sbin/nfsd/pnfsserver.4 b/usr.sbin/nfsd/pnfsserver.4
--- a/usr.sbin/nfsd/pnfsserver.4
+++ b/usr.sbin/nfsd/pnfsserver.4
@@ -30,14 +30,22 @@
.Nm pNFSserver
.Nd NFS Version 4.1 and 4.2 Parallel NFS Protocol Server
.Sh DESCRIPTION
-A set of FreeBSD servers may be configured to provide a
+A set of
+.Fx
+servers may be configured to provide a
.Xr pnfs 4
service.
-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
+One
+.Fx
+system needs to be configured as a MetaData Server (MDS) and
+at least one additional
+.Fx
+system needs to be configured as one or
more Data Servers (DS)s.
.Pp
-These FreeBSD systems are configured to be NFSv4.1 and NFSv4.2
+These
+.Fx
+systems are configured to be NFSv4.1 and NFSv4.2
servers, see
.Xr nfsd 8
and
@@ -85,7 +93,9 @@
export option and this directory should be exported to them with the same
options as used by the MDS to export file system(s) to the clients.
.Pp
-It is possible to have multiple DSs on the same FreeBSD system, but each
+It is possible to have multiple DSs on the same
+.Fx
+system, but each
of these DSs must have a separate top level exported directory used for storage
of data files and each
of these DSs must be mountable via a separate IP address.
@@ -94,10 +104,15 @@
.Xr ifconfig 8
to create these different IP addresses.
Multiple DSs on the same server may be useful when data for different file systems
-on the MDS are being stored on different file system volumes on the FreeBSD
+on the MDS are being stored on different file system volumes on the
+.Fx
DS system.
.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
+.Fx
+system from the
+.Fx
+DS system(s) and
NFS clients.
It is configured as a NFSv4.1 and NFSv4.2 server with
file system(s) exported to clients.
@@ -189,7 +204,9 @@
This can be used by system administrators to control where data files are
stored and might be useful for control of storage use.
For this case, it may be convenient to co-locate more than one of the DSs
-on the same FreeBSD server, using separate file systems on the DS system
+on the same
+.Fx
+server, using separate file systems on the DS system
for storage of the respective DS's data files.
If mirroring is desired for this case, the
.Dq -m
@@ -211,7 +228,9 @@
set much larger, to avoid the number of entries in a subdirectory from
getting too large.
.Sh Client mounts
-Once operational, NFSv4.1 or NFSv4.2 FreeBSD client mounts
+Once operational, NFSv4.1 or NFSv4.2
+.Fx
+client mounts
done with the
.Dq pnfs
option should do I/O directly on the DSs.
@@ -421,5 +440,7 @@
as a non
.Tn pNFS
server is.
-For non-mirrored configurations, all FreeBSD systems used in the service
+For non-mirrored configurations, all
+.Fx
+systems used in the service
are single points of failure.

File Metadata

Mime Type
text/plain
Expires
Sat, Nov 9, 7:15 PM (20 h, 59 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
14564769
Default Alt Text
D31145.diff (6 KB)

Event Timeline