diff --git a/server/major/nfs-utils.xml b/server/major/nfs-utils.xml index e4db985125..e650e02b22 100644 --- a/server/major/nfs-utils.xml +++ b/server/major/nfs-utils.xml @@ -13,153 +13,177 @@ ]> - - $LastChangedBy$ - $Date$ - + - -NFS Utilities-&nfs-utils-version; + + $LastChangedBy$ + $Date$ + - - NFS Utilities - + NFS Utilities-&nfs-utils-version; - -Introduction to <application>NFS Utilities</application> + + NFS Utilities + -The NFS Utilities package contains the userspace -server and client tools necessary to use the kernel's nfs abilities. -NFS is a protocol that allows sharing file systems over the -network. + + Introduction to NFS Utilities -Package information - - Download (HTTP): - Download (FTP): - Download MD5 sum: &nfs-utils-md5sum; - Download size: &nfs-utils-size; - Estimated disk space required: &nfs-utils-buildsize; - Estimated build time: &nfs-utils-time; - + The NFS Utilities package contains the + userspace server and client tools necessary to use the kernel's nfs + abilities. NFS is a protocol that allows sharing file systems over the + network. -NFS Utilities Dependencies -Required + Package information + + + Download (HTTP): + + + Download (FTP): + + + Download MD5 sum: &nfs-utils-md5sum; + + + Download size: &nfs-utils-size; + + + Estimated disk space required: &nfs-utils-buildsize; + + + Estimated build time: &nfs-utils-time; + + - + NFS Utilities Dependencies -Optional -libevent -and libnsfidmap -for nfsv4 support, and or -for gss (RPC Security) support. - + Required + - + Optional + libevent + and libnsfidmap + for nfsv4 support, and or + for gss (RPC Security) support. - -Kernel Configuration + -Enable the following options in the kernel configuration -and recompile the kernel if neccessary: + + Kernel Configuration + + Enable the following options in the kernel configuration + and recompile the kernel if neccessary: File systems: Network File Systems: NFS File System Support: M or Y NFS Server Support: M or Y -Select the appropriate sub-options that appear when the above options -are selected. + Select the appropriate sub-options that appear when the above options + are selected. - - NFS Utilities - - + + NFS Utilities + - -Installation of NFS Utilities + -Before you compile the program, you need to be sure the nobody user and nogroup group are available. You can add these by -running the following commands as the root -user: + + Installation of NFS Utilities + + Before you compile the program, you need to be sure the + nobody user and + nogroup group are available. + You can add these by running the following commands as the + root user: groupadd -g 99 nogroup && useradd -c nobody -d /home -g nogroup -s /bin/bash -u 99 nobody -The classic uid and gid values are 65534 which is also -2 when -interpreted as a signed 16-bit number. These values impact other files on -some filesystems that do not have support for sparse files. The nobody and nogroup values have small impact. -The impact on a server is nil if the exports file is configured correctly. If it is misconfigured, -the impact is that a ls -l or ps listing -will show a uid or gid number of 65534 instead of a name. The client uses nobody only as the user running -rpc.statd. + + The classic uid and gid values are 65534 which is also -2 when + interpreted as a signed 16-bit number. These values impact other files on + some filesystems that do not have support for sparse files. The + nobody and nogroup values have small impact. + The impact on a server is nil if the exports file is configured correctly. + If it is misconfigured, the impact is that a ls -l or + ps listing will show a uid or gid number of 65534 + instead of a name. The client uses nobody only as the user running + rpc.statd. + -Install NFS Utilities by running the following commands: + Install NFS Utilities by running + the following commands: ./configure --prefix=/usr --sysconfdir=/etc \ --disable-nfsv4 --disable-gss && make -Now, as the root user: + Now, as the root user: make install -If your /usr directory is -NFS mounted, you should install the executables in -/sbin by passing -an additional parameter to the above -./configure command. + + If your /usr directory + is NFS mounted, you should install the executables in + /sbin by passing + an additional parameter to the + above ./configure command. + - + - -Command Explanations + + Command Explanations ---disable-nfsv4: Disables support -for NFS Version 4. + --disable-nfsv4: Disables support + for NFS Version 4. ---disable-gss: Disables support for -RPCSEC GSS (RPC Security). + --disable-gss: Disables support for + RPCSEC GSS (RPC Security). - + - -Configuring NFS Utilities + + Configuring NFS Utilities - -Server Configutation + + Server Configutation -/etc/exports contains the exported directories on -NFS servers. Refer to the exports manual page for -the syntax of this file. Also refer to the "NFS HowTo" available at on how to configure the servers -and clients in a secure manner. For example, for sharing the -/home directory over the local network, the following line -may be added: + /etc/exports contains the exported directories + on NFS servers. Refer to the exports manual page for the syntax of this + file. Also refer to the "NFS HowTo" available at on how to configure the + servers and clients in a secure manner. For example, for sharing the + /home directory over the local + network, the following line may be added: /home 192.168.0.0/255.255.255.0(rw,anonuid=99,anongid=99) - - /etc/exportfs - + + /etc/exportfs + -Install the /etc/rc.d/init.d/nfs-server init script -included in the package to start -the server at boot. + + Boot Script + + Install the /etc/rc.d/init.d/nfs-server + init script included in the package to start the server + at boot. make install-nfs-server - - nfs-server - - -Now create the /etc/sysconfig/nfs-server -configuration file: + + nfs-server + + + Now create the /etc/sysconfig/nfs-server + configuration file: cat > /etc/sysconfig/nfs-server << "EOF" PORT="2049" @@ -168,205 +192,216 @@ QUOTAS="no" KILLDELAY="10" EOF - - /etc/sysconfig/nfs-server - + + /etc/sysconfig/nfs-server + - + -Client Configutation + -/etc/fstab contains the -directories that are to be mounted on the client. Alternately the partitions -can be mounted by using the mount command with the proper -options. To mount the /home and -/usr -partitions, add the following to the /etc/fstab: + + Client Configutation + + /etc/fstab contains the directories that + are to be mounted on the client. Alternately the partitions can be + mounted by using the mount command with the proper + options. To mount the /home + and /usr partitions, add the + following to the /etc/fstab: <server-name>:/home /home nfs rw,_netdev,rsize=8192,wsize=8192 0 0 <server-name>:/usr /usr nfs ro,_netdev,rsize=8192 0 0 - - /etc/fstab - + + /etc/fstab + + + + Boot Script -Install the /etc/rc.d/init.d/nfs-client -init script included in the - package to -start the client services at boot. + Install the /etc/rc.d/init.d/nfs-client + init script included in the + package to + start the client services at boot. make install-nfs-client - - nfs-client - + + nfs-client + -To automatically mount nfs filesystems, -clients will also need to install the netfs bootscript as described in -. + To automatically mount nfs filesystems, clients will also + need to install the netfs bootscript as described + in . - - netfs - + + netfs + - + - + - -Contents - - Installed Programs - Installed Libraries - Installed Directories - - - exportfs, nfsstat, nhfsgraph, nhfsnums, nhfsrun, nhfsstone, - rpc.lockd, rpc.mountd, rpc.nfsd, rpc.rquotad, rpc.statd, and showmount - None - /var/lib/nfs - - + - - Short Descriptions - - + + Contents + + Installed Programs + Installed Libraries + Installed Directories - - exportfs - - maintains a list of NFS exported file systems. - - exportfs - - - + + exportfs, nfsstat, nhfsgraph, nhfsnums, nhfsrun, nhfsstone, + rpc.lockd, rpc.mountd, rpc.nfsd, rpc.rquotad, rpc.statd, + and showmount + None + /var/lib/nfs + + - - nfsstat - - prints NFS statistics. - - nfsstat - - - + + Short Descriptions + + - - nhfsgraph - - runs nhfsstone over multiple loads. - - nhfsgraph - - - + + exportfs + + maintains a list of NFS exported file systems. + + exportfs + + + - - nhfsnums - - converts raw numbers from nhfsstone output - into plot format. - - nhfsnums - - - + + nfsstat + + prints NFS statistics. + + nfsstat + + + - - nhfsrun - - executes nhfsstone with a range of different loads. - - nhfsrun - - - + + nhfsgraph + + runs nhfsstone over multiple loads. + + nhfsgraph + + + - - nhfsstone - - is used on a NFS client to generate an artificial load with a - particular mix of NFS operations. - - nhfsstone - - - + + nhfsnums + + converts raw numbers from nhfsstone + output into plot format. + + nhfsnums + + + - - rpc.lockd - - starts the NFS lock manager (NLM) - on kernels that don't start it automatically. However, since most kernels do start it - automatically it is usually not required. - - rpc.lockd - - - + + nhfsrun + + executes nhfsstone with a range of + different loads. + + nhfsrun + + + - - rpc.mountd - - implements the NFS mount protocol on an - NFS server. - - rpc.mountd - - - + + nhfsstone + + is used on a NFS client to generate an artificial load + with a particular mix of NFS operations. + + nhfsstone + + + - - rpc.nfsd - - implements the user level part of the NFS - service on the server. - - rpc.nfsd - - - + + rpc.lockd + + starts the NFS lock manager (NLM) on kernels that don't + start it automatically. However, since most kernels do start it + automatically it is usually not required. + + rpc.lockd + + + - - rpc.rquotad - - is an rpc server which returns quotas for a user of a local file - system which is mounted by a remote machine over the NFS. - - rpc.rquotad - - - + + rpc.mountd + + implements the NFS mount protocol on an NFS server. + + rpc.mountd + + + - - rpc.statd - - is used by the NFS file locking service, - rpc.lockd, to implement lock recovery when the - NFS server machine crashes and reboots. Runs - on the NFS server only. - - rpc.statd - - - + + rpc.nfsd + + implements the user level part of the NFS + service on the server. + + rpc.nfsd + + + - - showmount - - displays mount information for an NFS server. - - showmount - - - + + rpc.rquotad + + is an rpc server which returns quotas for a user of a + local file system which is mounted by a remote machine over + the NFS. + + rpc.rquotad + + + + + rpc.statd + + is used by the NFS file locking service, + rpc.lockd, to implement lock recovery when + the NFS server machine crashes and reboots. Runs on the NFS + server only. + + rpc.statd + + + - + + showmount + + displays mount information for an NFS server. + + showmount + + + + + + + - -